开放平台
开放平台/采销

系统对接规范说明

接口技术说明

编程语言 :JAVA

接口传输协议:HTTP

接口请求方式:POST

数据编码方式:UTF-8

数据传输格式:JSON

签名方式:使用data+appSecret+timestamp签名

时间约定:时间格式统一使用yyyy-mm-dd HH:mm:ss 的格式,精确到秒

请求消息头设置Content-Type : application/json;charset=utf-8

请求接口报文格式说明(客户-->JLT)

请求报文分报文头(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)生产地址:上线前提供

备注:请与晶链通接口对接人员联系,获取该地址。