接口协议使用HTTP协议,发起方使用HTTP POST方法发送请求报文并得到应答报文。字符编码统一采用UTF-8。
接口命名统一采用英文,命名一般约定为动词加名词形式。注:单词首字母大写,单词间不采用分割符号。
本接口中使用的报文包括请求报文和应答报文,均通过JSON格式描述。
所有接口都需要传输公共参数,用于获取客户信息以及签名验证。
序号 | 名称 | 类型 | 是否必须 | 示例 | 更多限制 | 描述 |
---|---|---|---|---|---|---|
1 | interfacename | String | 必须 | searchOrder | 消息头 | 接口名称 |
2 | parenter | String | 必须 | 129 | 消息头 | 合作者id(由唯妮供应链平台分配) |
3 | token | String | 必须 | 9CE2D07B944D4F27218FDB72D97E58CD | 消息头 |
token=md5(key+date+interfacename+content) date: 当前日期(格式为yyyy-MM-dd) key:由唯妮供应链平台分配的密钥 content:消息体 |
4 | content | String | 必须 | {xxxxx} | 消息体 | 要发送的json内容即各接口的请求数据 |
测试环境:121.41.84.251:9190
生产环境:http://vip.nysochina.com