接口协议
级联接口应按 RESTful API 标准对外提供服务,通讯过程中请求和响应的数据采用标准json格式来封装。对于开放的接口函数,需发布相应的文档,用于描述JSON的接口信息。
接口数据应采用本级平台统一下发软证书方式进行通信数据加密。
接口格式定义
接口格式定义包括接口URL、请求方式、接口描述、参数列表及接口返回信息。参数与返回值的具体JSON格式由接口提供者根据具体业务的实际情况制定,应层次简单、结构清晰。
级联认证接口
包括级联注册和级联注销。级联注册通过具体业务或资产数据接口完成第三方平台至本级平台的注册功能,保证上第三方平台之间通信的安全性。
由上级平台进行上第三方平台间级联的注销,本级平台上注销后,停止与第三方平台的通讯,含注册节点IP、端口等。第三方平台注销后可根据新的注册信息重新注册。
请求地址:对应的请求地址
接口类型:HTTP
请求方式:POST
请求参数:
| 序号 | 字段名称 | 中文名称 | 字段说明 | 字段长度 | 必填/可选 | 说明 |
|---|---|---|---|---|---|---|
| 1 | user | 第三方系统用户名 | 文本 | 10 | 必填 | |
| 2 | timestamp | 请求发起时间戳 | 整数 | 64 | 必填 | |
| 3 | sign | md5(timestamp+user+token) | 字符 | 32 | 必填 | |
| 4 | dataValues | 对象数组 | 对象 | 必填 |
返回参数:
| 序号 | 字段名称 | 中文名称 | 字段说明 | 说明 |
|---|---|---|---|---|
| 1 | errorCode | 接口状态码 | 字符 | |
| 2 | errorMessage | 接口消息 | 字符 | |
| 3 | data | 接口数据 | 对象 | |
| 4 | success | 是否成功 | 布尔 | true:成功,false:错误 |
返回示例:
{errorCode:null , //正常成功返回值errorMessage:null,// 正常成功返回值data:null,//如果没有返回值则为null,有的话,json返回success:true}
