淘宝开放平台 - 文档中心

请求地址：

环境	HTTPS请求地址
正式环境	https://openapi.alipay.com/gateway.do

公共请求参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	是	128	接口名称	alipay.eco.edu.kt.student.modify
format	String	否	40	仅支持JSON	JSON
charset	String	是	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	String	是	10	商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2	RSA2
sign	String	是	256	商户请求参数的签名串，详见签名	详见示例
timestamp	String	是	19	发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"	2014-07-24 03:07:50
version	String	是	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	String	否	40	详见应用授权概述
biz_content	String	是	-	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

参数	类型	是否必填	最大长度	描述	示例值
isv_pid	String	必须	64	已经签约教育缴费的isv的支付宝PID	2088121212121212
school_pid	String	必须	64	学校用来签约支付宝教育缴费的支付宝PID	2088101117955611
school_no	String	必须	64	学校编号，调用alipay.eco.edu.kt.schoolinfo.modify接口录入学校信息时，接口返回的编号	11010100000001
student_no	String	必须	64	支付宝-中小学-教育缴费生成的学生唯一编号	57de63cb1ef157595c005467
child_name	String	特殊可选	16	修改后的学生姓名本接口调用时，child_name、student_code、student_identify、users这几个参数至少需要填写其中一个，不能同时为空	张三
student_code	String	特殊可选	32	修改后的学号本接口调用时，child_name、student_code、student_identify、users这几个参数至少需要填写其中一个，不能同时为空	6589154
student_identify	String	特殊可选	32	修改后的身份证号码本接口调用时，child_name、student_code、student_identify、users这几个参数至少需要填写其中一个，不能同时为空	610824197812044680
users	UserDetails []	特殊可选	-	孩子的家长信息，最多一次输入20个家长。如果输入的家长信息不存在，则该改学生增加家长信息本接口调用时，child_name、student_code、student_identify、users这几个参数至少需要填写其中一个，不能同时为空
└ user_mobile String 可选 20 孩子家长的手机号 18291992024 └ user_name String 可选 16 张三家长姓名 └ user_relation String 可选 16 孩子与家长的关系： 1、爸爸 2、妈妈 3、爷爷 4、奶奶 5、外公 6、外婆 7、家长 1 └ user_change_mobile String 可选 16 用户变更手机号，替换旧的手机号 1300000000
status	String	可选	10	区分ISV操作，“D”表示删除，“U”表示更新，区分大小写。如果为U，则学生名字，学号，身份证至少填写一项	U

参数	类型	是否必填	最大长度	描述	示例值
code	String	是	-	网关返回码,详见文档	40004
msg	String	是	-	网关返回码描述,详见文档	Business Failed
sub_code	String	否	-	业务返回码,详见文档	ACQ.TRADE_HAS_SUCCESS
sub_msg	String	否	-	业务返回码描述,详见文档	交易已被支付
sign	String	是	-	签名,详见文档	DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

参数	类型	是否必填	最大长度	描述	示例值
status	String	必填	16	Y：代表成功；N：代表失败	Y

JAVA
.NET
PHP
HTTP请求源码

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayEcoEduKtStudentModifyRequest request = new AlipayEcoEduKtStudentModifyRequest();
request.setBizContent("{" +
"\"isv_pid\":\"2088121212121212\"," +
"\"school_pid\":\"2088101117955611\"," +
"\"school_no\":\"11010100000001\"," +
"\"student_no\":\"57de63cb1ef157595c005467\"," +
"\"child_name\":\"张三\"," +
"\"student_code\":\"6589154\"," +
"\"student_identify\":\"610824197812044680\"," +
"      \"users\":[{" +
"        \"user_mobile\":\"18291992024\"," +
"\"user_name\":\"家长姓名\"," +
"\"user_relation\":\"1\"," +
"\"user_change_mobile\":\"1300000000\"" +
"        }]," +
"\"status\":\"U\"" +
"  }");
AlipayEcoEduKtStudentModifyResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

