api对接
  1. 向敢探号提单
api对接
  • 鉴权参数获取
  • 订单状态码
  • 地址-省
  • 地址-市
  • 地址-区
  • 商品上架下架回调通知
  • 向敢探号提单
    • 敢探号提单V2
    • 提单验签
    • 敢探号回调
    • 回调验签
    • 上传照片秘钥
    • 上传照片
    • 修改敢探号订单信息
    • 操作上游订单修改/重提
  • 敢探号对接第三方
    • 《敢探号通用提单》生产订单推送(产品需配置自动生产)
    • 《敢探号通用提单》结果回传
    • 《敢探号通用选号》
  • 物流公司
    GET
  1. 向敢探号提单

敢探号提单V2

[TOC]
版本说明#
更新内容更新时间
身份信息调整aes加密2023年9月1号
签名算法
share_id、sku、source_id 3个字段,根据字段名key=val 格式进行&连接,追加api_token之后, md5加密(加密结果32位小写) 。注意:三个字段的顺序不能变。
原串例:  share_id=123&sku=321&source_id=123321jW5DoNjzP7NXb1nvf4ZKGb4bH0fWbbiwokzoyo8QX7cmSuy4l6
请求URL#
https://notify.91haoka.cn/api/plan-market/order/purchase/v2
请求方式#
POST 数据可采用JSON格式或form-data格式,传图则必须使用form-data上传file
参数#
参数名必选类型说明
sku1string商品名称(敢探号系统产品销售中心模块商品的名字)
source_sku1string商品编码(敢探号系统产品销售中心模块商品的编码,编码和名称选一个传即可)
source_id1string来源id(唯一)自己定义,确保唯一,后续可依据这个id查询订单
share_id1int发展人id
id_name0string身份证姓名 aes加密 (文档末)
id_num0string身份证号 aes加密
mobile1string收货手机号 aes加密
name1string收货人姓名 aes加密
province_code0int收货地址-省编码(建议上传)
province1string收货地址-省
city_code0int收货地址-市编码 (建议上传)
city1string收货地址-市
district_code0int收货地址-区/县编码 (建议上传)
district1string收货地址-区/县
town0string收货地址-街道
address1string详细地址 aes加密
pretty_number0string购买号码
pic[face]0file身份证人像面
pic[back]0file身份证国徽面
pic[hand]0file身份证本人照
face_url0string身份证人相面url地址(文件,url地址二选一)
back_url0string身份证背面url地址
hand_url0string人像面url地址
sign1string签名(详见签名算法)
传图则
image.png
返回示例#
 {
    "msg": {
        "code": 0,
        "info": ""
    },
    "data": {
        "source_id": "1122qwe23422",
        "share_id": "50481",
        "product_sku": "随便2",
        "status": "120",
        "created_at": "2022-04-22 10:16:52",
        "id": 6935731,
        "str_rand": "ziiEyU63c6E6meZW"
    }
}
返回参数说明#
|参数名|说明|
|:----- |:-----|----- |
|source_id |下游订单号 |
|share_id |订单发展人id |
|product_sku |sku |
|status |订单状态 120 成功接收订单 |
|id |敢探号订单id |
|created_at |订单创建时间 |
|str_rand |照片秘钥 (上传订单传照片,可以用这个值作为id补传照片 ) |
常见错误码#
|错误码|说明|解决方案|
|:---- |:---|
|50405 |提交方式错误 |post方式提交 |
|50422 |必传参数未传 |检查必传参数 |
|50401 |签名错误 |签名错误,检查签名 |
|50304 |该商品不存在或已下架 |找运营确定商品在敢探号一系统上架 |
|52000 |数据异常 |核对外部订单号 |
aes加密说明#
加密算法、模式 : aes-256-ecb
加密示例
aes_key = '121';
base64_encode(openssl_encrypt('身份证姓名', 'aes-256-ecb', aes_key, OPENSSL_RAW_DATA))
更多返回错误代码请看首页的错误代码描述
上一页
商品上架下架回调通知
下一页
提单验签
Built with