1.数据开放对接接入说明

接口交互格式定义

数据编码采用UTF-8格式

采用HTTP或HTTPS传输协议，POST方法

请求和响应的数据都为JSON格式。注：请设置Header的Content-Type为application/json

所有接口中响应码code为0是处理成功,其他错误码视情况判断

所有上行请求接口全部包含appId、version、timestamp、sign字段

字段释疑

名称	类型	说明	备注
appId	string	应用编号	食亨提供
appSecret	string	应用秘钥	食亨提供
timestamp	Integer	秒级时间戳	服务器时差5分钟,拒绝请求
version	string	版本号	1.0.0
sign	string	签名	参见下文方式
URL	string	请求路径	参见接口请求URL
{SERVER_HOST}	string	请求地址	测试：https://saas-test.sh-internal.com/openapi 生产：https://saas.shihengtech.com/openapi

请求及响应状态说明

请求接口访问及签名方式

访问地址：{SERVER_HOST }{接口定义中的URL}

签名生成方式如下：

将POST发送的数据内容(属性值为null不输出)进行JSON序列化成按key字符升序的JSON字符串,

将JSON字符串拼上{appSecret}

对上步得到的字符串去空格用MD5加密生成32大写的签名串

对象Json串：{"appId":"abc1235","paramContent":{"shopIdList":["h12351556670"]},"timestamp":1698220762,"version":"1.0.0"}

秘钥：e2134d2a3e7f1f8b52393b7fa546a04ceea74f02

签名串：{"appId":"abc1235","paramContent":{"shopIdList":["h12351556670"]},"timestamp":1698220762,"version":"1.0.0"}e2134d2a3e7f1f8b52393b7fa546a04ceea74f02

签名值：41E508BF27B22E4BF834A7F239396532

#接口返回

返回码列表

(待完善)

返回码	描述
0	处理成功
D1100	参数校验失败
D1101	appId编号不存在
D1106	appId编号已禁用
D1107	appId编号已过期
D1108	请求内容不能为空
D1102	门店未授权
D1103	验签失败
D1104	时间戳校验失败
D1205	查询数据失败
D1403	请求过于频繁
D1402	系统异常,稍后查询

错误示例:

{"code":"D1101","msg":"APP_ID编号不存在","traceId":"9371a719b9d247f4a36dbbaf16e5a82f","result":null}

开放平台调用说明

1.数据开放对接接入说明#

接口交互格式定义#

字段释疑#

请求及响应状态说明#

请求接口访问及签名方式#

返回码列表#