首页 > API文档 > 隐私快递API
隐私快递API
申请API
隐私快递是一种利用隐私通讯技术实现在隐藏收/发件人信息的同?#20445;?#24555;递员通过扫描二维码或者拨打安全号码与收/发件人直接通话的方法,可以杜绝物流运输过程中,对收/发件人隐私的获取和泄露,为收/发件人提供能保护隐私信息的服务
应用场景
(1)电商买家在提交订单?#20445;?#21246;选隐私快递选项
(2)打单工具在商户打单时选择隐私快递模式
(3)ERP集成隐私电子面单打单功能,供商户使用
(4)APP、公众号、网站等下单模块,集成隐私快递功能
功能说明
使用流程
API?#38382;?/td>
一、接口描述/说明
安全号码
(1)接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息。
如:EMS物流单号应选择快递公司编码(EMS)查看快递公司编码
(2)返回的物流跟踪信息按照发生的时间升序排列。
(3)接口指令3001。
(4)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"
(5)接口地址: API测试地址:http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址:http://api.kdniao.com/api/apiservice
请求系统级?#38382;?#35828;明:
?#38382;?#21517;称类型说明必须要求
RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。R
EBusinessIDString商户ID,请在我的服务页面查看。R
RequestTypeString请求指令类型:3001R
DataSignString数据内容签名:把(请求内容(未编码)+AppKey)进行MD5?#29992;埽?#28982;后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。R
DataTypeString请求、返回数据类型:2-json;O
备注:R-必填(Required),O-可选(Optional),C-报文中该?#38382;?#22312;一定条件下可选(Conditional)
隐私电子面单
(1)电子面单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口。
(2)为客户解决在线发货需求,商户通过网络选择快递公司发送请求通知快递公司有快递要发货。
(3) 客户把数据通过?#31169;?#21475;转发到快递鸟,由快递鸟为您安排快递员上门取件的服务。
(4)订单编号(OrderCode)不可重复提交,重复提交系统会返回具体错误代码。
(5)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"
(6)接口地址: API测试地址:http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址:http://api.kdniao.com/api/EOrderService
请求系统级?#38382;?#35828;明:
?#38382;?#21517;称类型说明必须要求
RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。R
EBusinessIDString商户ID,请在我的服务页面查看。R
RequestTypeString请求指令类型:1007R
DataSignString数据内容签名:把(请求内容(未编码)+AppKey)进行MD5?#29992;埽?#28982;后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。R
DataTypeString请求、返回数据类型:只支持JSON格式O
备注:R-必填(Required),O-可选(Optional),C-报文中该?#38382;?#22312;一定条件下可选(Conditional)
二、接口?#38382;?/div>
三、示例
安全号码
请求示例 JSON
{
        "OrderCode": "012657700387",
        "ShipperCode": "SF",
        "LogisticCode": "612018489480",
        "Receiver": 
        {
            "Company": "LV",
            "Name": "张勇",
            "Mobile": "15223830813",
            "ProvinceName": "重庆市",
            "CityName": "重庆市",
            "ExpAreaName": "九龙坡",
            "Address": "九龙35号"
        },
        "Sender": 
        {
            "Company": "GCCUI",
            "Name": "张勇",
            "Mobile": "15223830813",
            "ProvinceName": "?#26412;?,
            "CityName": "?#26412;?,
            "ExpAreaName": "朝阳区",
            "Address": "三里屯?#20540;?#38597;秀大厦"
        },
        "HideType": "3"
      }'
返回示例 JSON
{
  "EBusinessID": "1261600",
  "OrderCode": "012657700387",
  "ShipperCode": "SF",
  "Success": true,
  "Reason": "",
  "ResultCode": "100",
  "LogisticCode": "612018489480",
  "ReceiverSafePhone": "4000988856 转 167306",
  "ReceiverPhone": "15223830813",
  "SenderSafePhone": "4000988856 转 940007",
  "SenderPhone": "15223830813",
  "DialPage": "http://192.168.1.109:8083//KDN170103211401580104"
}
隐私电子面单
请求示例 JSON
{
    "OrderCode": "012657700387",
    "ShipperCode": "HTKY",
    "PayType": 1,
    "ExpType": 1,
    "Cost": 1.0,
    "OtherCost": 1.0,
    "Sender": {
      "Company": "LV",
      "Name": "Taylor",
      "Mobile": "15018442396",
      "ProvinceName": "上海",
      "CityName": "上海",
      "ExpAreaName": "青?#26234;?,
      "Address": "明珠路73号"
    },
    "Receiver": {
      "Company": "GCCUI",
      "Name": "Yann",
      "Mobile": "15018442396",
      "ProvinceName": "?#26412;?,
      "CityName": "?#26412;?,
      "ExpAreaName": "朝阳区",
      "Address": "三里屯?#20540;?#38597;秀大厦"
    },
    "Commodity": [
      {
        "GoodsName": "鞋子",
        "Goodsquantity": 1,
        "GoodsWeight": 1.0
      }
    ],
    "AddService": [
      {
        "Name": "SafeMail",
        "Value": "3"
      }
    ],
    "Weight": 1.0,
    "Quantity": 1,
    "Volume": 0.0,
    "Remark": "小心轻放",
    "IsReturnPrintTemplate":1
    }
返回示例 JSON
失败:
  {
      "EBusinessID": "1237100",
      "ResultCode": "105",
      "Reason": "订单号已存在,请勿重复操作",
      "UniquerRequestNumber":"5e66486b-8fbc-4131-b875-9b13d2ad1354"
  }
  成功:
  {
    "EBusinessID": "1237100",
    "Order": {
      "OrderCode": "012657700387",
      "ShipperCode": "HTKY",
      "LogisticCode": "50002498503427",
      "MarkDestination": "京-朝阳(京-1)",
      "OriginCode": "200000",
      "OriginName": "上海分拨中心",
      "PackageCode": "?#26412;?
    },
    "PrintTemplate":"此处省略打印模板HTML内容",
    "EstimatedDeliveryTime":"2016-03-06",
    "Callback":"调用时传入的Callback",
    "Success": true,
    "ResultCode": "100",
    "Reason": "成功"
  }
接入流程
demo下载

相关文档与更多帮助?

  • 帮助与文档
    立即获得接入帮助与技术文档
  • ?#35797;?#19979;载
    获得DEMO与插件下载
  • API文档
    API接口接入?#38382;?#35828;明
30万+
数十万客户的选择
5.8亿次+
?#31449;?#22788;理物流数据?#38382;?/dd>
1450万+
?#31449;?#21315;万订单数据处理
418家+
支持全国418家物流商
在线咨询
商务合作群:
783245476
技术对接群12:
489020124
技术对接群11:
844089794
400-9633321
免费获取API
时界门之将军电子游戏