代码拉取完成,页面将自动刷新
聚合呗开放平台接口相关文档
注册聚合呗开放平台账号。请用微信扫描上面的企微二维码联系开放平台小助手,向平台小助手交相关信息后,相关凭据信息appid
与appsecret
会以短信的形式下发到注册手机上(48小时内会有人工审核并下发);
完成上面的步骤后,就可以按需对接其它接口了;
PS: 对JSON不熟悉的同学,建议先使用Postman, fiddler之类的http请求工具先调通,帮助理清传参规则
协议:https
;
所有请求方法都用 POST
;
请求与响应内容都是json;
Http header通用固定传参:
Http Header参数 | 类型 | 备注 |
---|---|---|
Content-Type | string | 固定为 application/json;charset=UTF-8 |
appid | string | 应用ID |
uid | string | 请求唯一ID,只能用来请求一次,不可以重复(例如: Java可以使用UUID,其它没有UUID实现的语言,可以采用时间戳+随机串的方式生成,保证不重复即可) |
stime | long | timestamp,请求时间戳,精确秒(UTC+8) |
sign | string | 签名 md5(uid+appid+stime+appsecrect+请求Json内容) |
示例:
POST https://printer.juhesaas.com/openapi/addPrinter
Content-Type: application/json
uid: {uid}
appid: {appid}
stime: 1617332013 # timestamp(秒)
sign: {sign} # 签名算法 md5(uid+appid+stime+appsecrect+请求Json内容)
{你的http请求json body在这里}
{
"code": 0, # 响应码,成功时响应 0;异常时,API将返回相应错误码
"message":"ok", # 响应消息,成功时响应 "ok";异常时返回错误消息
"data": # 可选,对于列表返回空[],对于空对象不返回属性
}
注意:收到回调后,只有在按响应标准json结构数据 {"message":"ok","code":0}
code为0时才会认为回调成功,否则平台判断下推失败,会进行三次重试,第一次2秒,第二次4秒,第三次10秒,三次没有接收到正确响应平台停止推送
业务类型 | 备注 |
---|---|
0 | 回调地址合法性校验事件,收到之后,按标准结构响应:{"code":0,"message":"ok"} |
4 | 配送单状态变更事件 |
5 | 打票请求状态变化消息 |
响应示例:
{
"type": 4, // 见附录回调业务类型
"rtime": 1662459209, // 回调时间
"data": "{\"shopId\":6308559984,\"salesOrderNo\":\"A00062\",\"status\":60,\"deliverymanName\":\"甜甜田超辉\",\"deliverymanMobile\":\"18521736087\",\"distance\":1,\"deliveryAmount\":100,\"couponAmount\":0,\"tipsAmount\":300,\"insuranceAmount\":0,\"payAmount\":100,\"deductAmount\":0,\"timestamp\":1637720013}"
}
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。