1 Star 5 Fork 2

金乌/shopkeeper-opendoc

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
金乌 优化 ec9802c 10个月前
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

shopkeeper-opendoc

介绍

聚合呗开放平台接口相关文档

快速开始

图片.png
  1. 注册聚合呗开放平台账号。请用微信扫描上面的企微二维码联系开放平台小助手,向平台小助手交相关信息后,相关凭据信息appidappsecret会以短信的形式下发到注册手机上(48小时内会有人工审核并下发);

  2. 阅读接口调用协议约定,熟悉签名规则,在http header准备好相关通用参数,也可以参考签名样例:JAVA PHP

  3. 完成上面的步骤后,就可以按需对接其它接口了;

PS: 对JSON不熟悉的同学,建议先使用Postman, fiddler之类的http请求工具先调通,帮助理清传参规则


接口调用协议约定

  1. 协议:https;

  2. 所有请求方法都用 POST;

  3. 请求与响应内容都是json;

  4. 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在这里}
  1. 响应标准结构,包括平台响应外部请求与开发者应用对平台异步通知打印结果的响应
  {
    "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}"
}

空文件

简介

聚合呗开放平台接口文档 展开 收起
取消

发行版

暂无发行版

贡献者

全部

近期动态

不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/jinwu/juhebei-opendoc.git
git@gitee.com:jinwu/juhebei-opendoc.git
jinwu
juhebei-opendoc
shopkeeper-opendoc
master

搜索帮助