调用流程

申请加入

机构需要提前发起申请，开放平台审核通过后，会给开发者分配唯一标识(appId）和授权秘钥(signKey)。

有些接口是需要扣费的，请机构妥善使用。建议先在开发环境下完成业务联调测试，再部署到正式环境。

注:参数签名，需要在学校系统服务器上进行，防止秘钥泄露。

调用方在集成通用API时，请遵循以下规则。

部分接口协议有特殊要求。如无特别说明，遵循这里的统一规则

API接口需要签名验证，接口传递除定义的业务参数外，还需要统一增加签名验证参数：

签名过程是将业务参数以 参数名称=参数值 的形式按照 参数名称 的字⺟表升序排序，并⽤ & 拼接，然后⽤ HMAC-sha1 签名并以 Hex 格式输出 signature 值，再把 signature 和 API 的其他上传参数一起提交到开放平台。

js示例代码：

java示例代码：

接口返回结果的格式（JSON 格式体，utf8 编码格式），具体说明如下:

返回示例

{
    "code": 0,
    "message": "",
    "obj": {}
}