IAopClient client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "app_id", "merchant_private_key", "json", "1.0", "RSA2", "alipay_public_key", "GBK", false);
AlipayEcoEduKtStudentModifyRequest  request= new AlipayEcoEduKtStudentModifyRequest() ;
request.BizContent="{" +
"\"isv_pid\":\"2088121212121212\"," +
"\"school_pid\":\"2088101117955611\"," +
"\"school_no\":\"11010100000001\"," +
"\"student_no\":\"57de63cb1ef157595c005467\"," +
"\"child_name\":\"张三\"," +
"\"student_code\":\"6589154\"," +
"\"student_identify\":\"610824197812044680\"," +
"      \"users\":[{" +
"        \"user_mobile\":\"18291992024\"," +
"\"user_name\":\"家长姓名\"," +
"\"user_relation\":\"1\"," +
"\"user_change_mobile\":\"1300000000\"" +
"        }]," +
"\"status\":\"U\"" +
"  }";
AlipayEcoEduKtStudentModifyResponse response=client.Execute(request);
Console.WriteLine(response.Body);

$aop = new AopClient ();
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->appId = 'your app_id';
$aop->rsaPrivateKey = '请填写开发者私钥去头去尾去回车，一行字符串';
$aop->alipayrsaPublicKey='请填写支付宝公钥，一行字符串';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='GBK';
$aop->format='json';
$request = new AlipayEcoEduKtStudentModifyRequest ();
$request->setBizContent("{" .
"\"isv_pid\":\"2088121212121212\"," .
"\"school_pid\":\"2088101117955611\"," .
"\"school_no\":\"11010100000001\"," .
"\"student_no\":\"57de63cb1ef157595c005467\"," .
"\"child_name\":\"张三\"," .
"\"student_code\":\"6589154\"," .
"\"student_identify\":\"610824197812044680\"," .
"      \"users\":[{" .
"        \"user_mobile\":\"18291992024\"," .
"\"user_name\":\"家长姓名\"," .
"\"user_relation\":\"1\"," .
"\"user_change_mobile\":\"1300000000\"" .
"        }]," .
"\"status\":\"U\"" .
"  }");
$result = $aop->execute ( $request); 

$responseNode = str_replace(".", "_", $request->getApiMethodName()) . "_response";
$resultCode = $result->$responseNode->code;
if(!empty($resultCode)&&$resultCode == 10000){
echo "成功";
} else {
echo "失败";
}

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.eco.edu.kt.student.modify&app_id=4304&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
"isv_pid":"2088121212121212",
"school_pid":"2088101117955611",
"school_no":"11010100000001",
"student_no":"57de63cb1ef157595c005467",
"child_name":"张三",
"student_code":"6589154",
"student_identify":"610824197812044680",
      "users":[{
        "user_mobile":"18291992024",
"user_name":"家长姓名",
"user_relation":"1",
"user_change_mobile":"1300000000"
        }],
"status":"U"
  }

//为确保安全通信，需自行验证响应示例中的sign值是否为蚂蚁金服所提供。

JSON示例

{
	"alipay_eco_edu_kt_student_modify_response":{
		"msg":"Success",
		"code":"10000",
		"status":"Y"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

JSON示例

{
	"alipay_eco_edu_kt_student_modify_response":{
		"msg":"Service Currently Unavailable",
		"code":"20000",
		"sub_msg":"系统繁忙",
		"sub_code":"isp.unknow-error"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

错误码	错误描述	解决方案
SYSTEM_ERROR	系统繁忙	请重试
INVALID_PARAMETER	参数有误参数有误，找不到对应的ISV，请输入正确的ISV_PID	输入正确的ISV_PID
INVALID_PARAMETER	参数有误参数有误，学校PID错误	输入正确的学校PID
INVALID_PARAMETER	参数有误参数有误，学校编号错误	输入正确的学校编号
INVALID_PARAMETER	参数有误参数有误，CHILD_NAME参数不合法	输入正确的学生姓名
INVALID_PARAMETER	参数有误参数有误，STUDENT_CODE参数不合法	输入正确的学号
INVALID_PARAMETER	参数有误参数有误，STUDENT_IDENTIFY参数不合法	输入正确的身份证号
INVALID_PARAMETER	参数有误参数有误，ISV_PID不存在	输入正确的ISV_PID信息
INVALID_PARAMETER	参数有误参数有误，请检查ISV_PID、SCHOOL_PID	传入正确的ISV_PID和学校PID
INVALID_PARAMETER	参数有误参数有误，请检查SCHOOL_PID 、SCHOOL_NO	输入正确的SCHOOL_PID 和SCHOO_NO
INVALID_PARAMETER	参数有误参数有误，请检查修改SCHOOL_NO、STUDENT_NO	输入正确的学校和学号信息

公共错误码

开放平台

教育服务API

alipay.eco.edu.kt.student.modify (学生信息更新)

公共参数

请求参数

公共响应参数

响应参数

请求示例

响应示例

异常示例

业务错误码

公共错误码