编程语言 :JAVA
接口传输协议:HTTP
接口请求方式:POST
数据编码方式:UTF-8
数据传输格式:JSON
签名方式:使用data+appSecret+timestamp签名
时间约定:时间格式统一使用yyyy-mm-dd HH:mm:ss 的格式,精确到秒
请求消息头设置Content-Type : application/json;charset=utf-8
请求报文分报文头(head)和报文体(body)信息。head用于签名校验,不可为空;body为业务处理数据内容,也不可为空。在数据传输过程中,为避免数据被篡改,需要对数据进行加密码,如下图所示:
说明:
appId由晶链通提供,在实际集成过程中根据对接环境生成提供;
appSecret为晶链通平台给appId分配的密钥串,在实际集成过程中根据对接环境生成提供;
timestamp为13位Unix时间戳;
状态码 | 信息描述 | 说明 |
0 | 成功 | |
1 | 未知异常 | 1-99:系统异常 |
2 | 服务暂不可用 | |
... | ... | |
100 | 请求参数无效 | 100-999:请求参数校验、用户校验等异常 |
101 | app id不存在 | |
102 | 摘要验证失败 | |
103 | timestamp参数无效 | |
104 | 参数转换失败 | |
105 | 参数校验失败 | |
106 | 接口调用失败 | |
... | ... | |
1000 | 失败(业务处理失败),异常信息在message里描述 | 1000+:业务处理异常 |
1)测试地址:详见每个接口说明
2)生产地址:上线前提供
备注:请与晶链通接口对接人员联系,获取该地址。