概述

此文档为HTTP 接口通讯标准，为web客户端与认证授权系统对接而定义。

1参数、安全及数据完整性
1.1系统参数
参数名称用途
content 消息内容。
token Sessionkey。授权session ，由COE提供
sign 消息签名。
format 接收数据库格式，支持json，
version 默认1.0
method 请求方法，例如coe.order.create

1.2安全及数据完整性说明
消息接收方式只支持HTTP POST；所有JSON格式的字符串，以HTTP POST方式发送，请求方法的编码格式：“application/x-www-form-urlencoded; charset=UTF-8”；
1、在POST时用“content”字段表示要发送的JSON内容；
2、method：是所对接的应用。如：coe.order.create应用
3、token：是授权的字符串，需要找对接人获取，调用时需要传回。
4、sign：字段的签名。签名使用MD5方式，对content的内容进行签名。原理为：通知内容（json）+tokenKey，然后进行MD5后的32位大写字符串。详细解释如下：
假设json内容为： {“userId”:“userId”}， token为：123，tokenkey为：123456
那么要签名的内容为{“userId”:“userId”}123456（默认utf8编码），经过md5后的内容就为FF962D3DE03A9CECB744F045BB6BAAE1
最终要发送的数据为
content={“userId”:“userId”}&token=123&method=coe.order.create& sign=FF962D3DE03A9CECB744F045BB6BAAE1

注意：token和tokenkey都是需要找对接人获取的，相当于调用时的用户名和密码
5、报文中节点名称 (第一个单词小写，以后每个单词首字母大写；只有一个单词就全部小写。按Java标准)
1.3接口系统接收消息的URL：
1.3.1使用本文档定义的接口，请将消息发送至如下地址(约定使用UTF-8编码集)
测试地址：
http://
正式地址：
http://
1.4报文响应例如：
业务场景：报文标准响应
节点节点数业务字段节点名必须数据类型长度备注
报文头(head) 1 messageId messageId Y uuid
messageTime messageTime Y
messageWay messageWay Y request/response
sender sender Y 报文发送者
version version Y 对接版本
serviceName serviceName Y 接口服务名称
报文体(body) 1 success success Y true/false
errorCode errorCode N 20 错误代码，当success=false时必填
errorMessage errorMessage N 256 错误描述，当success=false时必填
data data N 追踪单号
JSON报文示例：
{
"head": {
"messageid": "uuid",
"messageTime": "2018-01-12 10:17:00",
"messageWay": "response",
"sender": "zto",
"version": "1.6",
"seviceName": "coe.order.create"
},
"body": {
"success": "true",
"errorCode": "",
"errorMessage": "",
"data": ""
}
}

2错误码
2.1系统错误码
标识说明
S01 非法的JSON
S02 非法的数字签名
S03 网络超时，请重试
S04 系统异常，请重试
S05 HTTP状态异常（非200）
S06 通讯用户验证失败

2.2业务错误码
标识说明
B00 业务错误
B01 关键字段缺失
B02 关键数据格式不正确
B03 业务用户验证失败
B04 其他错误

接口文档