快递鸟接口api技术文档

快递鸟接口api技术文档内容摘要：

： DataSign 生成后，对方接收到数据后，以同样的算法进行签名，生成摘要，对比两者的摘要是否相同，如果不同，说明传递过程中发生数据篡改。 快递鸟 快递接口技术文档 8 注册成为快递鸟用户后，会生成对应的 沙箱 用户 ID 和 APIKey， 用户 ID 相当于用户名，APIKey 相当于密码。 举例 ： RequestData (JSON)内容为： {39。 OrderCode39。 :39。 39。 ,39。 ShipperCode39。 :39。 SF39。 ,39。 LogisticCode39。 :39。 11895490757339。 } 经过 URL(UTF8)编码的内容为 ： %7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27SF%27%2c%27LogisticCode%27%3a%27118954907573%27%7d； EBusinessID=1237100， APIKey=56da2cf8c8a244b2b6fa476cd7d1ba17 DataSign 签名的 内容为 {39。 OrderCode39。 :39。 39。 ,39。 ShipperCode39。 :39。 SF39。 ,39。 LogisticCode39。 :39。 11895490757339。 }56da2cf8c8a244b2b6fa476cd7d1ba17 经过 md5 和 base64 后的内容就为 ：OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE=， 在经过 URL(UTF8)编码的内容为 ：OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE%3d 最终要发送的数据为 ： RequestType=1002amp。 EBusinessID=1237100amp。 RequestData =%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27SF%27%2c%27LogisticCode%27%3a%27118954907573%27%7d amp。 DataSign =OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE%3damp。 DataType=2 ，获得 EBusinessID 和 RequestData 和 DataSign 等这几个数据。 EBusinessID 得到 APIKey， RequestData+APIKey 的数据进行 md5 和 base64 后的内容就为 OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE= DataSign 是否一致，如果一致进行业务操作，如果不一致返回错误。 快递鸟 快递接口技术文档 9 (C)DataSign 签名加密代码 ///summary ///电商 Sign 签名 ////summary ///param name=content内容 /param ///param name=keyValueAPIkey/param ///param name=charsetURL 编码 /param ///returnsDataSign 签名 /returns Public String Encrypt (String content, String keyValue, String charset) { if (keyValue != null) { return base64(MD5(content + keyValue, charset), charset)。 } return base64(MD5(content, charset), charset)。 } ///summary /// 字符串 MD5 加密 ////summary ///param name=Text要加密的字符串 /param ///returns密文 /returns Private string MD5(string Text, string charset) { byte[] buffer = (charset).GetBytes(Text)。 try { check。 check = new ()。 byte[] somme = (buffer)。 string ret =。 foreach (byte a in somme) { if (a 16) ret += 0 + (X)。 else ret += (X)。 } return ()。 } catch { throw。 快递鸟 快递接口技术文档 10 } } Private static string base64(String str, String charset) { ((charset).GetBytes(str))。 } 接入步骤 注册账号成为快递鸟用户。 快递鸟提供的 用户 ID 是调用接口服务的身份证明，不可更改、不可转用， API Key 是应用访问 API 的签名附加密钥，必须妥善保存。 两者关系类似于 用户名 和密码，两者都会在签名和业务参数中使用。 官网登 录 网址 ： 官网注册网址 ： 官网接口介绍网址 ： 获取沙箱调试 UserID 和 Key /UserCenter/v2/SandBox/ ， 进行 实名认证， 并 开通 会员服务。 进入调试平台： 快递鸟 快递接口技术文档 11 查看沙箱调试 UserID 和 Key: ； 快递鸟提供各个 API接口的 DEMO(包括： .Net 版本、 Java版本、 PHP 版本 )供开发参考。 DEMO 下载地址：。 注意 ： 1. 测试环境中 获取 的测试快递单号不可用于实际发货。 2. 测试 UserID 和 AppKey 不能用于正式环境 API 调用 3. 部分接口需要开通相应服务，请即时开通后方可使用。 4. 发布上线后请替换正式请求地址 、 UserID 和 AppKey 快递鸟 快递接口技术文档 12 3 下单类接口 预约取件接口 功能说明 揽 件。 ：保价、隐私面单、短信服务、代收货款、货款直退、货款垫付。 用户 快递公司快递鸟预约取件 预约取件快递员按预约时间上门取件 基本信息 接口规则 ： 39。 amp。 +。 派范围，则无快递员上门揽件。 户原因导致快递公司投诉超过 3 次，快递鸟将停用此用户接口权限。 支持情况 支持预约取件的快递公司：顺丰、中通、百世、圆通、优速、龙邦、韵达、快捷、天天、全峰、 EMS、安能。 应用场景 电商平台、打单工具、 ERP 系统、 WEB 端、 APP 移动端 接口指令 1001 请求方式 POST请求 支持格式 只支持 Json 格式、 UTF8 编码 批量请求 不支持 接口地址 测试地址： 正式地址： 快递鸟 快递接口技术文档 13 沙箱接口 响应场景模拟规则 标志字段： OrderCode 值的规则 （当 OrderCode 传如下面这些值时，能获取到相应的模拟响应报文 ） ： 1. 1234560（模拟下单失败的响应） 2. 1234561（模拟下单成功的响应） 3. 其它值（默认是下单成功的响应） 应用级参数 名称 类型 (字符长 度 ) 是否必须 描述 WarehouseID String(50) O 仓库标识 (备用字段 ) WarehouseAddress String(50) O 仓库地址 (备用字段 ) CallBack String(50) O 用户自定义回调信息 MemberID String(50) O 会员标识 (备用字段 ) ShipperCode String(20) R 快递公司编码 LogisticCode String(30) O 快递单号 OrderCode String(30) R 订单编号 (自定义，不 可重复 ) PayType Int(1) R 运 费支付方式 : 1现付， 2到付， 3月结， 4第三方付 MonthCode String(20) C 月结编号 ExpType Int(2) R 快递类型： 1标准快件 Cost Double(5) O 快递运费 OtherCost Double(5) O 其他费用 String(30) O 收件人公司 String(30) R 收件人 String(20) R 电话与手机，必填一个 String(20) String(10) C 收件 地 邮编 (ShipperCode 为EMS、 YZPY 时必填 ) String(20) R 收件省 (如广东省，不要缺少 “省 ”，如果是直辖市，请直接传北京、 快递鸟 快递接口技术文档 14 上海等 ) String(20) R 收件市 (如深圳市，不要缺少 “市 ”) String(20) O 收件区 /县 (如福田区，不要缺少“区 ”或 “县 ”) String(100) R 收件人详细地址 String(30) O 发件人公司 String(30) R 发件人 String(20) R 电话与手机，必填一个 String(20) String(10) O 发件 地 邮编 (ShipperCode 为EMS、 YZPY 时必填 ) String(20) R 发件省 (如广东省，不要缺少 “省 ”，如果是直辖市，请直接传北京、上海等 ) String(20) R 发件市 (如深圳市，不要缺少 “市 ”) String(20) O 发件区 /县 (如福田区，不要缺少“区 ”或 “县 ”) String(100) R 发件人详细地址 StartDate Date O 上门 揽件 时间段，格式：YYYYMMDD HH24:MM:SS EndDate Weight Double(10,3) O 包裹总重量 kg Quantity Int(2) O 包裹数，一个包裹对应一个运单号，如果是大于 1 个包裹，返回则按照子母件的方式返回母运单号和子运单号 Volume Double(20,3) O 包裹总体积 m3 Remark String(100) O 备注 String(20) O 增值服务名称 String(30) O 增值服务值 String(30) O 客户标识 String(100) R 商品名称 String(20) O 商品编码 Int(5) O 商品件数 快递鸟 快递接口技术文档 15 请求 示例 : { OrderCode: 012657018199, ShipperCode: SF, PayType: 1, MonthCode: 7553045845, ExpType: 1, Cost: , OtherCost: , Sender: { Company: LV, Name: Taylor, Mobile: 15018442396, ProvinceName: 上海 , CityName: 上海 , ExpAreaName: 青浦区 , Address: 明珠路 }, Receiver: { Company: GCCUI, Name: Yann, Mobile: 15018442396, ProvinceName: 北京 , CityName: 北京 , ExpAreaName: 朝阳区 , Address: 三里屯街道 }, Commodity: [ { G。