2019快递鸟接口支持快递公司编码

快递单号查询自动识别接口API
快递鸟
版本
1功能说明
通过运单单号自动识别所属的快递公司。

同一个单号可能属于一家或者多家公司，快递鸟提供的服务为智能识别可能的快递公司，识别结果还需用户审核。

接口说明如下：
该接口仅对运单号做出识别，识别可能属于的一家或多家快递公司。

接口并不返回物流轨迹，用户可结合即时查询接口和订阅查询接口完成轨迹查询、订阅的动作。

接口识别会返回一家或者多家快递公司，返回的数据根据快递鸟大数据分析结果排序，排名靠前的命中率更高。

若识别失败，快递鸟返回的匹配结果为空。

2接口规则
(1)、接口只支持Json格式参数，接口指令2002。

只支持POST请求方式，utf-8编码。

(2)、支持增值服务，保价、代收货款、货款直退、货款垫付等。

(3)、测试地址：
:8081/Ebusiness/EbusinessOrderHandle.aspx
(4)、正式地址：/Ebusiness/EbusinessOrderHandle.aspx
3系统级输入参数
4应用级输入参数
5返回结果参数。

快递单号查询快递鸟API接⼝-EMS EMS快递查询调⽤快递鸟提供的快递查询API标准接⼝，快速对接100多家快递公司的物流轨迹查询，本篇⽂章实现<EMS>的快递单号查询。

⾸先我们准备好需要⽤到的资源，这⾥推荐⼤家去爱奇艺查看视频教程：测试商户ID：test1617571测试API key：554343b2-7252-439b-b4eb-1af42c8f2175(此Key仅限测试环境使⽤)API测试地址：接下来，我们讲解⼀下请求参数⼀、接⼝描述/说明请求系统级参数说明：参数名称类型说明必须要求RequestData String请求内容需进⾏URL(utf-8)编码。

请求内容JSON格式，须和DataType⼀致。

REBusinessID String商户ID，请在我的服务页⾯查看。

RRequestType String请求指令类型：1002RDataSign String 数据内容签名：把(请求内容(未编码)+AppKey)进⾏MD5加密，然后Base64编码，最后进⾏URL(utf-8)编码。

详细过程请查看Demo。

RDataType String请求、返回数据类型：2-json；O备注：R-必填（Required），O-可选（Optional），C-报⽂中该参数在⼀定条件下可选（Conditional）这⾥提到了系统级参数，也相当于是公⽤参数，这些参数是调⽤每个接⼝都是必须要传参的。

⼆、接⼝参数请求内容字段定义：参数名称类型说明必须要求OrderCode String订单编号OShipperCode String快递公司编码RLogisticCode String物流单号RCustomerName String寄件⼈或收件⼈的⼿机号后四位数字R接⼝参数，也叫业务参数，请求的业务接⼝不同，参数的字段，内容也不同，是跟着业务变化的，这⾥我们实现的是即时查询接⼝，请求指令类型：1002，快递鸟官⽹要求必须传递快递公司编码和物流单号，EMS快递的编码是EMS如要查看其他快递公司的编码，点击此链接：我们⽤真实单号（1160001630231）来完成轨迹接⼝调⽤，请求 JSON{'OrderCode':'','ShipperCode':'EMS','LogisticCode':' 1160001630231'}请求的完整报⽂（URL编码以后）：RequestData=%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27EMS%27%2c%27LogisticCode%27%3a%271160001630231%27%7d%0d%0a++++++++&EBusinessID=1264未编码的请求报⽂：RequestData={'OrderCode':'','ShipperCode':'EMS','LogisticCode':'1160001630231'}&EBusinessID=1264783&RequestType=1002&DataSign=NDlmMDAzZTYwYmYyY2FmZjRjOTNhZDAwYjVkNDVjODM=&DataType=2返回参数定义：参数名称类型说明必须要求EBusinessID String⽤户ID ROrderCode String订单编号OShipperCode String快递公司编码RLogisticCode String物流运单号OSuccess Bool成功与否RReason String失败原因OState String物流状态：2-在途中,3-签收,4-问题件RTracesAcceptTime String时间RAcceptTime String返回报⽂信息{"LogisticCode": "1160001630231","ShipperCode": "EMS","Traces": [{"AcceptStation": "[莆⽥市]【莆⽥电商营业部】已收件,揽投员:郑美停,电话:152********","AcceptTime": "2020-02-06 20:12:56"}, {"AcceptStation": "[莆⽥市]离开【莆⽥电商营业部】,下⼀站【莆⽥市邮区中⼼】","AcceptTime": "2020-02-06 20:15:50"}, {"AcceptStation": "[莆⽥市]到达【莆⽥市邮区中⼼】","AcceptTime": "2020-02-06 20:17:26"}, {"AcceptStation": "[莆⽥市]离开【莆⽥市邮区中⼼】,下⼀站【福州旗⼭处理中⼼】","AcceptTime": "2020-02-06 23:59:31"}, {"AcceptStation": "[福州市]到达【福州旗⼭处理中⼼】（经转）","AcceptTime": "2020-02-07 17:40:37"}, {"AcceptStation": "[福州市]离开【福州旗⼭处理中⼼】,下⼀站【长沙邮件处理中⼼】（经转）","AcceptTime": "2020-02-08 04:56:41"}, {"AcceptStation": "[长沙市]到达【长沙邮件处理中⼼】（经转）","AcceptTime": "2020-02-08 16:05:58"}, {"AcceptStation": "[长沙市]离开【长沙邮件处理中⼼】,下⼀站【益阳邮件处理中⼼】（经转）","AcceptTime": "2020-02-08 20:28:47"}, {"AcceptStation": "[益阳市]到达【益阳邮件处理中⼼】","AcceptTime": "2020-02-09 00:25:22"}, {"AcceptStation": "[益阳市]离开【益阳邮件处理中⼼】,下⼀站【益阳市资阳揽投部】","AcceptTime": "2020-02-09 06:22:33"}, {"AcceptStation": "[益阳市]到达【益阳市资阳揽投部】","AcceptTime": "2020-02-09 08:56:06"}, {"AcceptStation": "[益阳市]【益阳市资阳揽投部】安排投递,投递员:龙飞跃,电话:158********,揽投部电话:177********", "AcceptTime": "2020-02-09 09:26:09"}, {"AcceptStation": "[益阳市]已签收,收发室,投递员:龙飞跃,电话:158********","AcceptTime": "2020-02-09 15:03:48"}],"State": "3","EBusinessID": "1264783","Success": true}这⾥根据我们的实际业务需求来选择免费套餐或者收费套餐。

快递物流寄件下单api接口调用对接为了让你对接更简单，我会分享源代码，把源码复制到你的项目上，就能快速完成电商售后退货快递寄件下单预约快递员上门取件接口对接，调用快递鸟提供的上门取件API标准接口，成功调用后，快递员会准时上门取件，同时支持快递单号物流轨迹查询，快递鸟物流单号查询api接口不区分开发语言，支持Java，C#，PHP，Python，ObjectC等开发语言的程序调用。

1 接口规范说明1.1 接口规范及说明1.1.1 报文及报文编码报文格式：Json格式请求方法的编码格式(utf-8)：交互协议上统一用UTF-8，避免传递中文数据出现乱码。

1.1.2 接口数据包结构图例- 数据包结构(系统级{数据})1.1.3 JSON示例1.1.4 系统级参数*快递所有接口统一使用此系统级参数，根据不同的请求接口指令接入不同的接口。

1.1.5 流程示意图1.1.6 名词定义1.2 签名说明1.2.1 关于签名快递鸟和第三方电子商务公司系统进行对接，有一定的安全机制。

采用IP认证加签名的方式对接，具体方案如下：1. 防止数据被篡改2. 注：DataSign生成后，对方接收到数据后，以同样的算法进行签名(推送接口RequestType为101/102不需要进行URL编码)，生成摘要，对比两者的摘要是否相同，如果不同，说明传递过程中发生数据篡改。

2.调用接口的身份认证注册成为快递鸟用户后，会生成对应的用户ID和APIKey，用户ID相当于用户名，APIKey相当于密码。

举例：1.假设2.那么DataSign签名的内容为3.接收方收到数据后，获得EBusinessID 和RequestData和DataSign等这几个数据。

4.接收方对EBusinessID得到APIKey，RequestData+APIKey的数据进行md5和base64后的内容就为OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE=5.接收方判断签名后的数据跟传递过来的DataSign是否一致，如果一致进行业务操作，如果不一致返回错误。

快递鸟API接口支持快递公司编码表2019（最新）快递鸟单号查询接口和电子面单等接口都是免费的，快递鸟是一个独立的第三方国际物流接口服务商，快递鸟API接口的优点主要是：全、多、稳定、及时，免费。

目前快递鸟已经集成了全球418家物流快递公司接口，高实时、高稳定、高并发，也可以对接自动识别快递公司接口，支持申通、顺丰、圆通、宅急送、韵达、中通、百世、天天、四通一达、京东、EMS等国内/国际快递查询。

为电商平台、电商系统商（ERP）、仓储（WMS）等有系统的用户提供智选物流、电子面单、物流查询、物流提醒等全流程的物流接口解决方案。

快递鸟物流查询API接口好用，使用的用户很多（有十几个千人技术QQ群），大的ERP基本都用的是快递鸟的数据，非淘系的电商平台也都是用快递鸟提供的接口服务。

整个对接挺简单的，到快递鸟网站注册一下，申请到自己的KEY 和ID，对接后就可以使用了，在快递鸟网站上下载调用的demo，修改下参数就可以了。

顺丰速运快递查询接口API和电子面单接口可以通过快递鸟对接，通过顺丰单号和手机号后四位查询轨迹信息，如果是通过快递鸟下单获得的顺丰单号，可通过单号直接查询，具体下载快递鸟接口技术文档查看接口说明。

ShipperCode为SF，且快递单号非快递鸟渠道返回时，必填，对应收件人/寄件人手机号后四位；ShipperCode 为SF，且快递单号为快递鸟渠道返回时，不填。

对接快递鸟API接口需要各家快递公司编码表，下面附快递鸟API接口支持快递公司编码表供大家使用：快递鸟接口支持快递公司编码表快递公司编码轨迹查询是否支持常用顺丰速运SF 支持百世快递HTKY 支持中通快递ZTO 支持申通快递STO 支持圆通速递YTO 支持韵达速递YD 支持邮政快递包裹YZPY 支持EMS EMS 支持天天快递HHTT 支持京东快递JD 支持优速快递UC 支持德邦快递DBL 支持宅急送ZJS 支持TNT快递TNT 支持UPS UPS 支持DHL DHL 支持FEDEX联邦(国内件）FEDEX 支持FEDEX联邦(国际件）FEDEX_GJ 支持国内A安捷快递AJ 支持阿里跨境电商物流ALKJWL 支持安迅物流AX 支持安邮美国AYUS 支持亚马逊物流AMAZON 支持澳门邮政AOMENYZ 支持澳多多ADD 支持澳邮专线AYCA 支持安鲜达AXD 支持安能快运ANEKYB八达通BDT 支持百腾物流BETWL 支持北极星快运BJXKY 支持奔腾物流BNTWL 支持百福东方BFDF 支持贝海国际BHGJ 支持八方安运BFAY 支持百世快运BTWL 支持C春风物流CFWL 支持诚通物流CHTWL 支持城市100 CITY100 支持城际快递CJKD 支持CNPEX中邮快递CNPEX 支持COE东方快递COE 支持长沙创一CSCY 支持成都善途速运CDSTKY 支持联合运通CTG 支持疯狂快递CRAZY 支持CBO钏博物流CBO 支持承诺达CND 支持D D速物流DSWL 支持到了港DLG 支持大田物流DTWL 支持东骏快捷物流DJKJWL 支持德坤DEKUN 支持德邦快运DBLKY 支持大马鹿DML 支持E E特快ETK 支持EWE EWE 支持F快服务KFW 支持飞康达FKD 支持富腾达FTD 支持凡宇货的FYKD 支持速派快递FASTGO 支持丰通快运FT 支持G冠达GD 支持广东邮政GDEMS 支持共速达GSD 支持广通GTONG 支持迦递快递GAI 支持港快速递GKSD 支持高铁速递GTSD 支持H汇丰物流HFWL 支持黑狗冷链HGLL 支持恒路物流HLWL 支持天地华宇HOAU 支持鸿桥供应链HOTSCM 支持海派通物流公司HPTEX 支持华强物流hq568 支持环球速运HQSY 支持华夏龙物流HXLWL 支持豪翔物流HXWL 支持合肥汇文HFHW 支持辉隆物流HLONGWL 支持华企快递HQKD 支持韩润物流HRWL 支持青岛恒通快递HTKD 支持货运皇物流HYH 支持好来运快递HYLSD 支持皇家物流HJWL 支持J捷安达JAD 支持京广速递JGSD 支持九曳供应链JIUYE 支持急先达JXD 支持晋越快递JYKD 支持加运美JYM 支持景光物流JGWL 支持佳怡物流JYWL 支持京东快运JDKY佳吉快运CNEX 支持K跨越速运KYSY 支持快速递物流KSDWL 支持快8速运KBSY 支持L龙邦快递LB 支持立即送LJSKD 支持联昊通速递LHT 支持M民邦快递MB 支持民航快递MHKD 支持美快MK 支持门对门快递MDM 支持迈隆递运MRDY 支持明亮物流MLWL 支持N南方传媒物流NFCM 支持能达速递NEDA 支持P平安达腾飞快递PADTF 支持泛捷快递PANEX 支持品骏快递PJ 支持PCA Express PCA 支持Q全晨快递QCKD 支持全日通快递QRT 支持快客快递QUICK 支持全信通QXT 支持荣庆物流RQ 支持七曜中邮QYZY 支持R如风达RFD 支持日日顺物流RRS 支持瑞丰速递RFEX 支持S赛澳递SAD 支持苏宁物流SNWL 支持圣安物流SAWL 支持晟邦物流SBWL 支持上大物流SDWL 支持盛丰物流SFWL 支持速通物流ST 支持速腾快递STWL 支持速必达物流SUBIDA 支持速递e站SDEZ 支持速呈宅配SCZPDS 支持速尔快递SURE 支持闪送SS 支持盛通快递STKD 支持顺心捷达SX 支持T台湾邮政TAIWANYZ 支持唐山申通TSSTO 支持通用物流TYWL 支持腾林物流TLWLU全一快递UAPEX 支持优联吉运ULUCKEX 支持UEQ Express UEQ 支持W万家康WJK 支持万家物流WJWL 支持武汉同舟行WHTZX 支持维普恩WPE 支持万象物流WXWL 支持微特派WTP 支持温通物流WTWLX迅驰物流XCWL 支持信丰物流XFEX 支持新杰物流XJ 支持Y源安达快递YADEX 支持远成物流YCWL 支持远成快运YCSY 支持义达国际物流YDH 支持易达通YDT 支持原飞航物流YFHEX 支持亚风快递YFSD 支持运通快递YTKD 支持亿翔快递YXKD 支持运东西网YUNDX 支持壹米滴答YMDD 支持邮政国内标快YZBK 支持一站通速运YZTSY 支持驭丰速运YFSUYUN 支持余氏东风YSDF 支持耀飞快递YF 支持韵达快运YDKY 支持云路YL 支持一智通YZT 支持Z增益快递ZENY 支持汇强快递ZHQKD 支持众通快递ZTE 支持郑州速捷SJ 支持中通快运ZTOKY 支持中邮快递ZYKD 支持中粮我买网WM 支持芝麻开门ZMKM 支持中骅物流ZHWL 支持中铁物流ZTWL 支持国外A AAE全球专递AAE 支持ACS雅仕快递ACS 支持ADP Express Tracking ADP 支持安圭拉邮政ANGUILAYOU 支持APAC APAC 支持Aramex ARAMEX 支持奥地利邮政AT 支持Australia Post Tracking AUSTRALIA 支持B比利时邮政BEL 支持BHT快递BHT 支持秘鲁邮政BILUYOUZHE 支持巴西邮政BR 支持不丹邮政BUDANYOUZH 支持C CDEK CDEK 支持程光物流CG 支持加拿大邮政CA 支持D递必易国际物流DBYWL 支持大道物流DDWL 支持德国云快递DGYKD 支持到乐国际DLGJ 支持DHL德国DHL_DE 支持DHL(英文版) DHL_EN 支持DHL全球DHL_GLB 支持DHL Global Mail DHLGM 支持丹麦邮政DK 支持DPD DPD 支持DPEX DPEX 支持递四方速递D4PX 支持E EMS国际EMSGJ 支持易客满EKM 支持EPS (联众国际快运) EPS 支持EShipper ESHIPPER 支持F丰程物流FCWL 支持法翔速运FX 支持FQ FQ 支持芬兰邮政FLYZ 支持方舟国际速递FZGJ 支持G国际e邮宝GJEYB 支持国际邮政包裹GJYZ 支持GE2D GE2D 支持冠泰GT 支持GLS GLS 支持欧洲专线(邮政) IOZYZ 支持澳大利亚邮政IADLYYZ 支持阿尔巴尼亚邮政IAEBNYYZ 支持阿尔及利亚邮政IAEJLYYZ 支持阿富汗邮政IAFHYZ 支持安哥拉邮政IAGLYZ 支持埃及邮政IAJYZ 支持阿鲁巴邮政IALBYZ 支持阿联酋邮政IALYYZ 支持阿塞拜疆邮政IASBJYZ 支持博茨瓦纳邮政IBCWNYZ 支持波多黎各邮政IBDLGYZ 支持冰岛邮政IBDYZ 支持白俄罗斯邮政IBELSYZ 支持波黑邮政IBHYZ 支持保加利亚邮政IBJLYYZ 支持巴基斯坦邮政IBJSTYZ 支持黎巴嫩邮政IBLNYZ 支持波兰邮政IBOLYZ 支持宝通达IBTD 支持贝邮宝IBYB 支持出口易ICKY 支持德国邮政IDGYZ 支持危地马拉邮政IWDMLYZ 支持乌干达邮政IWGDYZ 支持乌克兰EMS IWKLEMS 支持乌克兰邮政IWKLYZ 支持乌拉圭邮政IWLGYZ 支持林克快递ILKKD 支持文莱邮政IWLYZ 支持新喀里多尼亚邮政IXGLDNYYZ 支持爱尔兰邮政IE 支持夏浦物流IXPWL 支持印度邮政IYDYZ 支持夏浦世纪IXPSJ 支持厄瓜多尔邮政IEGDEYZ 支持俄罗斯邮政IELSYZ 支持飞特物流IFTWL 支持瓜德罗普岛邮政IGDLPDYZ 支持哥斯达黎加邮政IGSDLJYZ 支持韩国邮政IHGYZ 支持华翰物流IHHWL 支持互联易IHLY 支持哈萨克斯坦邮政IHSKSTYZ 支持黑山邮政IHSYZ 支持津巴布韦邮政IJBBWYZ 支持吉尔吉斯斯坦邮政IJEJSSTYZ 支持加纳邮政IJNYZ 支持柬埔寨邮政IJPZYZ 支持克罗地亚邮政IKNDYYZ 支持肯尼亚邮政IKNYYZ 支持科特迪瓦EMS IKTDWEMS 支持罗马尼亚邮政ILMNYYZ 支持摩尔多瓦邮政IMEDWYZ 支持马耳他邮政IMETYZ 支持尼日利亚邮政INRLYYZ 支持塞尔维亚邮政ISEWYYZ 支持塞浦路斯邮政ISPLSYZ 支持乌兹别克斯坦邮政IWZBKSTYZ 支持西班牙邮政IXBYYZ 支持新加坡EMS IXJPEMS 支持新西兰邮政IXXLYZ 支持意大利邮政IYDLYZ 支持英国邮政IYGYZ 支持亚美尼亚邮政IYMNYYZ 支持也门邮政IYMYZ 支持智利邮政IZLYZ 支持J日本邮政JP 支持今枫国际JFGJ 支持极光转运JGZY 支持吉祥邮转运JXYKD 支持嘉里国际JLDT 支持绝配国际速递JPKD 支持佳惠尔SYJHE 支持L联运通LYT 支持联合快递LHKDS 支持林道国际SHLDHY 支持N荷兰邮政NL 支持新顺丰NSF 支持O ONTRAC ONTRAC 支持OCS OCS 支持全球邮政QQYZ 支持P POSTEIBE POSTEIBE 支持啪啪供应链PAPA 支持Q秦远海运QYHY 支持启辰国际VENUCIA 支持R瑞典邮政RDSE 支持S SKYPOST SKYPOST 支持瑞士邮政SWCH 支持首达速运SDSY 支持穗空物流SK 支持首通快运STONG 支持申通快递国际单STO_INTL 支持上海久易国际JYSD 支持T泰国138 TAILAND138 支持U USPS美国邮政USPS 支持万国邮政UPU 支持V中越国际物流VCTRANS 支持X星空国际XKGJ 支持迅达国际XD 支持香港邮政XGYZ 支持喜来快递XLKD 支持鑫世锐达XSRD 支持新元国际XYGJ 支持ADLER雄鹰国际速递XYGJSD 支持西邮寄XYJ 支持Y日本大和运输(Yamato) YAMA 支持YODEL YODEL 支持一号线YHXGJSD 支持约旦邮政YUEDANYOUZ 支持玥玛速运YMSY 支持鹰运YYSD 支持易境达YJD 支持洋包裹YBG 支持友家速递YJ 支持转运A AOL（澳通）AOL 支持B BCWELT BCWELT 支持笨鸟国际BN 支持U优邦国际速运UBONEX 支持UEX UEX 支持Y韵达国际YDGJ 支持（注：仅支持通过快递鸟电子面单接口下单返回的韵达国际单号查询）Z爱购转运ZY_AG 支持爱欧洲ZY_AOZ 支持澳世速递ZY_AUSE 支持AXO ZY_AXO 支持贝海速递ZY_BH 支持蜜蜂速递ZY_BEE 支持百利快递ZY_BL 支持斑马物流ZY_BM 支持百通物流ZY_BT 支持策马转运ZY_CM 支持EFS POST ZY_EFS 支持宜送转运ZY_ESONG 支持飞碟快递ZY_FD 支持飞鸽快递ZY_FG 支持风行快递ZY_FX 支持风行速递ZY_FXSD 支持飞洋快递ZY_FY 支持皓晨快递ZY_HC 支持海悦速递ZY_HYSD 支持君安快递ZY_JA 支持时代转运ZY_JD 支持骏达快递ZY_JDKD 支持骏达转运ZY_JDZY 支持久禾快递ZY_JH 支持金海淘ZY_JHT 支持联邦转运FedRoad ZY_LBZY 支持龙象快递ZY_LX 支持美国转运ZY_MGZY 支持美速通ZY_MST 支持美西转运ZY_MXZY 支持QQ-EX ZY_QQEX 支持瑞天快递ZY_RT 支持瑞天速递ZY_RTSD 支持速达快递ZY_SDKD 支持四方转运ZY_SFZY 支持上腾快递ZY_ST 支持天际快递ZY_TJ 支持天马转运ZY_TM 支持滕牛快递ZY_TN 支持太平洋快递ZY_TPY 支持唐三藏转运ZY_TSZ 支持TWC转运世界ZY_TWC 支持润东国际快线ZY_RDGJ 支持同心快递ZY_TX 支持天翼快递ZY_TY 支持德国海淘之家ZY_DGHT 支持德运网ZY_DYW 支持文达国际DCS ZY_WDCS 支持同舟快递ZY_TZH 支持UCS合众快递ZY_UCS 支持星辰快递ZY_XC 支持先锋快递ZY_XF 支持云骑快递ZY_YQ 支持优晟速递ZY_YSSD 支持运淘美国ZY_YTUSA 支持至诚速递ZY_ZCSD 支持增速海淘ZYZOOM 支持中驰物流ZH 支持中欧快运ZO 支持准实快运ZSKY 支持中外速运ZWSY 支持郑州建华ZZJH 支持。

1.申请一个快递鸟的帐号获取授权申请/reg快递鸟的帐号使永久免费的，且申请了立即就能用的，也不需要审核。

2.按照单号识别接口和即时查询接口封装好数据3.获取返回的 json 数据输出import jsonimport urllibimport urllib.requestimport hashlibimport base64import urllib.parse# 此处为快递鸟官网申请的帐号和密码APP_id = "1266271"APP_key = "7526a46e-3a2a-4f5b-8659-d72f361e3386"def encrypt(origin_data, appkey):"""数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码""" m = hashlib.md5()m.update((origin_data+appkey).encode("utf8"))encodestr = m.hexdigest()base64_text = base64.b64encode(encodestr.encode(encoding='utf-8'))return base64_textdef sendpost(url, datas):"""发送post请求"""postdata = urllib.parse.urlencode(datas).encode('utf-8')header = {"Accept": "application/x-www-form-urlencoded;charset=utf-8","Accept-Encoding": "utf-8"}req = urllib.request.Request(url, postdata, header)get_data = (urllib.request.urlopen(req).read().decode('utf-8'))return get_datadef get_company(logistic_code, appid, appkey, url):"""获取对应快递单号的快递公司代码和名称"""data1 = {'LogisticCode': logistic_code}d1 = json.dumps(data1, sort_keys=True)requestdata = encrypt(d1, appkey)post_data = {'RequestData': d1,'EBusinessID': appid,'RequestType': '2002','DataType': '2','DataSign': requestdata.decode()}json_data = sendpost(url, post_data)sort_data = json.loads(json_data)return sort_datadef get_traces(logistic_code, shipper_code, appid, appkey, url):"""查询接口支持按照运单号查询(单个查询)"""data1 = {'LogisticCode': logistic_code, 'ShipperCode': shipper_code}d1 = json.dumps(data1, sort_keys=True)requestdata = encrypt(d1, appkey)post_data = {'RequestData': d1, 'EBusinessID': appid, 'RequestType': '1002', 'DataType': '2','DataSign': requestdata.decode()}json_data = sendpost(url, post_data)sort_data = json.loads(json_data)return sort_datadef recognise(expresscode):"""输出数据"""url = ':8081/Ebusiness/EbusinessOrderHandle.aspx' data = get_company(expresscode, APP_id, APP_key, url)if not any(data['Shippers']):print("未查到该快递信息,请检查快递单号是否有误！")else:print("已查到该", str(data['Shippers'][0]['ShipperName'])+"("+str(data['Shippers'][0]['ShipperCode'])+")", expresscode)trace_data = get_traces(expresscode, data['Shippers'][0]['ShipperCode'], APP_id, APP_key, url)if trace_data['Success'] == "false" or not any(trace_data['Traces']): print("未查询到该快递物流轨迹！")else:str_state = "问题件"if trace_data['State'] == '2':str_state = "在途中"if trace_data['State'] == '3':str_state = "已签收"print("目前状态： "+str_state)trace_data = trace_data['Traces']item_no = 1for item in trace_data:print(str(item_no)+":", item['AcceptTime'],item['AcceptStation'])item_no += 1print("\n")returnwhile True:code = input("请输入快递单号(Esc退出)：")code = code.strip()if code == "esc":breakrecognise(code)【疑问解答】1、问题：快递鸟接口有并发要求吗？快递鸟即时查询接口并发不超过10次/秒,物流跟踪接口订阅不超过30次/秒,电子面单接口下单不超过20次/秒。

备注：调用电子面单时IsNotice参数可控制是否通知快递员上门揽件（*0-通知；1-不通知；不填则默认为0）表中帐号和密码指的是向快递公司网点申请开通电子面单权限后，快递公司提供的电子面单帐号和密码申通电子面单不支持测试环境，只能在正式环境下使用中通电子面单账号开通流程圆通电子面单账号开通流程快递鸟电子面单接口常见问题问题：什么是电子面单？相比传统面单而言它有什么优势？电子面单是一种新型的快递面单。

材料为热敏纸，有成本低、打印快、单号方便获取、管理等特点。

在行业内也被称为热敏纸快递标签、经济型面单，二维码面单等。

它与传统面单相比主要有如下区别和优势。

a. 效率更高n 提升打印效率：电子面单的打印效率是普通纸质面单的4-6倍，平均每单打印只需花费1-2秒钟，高效率的打单大大缓解电商等客户的大批量打单压力，轻松应对大促；n 提高发货效率：电子面单不需要把快递单和定单信息逐一匹配操作，在订单信息申请快递单号的时候就已完成了定单匹配；卖家无需再安排人员专门抽取“发货联”，操作效率进一步提升；减少了手写“大头笔”等动作，提高了分拣效率；提高了分拣的准确性；n 支持多种电商增值业务，无需人肉绑定面单（例如：货到付款，预约配送）。

b. 成本更低n 电子面单的纸张是0.1元/张，成本比传统纸质面单0.2-0.3元降低了一大半；n 降低快递公司作业成本，如取消抽单和手写大头笔，单位时间内的揽货可以提升一倍以上；c. 数据信息完整实效n 在申请电子面单运单号的时候，就匹配到具体的“大头笔”信息，既减少人工操作的成本并又可以提高准确率和效率；商家在使用电子面单的时候就会自动将数据同步给快递公司，可以在申请面单的时候就拿到第一手数据，更加真实并且提高速度。

问题：快递鸟电子面单接口如何对接？1、注册快递鸟APIkey /reg2、加技术问题交流群：200121393 在群文件中下载技术接口文档3、请贵司技术根据技术文档开发后测试（需快递网点账号）4、上线问题：各快递公司编码是什么？电子面单账号如何开通？需要提供什么？顺丰（SF）百世快递（HTKY）百世快运（BTWL）申通（STO）中通（ZTO）圆通（YTO）韵达（YD）EMS（EMS）宅急送（ZJS）德邦（DBL）全峰（QFKD）如风达（RFD）优速快递（UC）龙邦（LB）增益（ZENY）华航快递（HHKD）运通快递（YTKD）希优特（XYT）民邦物流（MB）长沙创一（CSCY）安能物流（ANE）精英速运（JYSY）问题：快递鸟电子面单接口返回的html模板包含什么内容呢?打印出来的实际效果是什么样的？针对每个快递公司，模版都会有变化嘛还是采用统一的模版样式？返回的是快递公司官方认可的html模板，电子面单接口会返回包含收件人和寄件人以及商品信息等数据的模板，用户可以直接将该电子面单模板进行打印，将返回的数据放在HTML 控件中显示就行，不同快递公司电子面单模板不一样。

快递鸟快递查询接口API代码1.代码使用说明（1）查询接口支持按照运单号查询(单个查询)。

（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。

（3）返回的物流跟踪信息按照发生的时间升序排列。

（4）接口指令1002。

（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。

（6）接口提供：快递鸟2.功能展现（1）电商网站用户打开“我的订单”时调用此API显示物流信息详情。

（2）电商管理后台的物流系统，客服在对账前查询所有运单的签收状态，并追踪问题。

（3）每日调用次数限制不超过3000次，如超过该限制，可对接物流跟踪API。

（4）全流程的物流状态跟踪I3.代码签名采用IP 认证加签名的方式对接，具体方案如下：1)防止数据被篡改在POST 请求中会传递 5 个必须(R)参数RequestData==数据内容(URL 编码:UTF-8)EBusinessID==用户IDRequestType=请求指令类型DataSign== 数据内容签名：把(请求内容(未编码)+ApiKey)进行MD5 加密，然后Base64编码，最后进行URL(utf-8)编码DataType==返回数据类型(2-json)注：DataSign 生成后，对方接收到数据后，以同样的算法进行签名，生成摘要，对比两者的摘要是否相同，如果不同，说明传递过程中发生数据篡改。

2)调用接口的身份认证注册成为接口用户后，会生成对应的用户ID 和APIKey，用户ID 相当于用户名，APIKey 相当于密码。

4.接口申请1)接口网注册账号成为用户;提供的用户ID 是调用接口服务的身份证明，不可更改、不可转用，API Key 是应用访问API 的签名附加密钥，必须妥善保存。

两者关系类似于用户名和密码，两者都会在签名和业务参数中使用。

快递公司编码说明以下是快递鸟API接口对外开放的部分快递公司编码的列表，接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。

如：EMS物流单号应选择快递公司编码（EMS）、德邦物流单号应选择快递公司编码（DBL）、天天快递物流单号应选择快递公司编码（HHTT）、圆通速递物流单号应选择快递公司编码（YTO）、中通速递快递物流单号应选择快递公司编码（ZTO）、亚马逊物流单号应选择快递公司编码（AMAZON）、顺丰物流单号应选择快递公司编码（SF）、百世快运物流单号应选择快递公司编码（BTWL）、宅急送物流单号应选择快递公司编码（ZJS）。

适用于即时查询API接口和订阅推送API接口。

如果在下面没有找到您所要的快递公司，请添加在群共享文件下载。

国内快递查询接口编码国际快递查询接口转运查询接口快递查询接口应用场景查询订单的物流信息可实现需求1.App中直接集成实现快递物流信息查询Api接口2.在微信公众号中，根据用户输入的订单号，我们的后台识别订单号并根据快递鸟查询快递Api接口，实现自动查询的功能3.等等申请Key按照你的信息，依次把信息填写完整，点击提交申请即可。

登录成功后，就可以看到ID和key等信息，有这些信息就可以请求查询等其他的接口Api快递查询Api接口接口文档及各开发语言Demo查询Api接口定义系统级输入参数参数名称类型必须要求说明RequestData String R 请求内容，JSON或XML格式,须和DataType一致EBusinessID String R 用户IDRequestType String R 请求指令类型：1002DataSign String R 数据内容签名DataType String O 请求、返回数据类型：1-xml,2-json；默认为xml格式应用级输入参数参数名称类型必须要求说明OrderCode varchar(50) O 订单编号ShipperCode varchar(10) R 快递公司编码LogisticCode varchar(50) R 物流单号返回结果参数参数名称类型必须要求说明EBusinessID Int R 电商用户IDOrderCode Varchar(50) O 订单编号ShipperCode varchar(10) R 快递公司编码LogisticCode Varchar(50) R 物流运单号Success Bool R 成功与否Reason Varchar(50) O 失败原因State Int R 物流状态1：已取件2：在途中3：签收Traces Varchar(Max) R 物流轨迹详情物流轨迹详情参数名称类型必须要求说明AcceptTime DateTime R 时间AcceptStation Varchar(50) R 描述Remark Varchar(150) O 备注请求JSON参数{"OrderCode" : "","ShipperCode" : "SF","LogisticCode" :}响应JSON参数{"EBusinessID" : "1109259","OrderCode" : "","ShipperCode" : "SF","LogisticCode" : ,"Success" : true,"State" : 3,"Reason" : null,"traces" : [{"AcceptTime" : "2014/06/25 08:05:37","AcceptStation" : "正在派件..(派件人:邓裕富,电话深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/25 04:01:28","AcceptStation" : "快件在深圳集散中心 ,准备送往下一站深圳 [深圳市]", "Remark" : null}, {"AcceptTime" : "2014/06/25 01:41:06","AcceptStation" : "快件在深圳集散中心 [深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/24 20:18:58","AcceptStation" : "已收件[深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/24 20:55:28","AcceptStation" : "快件在深圳 ,准备送往下一站深圳集散中心 [深圳市]", "Remark" : null}, {"AcceptTime" : "2014/06/25 10:23:03","AcceptStation" : "派件已签收[深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/25 10:23:03","AcceptStation" : "签收人是：已签收[深圳市]","Remark" : null}]}查询Api接口使用以Java开发语言为例，进行展开importimportimportimportimportimportimportimportimportimportimport/**** 快递鸟物流轨迹即时查询接口** @技术QQ群* @see* @copyright: 深圳市快金数据技术服务有限公司** DEMO中的电商ID与私钥仅限测试使用，正式环境请单独注册账号* 单日超过500单查询量，建议接入我方物流轨迹订阅推送接口** ID和Key请到官网申请：*/public class KdniaoTrackQueryAPI {//DEMOpublic static void main(String[] args) {KdniaoTrackQueryAPI api = new KdniaoTrackQueryAPI();try {String result = api.getOrderTracesByJson("ANE", );} catch (Exception e) {e.printStackTrace();}}//电商IDprivate String EBusinessID="请到快递鸟官网申请;//电商加密私钥，快递鸟提供，注意保管，不要泄漏private String AppKey="请到快递鸟官网申请;//请求urlprivate String ReqURL=;/*** Json方式查询订单物流轨迹* @throws Exception*/public String getOrderTracesByJson(String expCode, String expNo) throws Excepti on{String requestData= "{'OrderCode':'','ShipperCode':'" + expCode + "','Logis ticCode':'" + expNo + "'}";Map<String, String> params = new HashMap<String, String>();params.put("RequestData", urlEncoder(requestData, "UTF-8"));params.put("EBusinessID", EBusinessID);params.put("RequestType", "1002");String dataSign=encrypt(requestData, AppKey, "UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8"));params.put("DataType", "2");String result=sendPost(ReqURL, params);//根据公司业务处理返回的信息......return result;}/*** XML方式查询订单物流轨迹* @throws Exception*/public String getOrderTracesByXml() throws Exception{String requestData= "<?xml version=\"1.0\" encoding=\"utf-8\" ?>"+"<Content>"+"<OrderCode></OrderCode>"+"<ShipperCode>SF</ShipperCode>"++"</Content>";Map<String, String> params = new HashMap<String, String>();params.put("RequestData", urlEncoder(requestData, "UTF-8"));params.put("EBusinessID", EBusinessID);params.put("RequestType", "1002");String dataSign=encrypt(requestData, AppKey, "UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8"));params.put("DataType", "1");String result=sendPost(ReqURL, params);//根据公司业务处理返回的信息......return result;}/*** MD5加密* @param str 内容* @param charset 编码方式* @throws Exception*/@SuppressWarnings("unused")private String MD5(String str, String charset) throws Exception { MessageDigest md = MessageDigest.getInstance("MD5");md.update(str.getBytes(charset));byte[] result = md.digest();StringBuffer sb = new StringBuffer(32);for (int i = 0; i < result.length; i++) {int val = result[i] & 0xff;if (val <= 0xf) {sb.append("0");}sb.append(Integer.toHexString(val));}return sb.toString().toLowerCase();}/*** base64编码* @param str 内容* @param charset 编码方式* @throws UnsupportedEncodingException*/private String base64(String str, String charset) throws UnsupportedEncodingExc eption{String encoded = base64Encode(str.getBytes(charset));return encoded;}@SuppressWarnings("unused")private String urlEncoder(String str, String charset) throws UnsupportedEncodin gException{String result = URLEncoder.encode(str, charset);return result;}/*** 电商Sign签名生成* @param content 内容* @param keyValue Appkey* @param charset 编码方式* @throws UnsupportedEncodingException ,Exception* @return DataSign签名*/@SuppressWarnings("unused")private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception{if (keyValue != null){return base64(MD5(content + keyValue, charset), charset);}return base64(MD5(content, charset), charset);}/*** 向指定 URL 发送POST方法的请求* @param url 发送请求的 URL* @param params 请求的参数集合* @return远程资源的响应结果*/@SuppressWarnings("unused")private String sendPost(String url, Map<String, String> params) {OutputStreamWriter out = null;BufferedReader in = null;StringBuilder result = new StringBuilder();try {URL realUrl = new URL(url);HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection();// 发送POST请求必须设置如下两行conn.setDoOutput(true);conn.setDoInput(true);// POST方法conn.setRequestMethod("POST");// 设置通用的请求属性conn.setRequestProperty("accept", "*/*");conn.setRequestProperty("connection", "Keep-Alive");conn.setRequestProperty("user-agent","Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");conn.setRequestProperty("Content-Type", "application/x-www-form-urlenco ded");conn.connect();// 获取URLConnection对象对应的输出流out = new OutputStreamWriter(conn.getOutputStream(), "UTF-8");if (params != null) {StringBuilder param = new StringBuilder();for (Map.Entry<String, String> entry : params.entrySet()) {if(param.length()>0){param.append("&");}param.append(entry.getKey());param.append("=");param.append(entry.getValue());}out.write(param.toString());}// flush输出流的缓冲out.flush();// 定义BufferedReader输入流来读取URL的响应in = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8")); String line;while ((line = in.readLine()) != null) {result.append(line);}} catch (Exception e) {e.printStackTrace();}//使用finally块来关闭输出流、输入流finally{try{if(out!=null){out.close();}if(in!=null){in.close();}catch(IOException ex){ex.printStackTrace();}}return result.toString();}private static char[] base64EncodeChars = new char[] { 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H','I', 'J', 'K', 'L', 'M', 'N', 'O', 'P','Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X','Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f','g', 'h', 'i', 'j', 'k', 'l', 'm', 'n','o', 'p', 'q', 'r', 's', 't', 'u', 'v','w', 'x', 'y', 'z', '0', '1', '2', '3','4', '5', '6', '7', '8', '9', '+', '/' };public static String base64Encode(byte[] data) {StringBuffer sb = new StringBuffer();int len = data.length;int i = 0;int b1, b2, b3;while (i < len) {b1 = data[i++] & 0xff;if (i == len){sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[(b1 & 0x3) << 4]); sb.append("==");break;}b2 = data[i++] & 0xff;if (i == len){sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[(b2 & 0x0f) << 2]);sb.append("=");break;}b3 = data[i++] & 0xff;sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]); sb.append(base64EncodeChars[((b2 & 0x0f) << 2) | ((b3 & 0xc0) >>> 6)]); sb.append(base64EncodeChars[b3 & 0x3f]);}return sb.toString();}}其他Api接口，请转到快递鸟具体查看相关文档。

快递鸟电子面单接口说明文档快递鸟2017-04-25版本一、前言1、业务背景随着电子商务和物流信息化服务的迅猛发展，电子面单已经成为了商家快速发货并连接订单与物流的有力工具。

快递鸟电子面单接口是快递鸟提供给独立电商、仓储管理系统、打单软件、物流供应链等物流系统平台使用的物流下单接口，满足商家在线发货需求并提供打印电子面单的服务。

商家通过贵司系统选择物流公司发送请求通知快递公司有快递要发货，贵公司把数据通过此接口转发到快递鸟，由快递鸟为商家通知对应的快递公司快递员上门取件。

电子面单成功下单后，快递鸟系统内将自动订阅，一旦轨迹发生变化时，快递鸟将调用贵司推送接收接口将物流信息反向推送至商家。

同时若客户使用代收货款服务，快递鸟会将代收货款的货款状态独立推送给商家用户。

电子面单具有如下特点：●打印效率高相比传统针式打印机套打模式，打印速度提升6-8倍，热敏打印机打印速度平均30-40张/分。

●发货效率高包裹出库时减少了抽底单的工序，降低了操作成本、提升操作效率，运单和订单即时绑定，无需人工再次扫描绑定发货。

目前商家在使用电子面单的过程中也存在一些情况导致部分用户无法顺畅使用，例如：●大电商有多家合作快递公司，各家快递公司的模板尺寸不一，需要使用多个打印机打印面单。

●单号作废后回收机制不完善导致电商成本升高。

●二联电子面单无底单，运费核账存在问题（部分商家货物重量以称重为准）。

●打印时发现面单号余额不足，耽误发货。

●小B电商发货量不够申请网点的电子面单服务。

快递鸟电子面单接口为解决客户以上问题，新增如下解决方案：●电子面单余量查询：可通过电子面单余量查询接口查询，并且在快递鸟官网可设置余额不足提醒值（后续会加上余额不足短信/邮件提醒功能）●电子面单取消/回收：可通过电子面单取消接口，回收部分加盟快递公司的面单号。

●通用电子面单模板，含二联、三联模板●快递公司电子面单客户号在线申请●散户模式电子面单：部分快递公司无需申请电子面单客户号即可直接打印电子面单。

快递鸟电子面单使用手册V1.0目录1 服务介绍 (1)2 服务价值 (2)3 准备工作 (2)3.1申请电子面单客户号及单号 (2)3.1.1月结模式申请客户号 (3)3.1.1快递鸟模式直接打印 (9)3.2购买或充值单号 (9)3.3准备热敏打印纸及打印机 (9)4 对接流程 (10)4.1 自营商家对接流程 (10)4.2 系统商，电商平台商家对接流程 (15)5 常见问题 (15)1服务介绍快递鸟电子面单API服务，是指由快递公司通过快递鸟电子面单API，向打单用户提供物流单号，实现种通过热敏纸打印输出纸质物流面单并发货的服务。

现该服务已支持21家快递公司，57个官方承认模板（含隐私快递），有效提高打印速度4-6倍，一次开发即可接入所有支持快递公司。

目前已支持：顺丰（SF）、EMS（EMS）、宅急送（ZJS）、圆通（YTO）、百世快递（HTKY）、中通（ZTO）、韵达（YD）、申通（STO）、德邦（DBL）、优速（UC）、京东（JD）、信丰（XFEX）、全峰（QFKD）、跨越速运（KYSY）、安能小包（ANE）、快捷快递（FAST）、国通（GTO）、天天快递（HHTT）、邮政快递包裹（YZPY）、中铁快运（ZTKY），后续更多的快递公司正在对接中。

EMS电子面单模板展示2服务价值打印速度提升：电子面单是普通纸质面单的4-6倍，平均每单打印只需花费1-2秒钟，高效率的打单大大缓解电商等客户的大批量打单压力，轻松应对大促。

提高发货效率：传统发货模式，操作员需要将已打出的快递单和订单信息匹配后再发货，电子面单不需要把快递单和定单信息逐一匹配操作，在定单信息申请快递单号的时候就已完成了定单匹配；卖家无需再安排人员专门抽取“发货联”，操作效率进一步提升。

3准备工作针对自营商家，以下工作可在对接过程中准备，以便对接完成后即可上线立即使用。

平台及系统商可参考如下流程指导平台用户自行准备。

3.1申请电子面单客户号及单号电子面单客户号即请求打印面单时的用户账号或月结编码或客户编码，不同物流服务商的叫法不同而已。

快递鸟接口(API)技术文档版本名词定义1 前言.............................................. 错误!未定义书签。

2 概述.............................................. 错误!未定义书签。

用户使用流程图............................. 错误!未定义书签。

接口规范及说明............................. 错误!未定义书签。

报文及报文编码............................. 错误!未定义书签。

接入步骤................................... 错误!未定义书签。

接口数据包结构............................. 错误!未定义书签。

JSON 范例.................................. 错误!未定义书签。

流程示意图................................. 错误!未定义书签。

网关地址................................... 错误!未定义书签。

签名说明................................... 错误!未定义书签。

关于签名................................... 错误!未定义书签。

(C#)DataSign签名加密代码.................. 错误!未定义书签。

3 下单.............................................. 错误!未定义书签。

预约取件接口............................... 错误!未定义书签。

接口规则................................... 错误!未定义书签。

快递鸟接口调试平台使用指南版本目录1、前言 (4)2、使用指南 (4)2.1登陆调试平台 (4)2.2即时查询 (6)2.3订阅推送接口 (7)2.3.1订阅接口 (8)2.3.2推送接口 (9)2.3.3推送地址修改 (14)2.4电子面单 (16)2.5单号识别 (19)3、技术支持...................................................................................... 错误！未定义书签。

1、前言快递鸟API旨在为电商、电商平台、物流工具、仓储系统等系统提供专业、稳定、优质的物流服务，为不同的用户量身定做了专业的API 接口服务，供不同的用户各取所需。

接口申请：快递鸟官网注册账号后，在后台获取私有接口秘钥，对接接口并使用。

为了方便用户接入快递鸟接口，我们提供了调试平台供用户使用。

用户可以通过调试平台进行接口测试与校验，以及推送地址自助配置。

本文档就快递鸟调试平台的使用进行详细讲解。

2、使用指南2.1登陆调试平台1、使用快递鸟账户登陆官网：2、点击左侧菜单栏【调试平台】选项3、进入调试平台。

调试平台目前包含：即时查询、订阅推送、电子面单、单号识别等接口调试功能，下面分接口进行使用详解。

2.2即时查询1、点击左侧【即时查询】菜单栏进入即时查询调试界面。

2、在ShipperCode和LogisticCode中填快递公司编码和快递单号，点击【生成】按钮后会自动在【系统级参数报文】和【应用级参数报文(RequestData)】的文本框中生成请求报文。

用户可将调试平台上生成的报文与自己程序生成的报文进行比较，校验程序生成报文是否正确。

4、点击【调用】按钮，提交请求。

【应用级参数报文】文本框中显示的就是快递鸟返回的轨迹信息。

2.3订阅推送接口点击菜单栏【订阅推送】选项进入订阅推送接口调试界面。

该页面包括【订阅】、【推送】两个tab页。

极兔快递单号查询快递鸟API接⼝-极兔速递前⾔看完快递鸟api极兔快递j&t对接教程这篇⽂章,然后把源码复制到你的项⽬上,就能快速完成极兔快递接⼝对接.到达极兔快递官⽹界⾯显⽰的效果，更适合刚⼊门的菜鸟,调⽤快递鸟的极兔快递查询API接⼝，能查询到极兔快递单号从收件、运输，到转运中⼼，派送到签收等各个环节的物流发货状态。

快递鸟api接⼝不区分开发语⾔，⽀持Java，C#，PHP，Python，ObjectC等开发语⾔的程序调⽤。

下⾯具体讲解实现过程.⽬录1.完成前期准备⼯作1.1,去快递鸟官⽹⼀个账号1.2,免费获得⼀个apiKey(接⼝权限验证需要)1.3,完成实名认证流程1.4,订购⼀个免费套餐2.API接⼝2.3,请求⽅式：POST2.4,编码格式(utf-8)：application/x-www-form-urlencoded;charset=utf-82.5,返回类型：JSON2.7,调试⼯具：去调试（使⽤快递鸟账号登录）3.请求参数（Headers）参数名称类型说明必须要求RequestData String请求内容需进⾏URL(utf-8)编码,请求内容JSON格式，须和DataType⼀致必填EBusinessID String⽤户ID，查看⽤户ID和ApiKey必填RequestType String请求指令类型：1002 必填DataSign String签名数据，(Body+ApiKey)进⾏MD5加密，再进⾏Base64编码，最后进⾏URL(utf-8)编码必填DataType String求、返回数据类型：2-json ，默认Json选填4.请求参数（Body）参数名称类型说明必须要求OrderCode String订单编号选填ShipperCode String快递公司编码，极兔速递：JTSD必填LogisticCode String物流运单号必填5.返回参数（Return）参数名称类型说明必须要求EBusinessID String⽤户ID 必填ShipperCode String快递公司编码必填LogisticCode String物流运单号选填Success String成功与否必填Reason String失败原因选填State String物流状态：2-在途中,3-签收,4-问题件必填Traces String时间AcceptTime String必填AcceptStation String描述选填Remark String备注必填6.请求完整报⽂（⽰例）RequestData=%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27JTSD%27%2c%27LogisticCode%27%3a%27jt0000052600488%27%7d&EBusinessID=1264783&RequestType=1002&DataSign=MTYyMDU4NWQ2NmU1ZDI2MDEzNGE5YmVlM2YxYzEzMTM%3d&DataType=27.成功返回报⽂（⽰例）{"LogisticCode": "JT0000052600488","ShipperCode": "JTSD","Traces": [{"AcceptStation": "【芜湖市】【芜湖镜湖⽹点】的邓拥军 178********已取件","AcceptTime": "2020-03-16 16:26:13"},{"AcceptStation": "【芜湖市】【芜湖镜湖⽹点】的邓拥军 178********已取件","AcceptTime": "2020-03-16 16:41:33"},{"AcceptStation": "【芜湖市】【芜湖镜湖⽹点】已收件","AcceptTime": "2020-03-16 17:39:21"},{"AcceptStation": "【芜湖市】快件离开【芜湖镜湖⽹点】已发往【芜湖转运中⼼】","AcceptTime": "2020-03-16 17:40:27"},{"AcceptStation": "【芜湖市】快件到达【芜湖转运中⼼】","AcceptTime": "2020-03-16 19:36:32"},{"AcceptStation": "【芜湖市】快件离开【芜湖转运中⼼】已发往【合肥转运中⼼】","AcceptTime": "2020-03-16 20:47:03"},{"AcceptStation": "【合肥市】快件到达【合肥转运中⼼】","AcceptTime": "2020-03-16 23:40:10"},{"AcceptStation": "【合肥市】快件离开【合肥转运中⼼】已发往【⼴州花都转运中⼼】","AcceptTime": "2020-03-17 00:10:48"},{"AcceptStation": "【⼴州市】快件到达【⼴州花都转运中⼼】","AcceptTime": "2020-03-17 20:45:00"},{"AcceptStation": "【⼴州市】快件离开【⼴州花都转运中⼼】已发往【深圳宝安转运中⼼】","AcceptTime": "2020-03-18 00:17:55"},{"AcceptStation": "【深圳市】快件到达【深圳宝安转运中⼼】","AcceptTime": "2020-03-18 03:00:17"},{"AcceptStation": "【深圳市】快件离开【深圳宝安转运中⼼】已发往【深圳福⽥⽹点】","AcceptTime": "2020-03-18 04:44:39"},{"AcceptStation": "【深圳市】【深圳福⽥⽹点】的邹俊林 176********正在派件","AcceptTime": "2020-03-18 08:10:09"},{"AcceptStation": "【深圳市】【深圳福⽥⽹点】的赵凯 159********正在派件","AcceptTime": "2020-03-18 09:55:19"},{"AcceptStation": "【深圳市】快件已签收，签收⼈是【代收】，如有疑问请联系：159********，期待再次为您服务", "AcceptTime": "2020-03-18 14:53:54"}],"State": "3","EBusinessID": "1264783","Success": true}8.失败返回报⽂（⽰例）{"LogisticCode": "JT0000052600488","ShipperCode": "JTSD","Traces": [],"State": "0","EBusinessID": "1264783","Reason": "业务错误[没有可⽤套餐]","Success": false}说明：未实名认证，未订购套餐，套餐可⽤查询量已经⽤完都会返回此报⽂信息/9.⽆轨迹返回报⽂（⽰例）{"LogisticCode": "JT0000052600488","ShipperCode": "JTSD","Traces": [],"State": "0","EBusinessID": "1264783","Reason": "暂⽆轨迹信息","Success": true}10.分步讲解（C#版本）10.1，请求数据包结构10.2,C#调⽤代码⽰例//电商IDstring eEBusinessID = "test1617571";//电商加密私钥，快递鸟提供，注意保管，不要泄漏string appKey= "554343b2-7252-439b-b4eb-1af42c8f2175";//请求urlstring reqURL = ":8080/kdniaosandbox/gateway/exterfaceInvoke.json";//请求指令string reqType="1002";//2-jsonstring dataType = "2";//字符编码采⽤UTF-8string charset = "UTF-8";//JSON字符串stringstring jsonStr ="{\"OrderCode\":\"\",\"ShipperCode\":\"JTSD\",\"LogisticCode\":\"JT0000052600488\"}" ;//把(jsonStr+APIKey)进⾏MD5加密string md5Str=MD5(jsonStr + apiKey, charset);//把md5Str 进⾏Base64编码string base64Str=base64(md5Str,charset);//进⾏URL编码 (utf-8)string datasign = HttpUtility.UrlEncode(base64Str, charset);//请求报⽂参数string postStr = "RequestType=reqType&EBusinessID= eEBusinessID&RequestData=jsonStr&DataSign= datasign&DataType=dataType";//通讯协议使⽤Http协议Post请求⽅式返回轨迹数据string post = SendPost(reqURL, postStr);//获取到的post数据就是快递鸟返回的完整报⽂，接下来⾃⼰写⼀个解析json的⽅法就能获取到⾥⾯的字段信息。

快递鸟智选物流接口对接方案1智选物流1.1对接流程1）注册快递鸟接口账号/reg2）在官网登录进入用户管理后台，进行实名认证，开通接口3）技术对接（在线开发文档：/api-subscribe）4、上线1.2JSON请求返回案例1）JSON请求{"MemberID": "123456","WarehouseID": "1","Detail": [{"OrderCode": "12345","OriginalExpCode":"SF","EstimatedShipTime":"2017-02-16 12:13:12""IsCOD": 0,"Sender": {"ProvinceName": "广东省","CityName": "广州","ExpAreaName": "龙岗区","Subdistrict": "布吉街道","Address": "518000"},"Receiver": {"ProvinceName": "广东","CityName": "梅州","ExpAreaName": "丰顺","Subdistrict": "布吉街道","Address": "518000"},"Goods": [{"ProductName": "包","Volume": "","Weight": "1"}]},{"OrderCode": "12346","IsCOD": 0,"Sender": {"ProvinceName": "广东省","CityName": "广州","ExpAreaName": "龙岗区","Subdistrict": "布吉街道","Address": "518000"},"Receiver": {"ProvinceName": "湖南","CityName": "长沙","ExpAreaName": "龙岗区","Subdistrict": "布吉街道","Address": "518000"},"Goods": [{"ProductName": "包","Volume": "","Weight": "1"}]}]}2）JSON返回{"EBusinessID": "1257227", "Success": true, "RecommendDetail": [{"ExpressList": [{"ExpCode": "ZTO","ExpName": "中通速递","LineName": "","Fee": 10.00,"EstimatedDeliveryTime": 44.20,"SpecificDeliveryTime ":"2017-02-12 09:12","IsSupport": "1","RecommendReason": 0,"Remark": ""},{"ExpCode": "ZTO","ExpName": "中通速递","LineName": "","Fee": 10.00,"EstimatedDeliveryTime": 44.20,"IsSupport": "1","RecommendReason": 1,"Remark": ""},{"ExpCode": "JYM","ExpName": "加运美","SpecificDeliveryTime ":"2017-02-12 09:12","LineName": "","EstimatedDeliveryTime": 15.23,"IsSupport": "1","RecommendReason": 2,"Remark": ""}],"OrderCode": "12345"},{"ExpressList": [{"ExpCode": "ZTO","ExpName": "中通速递","SpecificDeliveryTime ":"2017-02-12 09:12","LineName": "","Fee": 16.00,"EstimatedDeliveryTime": 48.26,"IsSupport": "1","RecommendReason": 0,"Remark": ""},{"ExpCode": "ZTO","ExpName": "中通速递","SpecificDeliveryTime ":"2017-02-12 09:12","LineName": "","Fee": 16.00,"EstimatedDeliveryTime": 48.26,"IsSupport": "1","RecommendReason": 1,"Remark": ""},{"ExpCode": "SF","ExpName": "顺丰快递","LineName": "","EstimatedDeliveryTime": 38.33,"IsSupport": "1","RecommendReason": 2,"Remark": ""}],"OrderCode": "12346"}]}1.3Demo1）.NETusing System;using System.Collections.Generic;using System.IO;using System.Linq;using ;using System.Text;using System.Web;namespace KdGoldAPI{public class KdApiExpRecommend{//电商IDprivate string EBusinessID = "请申请";//电商加密私钥，注意保管，不要泄漏private string AppKey = "请申请";//请求url//测试环境private string ReqURL = ":8081/Ebusiness/EbusinessOrderHandle.aspx";//正式环境//private string ReqURL = "/Ebusiness/EbusinessOrderHandle.aspx";/// <summary>/// Json方式智选物流/// </summary>/// <returns></returns>public string getExpRecommendByJson(){string requestData = "{'MemberID':'123456','WarehouseID':'1','Detail':[{'OrderCode':'12345','IsCOD':0,'Sender':{'Provi nceName':'广东省','CityName':'广州','ExpAreaName':'龙岗区','Subdistrict':'布吉街道','Address':'518000'},'Receiver':{'ProvinceName':'广东','CityName':'梅州','ExpAreaName':'丰顺','Subdistrict':'布吉街道','Address':'518000'},'Goods':[{'ProductName':'包','Volume':'','Weight':'1'}]},{'OrderCode':'12346','IsCOD':0,'Sender':{'ProvinceName':'广东省','CityName':'广州','ExpAreaName':'龙岗区','Subdistrict':'布吉街道','Address':'518000'},'Receiver':{'ProvinceName':'湖南','CityName':'长沙','ExpAreaName':'龙岗区','Subdistrict':'布吉街道','Address':'518000'},'Goods':[{'ProductName':'包','Volume':'','Weight':'1'}]}]}";Dictionary<string, string> param = new Dictionary<string, string>();param.Add("RequestData", HttpUtility.UrlEncode(requestData, Encoding.UTF8));param.Add("EBusinessID", EBusinessID);param.Add("RequestType", "2006");string dataSign = encrypt(requestData, AppKey, "UTF-8");param.Add("DataSign", HttpUtility.UrlEncode(dataSign, Encoding.UTF8));param.Add("DataType", "2");string result = sendPost(ReqURL, param);//根据公司业务处理返回的信息......return result;}/// <summary>/// Json方式运费模板导入/// </summary>/// <returns></returns>public string importCostTemplateByJson(){string requestData ="{'MemberID':'123456','Detail':[{'ShipperCode':'YD','SendProvince':'广东','SendCity':'广州','SendExpArea':'天河','ReceiveProvince':'湖南','ReceiveCity':'长沙','ReceiveExpArea':'龙岗','FirstWeight':'1','FirstFee':'8','AdditionalWeight':'1','AdditionalFee':'10','WeightFormula':''},{'Ship perCode':'YD','SendProvince':'广东','SendCity':'广州','SendExpArea':'天河','ReceiveProvince':'湖南','ReceiveCity':'长沙','ReceiveExpArea':'雨花','FirstWeight':'1','FirstFee':'8','AdditionalWeight':'1','AdditionalFee':'10','WeightFormula':'{{w-0}-0.4}*{{{1000-w}-0.4}+1}*4.700+ {{w-1000}-0.6}*[(w-1000)/1000]*4.700）','ShippingType':'1','IntervalList':[{'StartWeight': 1.0,'EndWeight': 2.0, 'Fee': 3.0}]}]}";Dictionary<string, string> param = new Dictionary<string, string>();param.Add("RequestData", HttpUtility.UrlEncode(requestData, Encoding.UTF8));param.Add("EBusinessID", EBusinessID);param.Add("RequestType", "2004");string dataSign = encrypt(requestData, AppKey, "UTF-8");param.Add("DataSign", HttpUtility.UrlEncode(dataSign, Encoding.UTF8));param.Add("DataType", "2");string result = sendPost(ReqURL, param);//根据公司业务处理返回的信息......return result;}/// <summary>/// Post方式提交数据，返回网页的源代码/// </summary>/// <param name="url">发送请求的URL</param>/// <param name="param">请求的参数集合</param>/// <returns>远程资源的响应结果</returns>private string sendPost(string url, Dictionary<string, string> param){string result = "";StringBuilder postData = new StringBuilder();if (param != null && param.Count > 0){foreach (var p in param){if (postData.Length > 0){postData.Append("&");}postData.Append(p.Key);postData.Append("=");postData.Append(p.Value);}}byte[] byteData = Encoding.GetEncoding("UTF-8").GetBytes(postData.ToString());try{HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);request.ContentType = "application/x-www-form-urlencoded";request.Referer = url;request.Accept = "*/*";request.Timeout = 30 * 1000;erAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 2.0.50727; .NET CLR 3.0.04506.648; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729)";request.Method = "POST";request.ContentLength = byteData.Length;Stream stream = request.GetRequestStream();stream.Write(byteData, 0, byteData.Length);stream.Flush();stream.Close();HttpWebResponse response = (HttpWebResponse)request.GetResponse();Stream backStream = response.GetResponseStream();StreamReader sr = new StreamReader(backStream, Encoding.GetEncoding("UTF-8"));result = sr.ReadToEnd();sr.Close();backStream.Close();response.Close();request.Abort();}catch (Exception ex){result = ex.Message;}return result;}///<summary>///电商Sign签名///</summary>///<param name="content">内容</param>///<param name="keyValue">Appkey</param>///<param name="charset">URL编码</param>///<returns>DataSign签名</returns>private 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="str">要加密的字符串</param>///<param name="charset">编码方式</param>///<returns>密文</returns>private string MD5(string str, string charset){byte[] buffer = System.Text.Encoding.GetEncoding(charset).GetBytes(str);try{System.Security.Cryptography.MD5CryptoServiceProvider check;check = new System.Security.Cryptography.MD5CryptoServiceProvider();byte[] somme = puteHash(buffer);string ret = "";foreach (byte a in somme){if (a < 16)ret += "0" + a.ToString("X");elseret += a.ToString("X");}return ret.ToLower();}catch{throw;}}/// <summary>/// base64编码/// </summary>/// <param name="str">内容</param>/// <param name="charset">编码方式</param>/// <returns></returns>private string base64(String str, String charset){returnConvert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));}}}2）JAVAimport java.io.BufferedReader;import java.io.IOException;import java.io.InputStreamReader;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingException;import .HttpURLConnection;import .URL;import .URLEncoder;import java.security.MessageDigest;import java.util.HashMap;import java.util.Map;/****智选物流**/public class KdApiExpRecommend {//DEMOpublic static void main(String[] args) {KdApiExpRecommend api = new KdApiExpRecommend();try {String result = api.getOrderTracesByJson();System.out.print(result);} catch (Exception e) {e.printStackTrace();}}//电商IDprivate String EBusinessID="请申请";//电商加密私钥，注意保管，不要泄漏private String AppKey="请申请";//请求urlprivate String ReqURL="/Ebusiness/EbusinessOrderHandle.aspx";/*** Json方式智选物流* @throws Exception*/public String getExpRecommendByJson() throws Exception{String requestData= "{'MemberID':'123456','WarehouseID':'1','Detail':[{'OrderCode':'12345','IsCOD':0,'Sender':{'Provi nceName':'广东省','CityName':'广州','ExpAreaName':'龙岗区','Subdistrict':'布吉街道','Address':'518000'},'Receiver':{'ProvinceName':'广东','CityName':'梅州','ExpAreaName':'丰顺','Subdistrict':'布吉街道','Address':'518000'},'Goods':[{'ProductName':'包','Volume':'','Weight':'1'}]},{'OrderCode':'12346','IsCOD':0,'Sender':{'ProvinceName':'广东省','CityName':'广州','ExpAreaName':'龙岗区','Subdistrict':'布吉街道','Address':'518000'},'Receiver':{'ProvinceName':'湖南','CityName':'长沙','ExpAreaName':'龙岗区','Subdistrict':'布吉街道','Address':'518000'},'Goods':[{'ProductName':'包','Volume':'','Weight':'1'}]}]}";Map<String, String> params = new HashMap<String, String>();params.put("RequestData", urlEncoder(requestData, "UTF-8"));params.put("EBusinessID", EBusinessID);params.put("RequestType", "2006");String dataSign=encrypt(requestData, AppKey, "UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8"));params.put("DataType", "2");String result=sendPost(ReqURL, params);//根据公司业务处理返回的信息......return result;}/*** Json方式导入运费模板* @throws Exception*/public String importCostTemplateByJson() throws Exception{String requestData="{'MemberID':'123456','Detail':[{'ShipperCode':'YD','SendProvince':'广东','SendCity':'广州','SendExpArea':'天河','ReceiveProvince':'湖南','ReceiveCity':'长沙','ReceiveExpArea':'龙岗','FirstWeight':'1','FirstFee':'8','AdditionalWeight':'1','AdditionalFee':'10','WeightFormula':''},{'Ship perCode':'YD','SendProvince':'广东','SendCity':'广州','SendExpArea':'天河','ReceiveProvince':'湖南','ReceiveCity':'长沙','ReceiveExpArea':'雨花','FirstWeight':'1','FirstFee':'8','AdditionalWeight':'1','AdditionalFee':'10','WeightFormula':'{{w-0}-0.4}*{{{1000-w}-0.4}+1}*4.700+ {{w-1000}-0.6}*[(w-1000)/1000]*4.700）','ShippingType':'1','IntervalList':[{'StartWeight': 1.0,'EndWeight': 2.0, 'Fee': 3.0}]}]}";Map<String, String> params = new HashMap<String, String>();params.put("RequestData", urlEncoder(requestData, "UTF-8"));params.put("EBusinessID", EBusinessID);params.put("RequestType", "2004");String dataSign=encrypt(requestData, AppKey, "UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8"));params.put("DataType", "2");String result=sendPost(ReqURL, params);//根据公司业务处理返回的信息......return result;}/*** MD5加密* @param str 内容* @param charset 编码方式* @throws Exception*/@SuppressWarnings("unused")private String MD5(String str, String charset) throws Exception {MessageDigest md = MessageDigest.getInstance("MD5");md.update(str.getBytes(charset));byte[] result = md.digest();StringBuffer sb = new StringBuffer(32);for (int i = 0; i < result.length; i++) {int val = result[i] & 0xff;if (val <= 0xf) {sb.append("0");}sb.append(Integer.toHexString(val));}return sb.toString().toLowerCase();}/*** base64编码* @param str 内容* @param charset 编码方式* @throws UnsupportedEncodingException*/private String base64(String str, String charset) throws UnsupportedEncodingException{ String encoded = base64Encode(str.getBytes(charset));return encoded;}@SuppressWarnings("unused")private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{ String result = URLEncoder.encode(str, charset);return result;}/*** 电商Sign签名生成* @param content 内容* @param keyValue Appkey* @param charset 编码方式* @throws UnsupportedEncodingException ,Exception* @return DataSign签名*/@SuppressWarnings("unused")private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception{if (keyValue != null){return base64(MD5(content + keyValue, charset), charset);}return base64(MD5(content, charset), charset);}/*** 向指定URL 发送POST方法的请求* @param url 发送请求的URL* @param params 请求的参数集合* @return 远程资源的响应结果*/@SuppressWarnings("unused")private String sendPost(String url, Map<String, String> params) {OutputStreamWriter out = null;BufferedReader in = null;StringBuilder result = new StringBuilder();try {URL realUrl = new URL(url);HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection();// 发送POST请求必须设置如下两行conn.setDoOutput(true);conn.setDoInput(true);// POST方法conn.setRequestMethod("POST");// 设置通用的请求属性conn.setRequestProperty("accept", "*/*");conn.setRequestProperty("connection", "Keep-Alive");conn.setRequestProperty("user-agent","Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");conn.setRequestProperty("Content-Type","application/x-www-form-urlencoded");conn.connect();// 获取URLConnection对象对应的输出流out = new OutputStreamWriter(conn.getOutputStream(), "UTF-8");// 发送请求参数if (params != null) {StringBuilder param = new StringBuilder();for (Map.Entry<String, String> entry : params.entrySet()) {if(param.length()>0){param.append("&");}param.append(entry.getKey());param.append("=");param.append(entry.getValue());//System.out.println(entry.getKey()+":"+entry.getValue());}//System.out.println("param:"+param.toString());out.write(param.toString());}// flush输出流的缓冲out.flush();// 定义BufferedReader输入流来读取URL的响应in = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));String line;while ((line = in.readLine()) != null) {result.append(line);}} catch (Exception e) {e.printStackTrace();}//使用finally块来关闭输出流、输入流finally{try{if(out!=null){out.close();}if(in!=null){in.close();}}catch(IOException ex){ex.printStackTrace();}}return result.toString();}private static char[] base64EncodeChars = new char[] { 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H','I', 'J', 'K', 'L', 'M', 'N', 'O', 'P','Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X','Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f','g', 'h', 'i', 'j', 'k', 'l', 'm', 'n','o', 'p', 'q', 'r', 's', 't', 'u', 'v','w', 'x', 'y', 'z', '0', '1', '2', '3','4', '5', '6', '7', '8', '9', '+', '/' };public static String base64Encode(byte[] data) {StringBuffer sb = new StringBuffer();int len = data.length;int i = 0;int b1, b2, b3;while (i < len) {b1 = data[i++] & 0xff;if (i == len){sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[(b1 & 0x3) << 4]);sb.append("==");break;}b2 = data[i++] & 0xff;if (i == len){sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);sb.append(base64EncodeChars[(b2 & 0x0f) << 2]);sb.append("=");break;}b3 = data[i++] & 0xff;sb.append(base64EncodeChars[b1 >>> 2]);sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);sb.append(base64EncodeChars[((b2 & 0x0f) << 2) | ((b3 & 0xc0) >>> 6)]);sb.append(base64EncodeChars[b3 & 0x3f]);}return sb.toString();}}3）PHP<?php//电商IDdefined('EBusinessID') or define('EBusinessID', '请申请');//电商加密私钥，注意保管，不要泄漏defined('AppKey') or define('AppKey', '请申请');//请求url//测试地址defined('ReqURL') or define('ReqURL', ':8081/Ebusiness/EbusinessOrderHandle.aspx');//正式地址//defined('ReqURL') or define('ReqURL', '/Ebusiness/EbusinessOrderHandle.aspx');//调用获取物流轨迹//-------------------------------------------------------------$logisticResult = getExpRecommendByJson();echo $logisticResult;//-------------------------------------------------------------/*** Json方式智选物流*/function getExpRecommendByJson(){$requestData="{'MemberID':'123456','WarehouseID':'1','Detail':[{'OrderCode':'12345','IsCOD':0,'Sender':{'Provi nceName':'广东省','CityName':'广州','ExpAreaName':'龙岗区','Subdistrict':'布吉街道','Address':'518000'},'Receiver':{'ProvinceName':'广东','CityName':'梅州','ExpAreaName':'丰顺','Subdistrict':'布吉街道','Address':'518000'},'Goods':[{'ProductName':'包','Volume':'','Weight':'1'}]},{'OrderCode':'12346','IsCOD':0,'Sender':{'ProvinceName':'广东省','CityName':'广州','ExpAreaName':'龙岗区','Subdistrict':'布吉街道','Address':'518000'},'Receiver':{'ProvinceName':'湖南','CityName':'长沙','ExpAreaName':'龙岗区','Subdistrict':'布吉街道','Address':'518000'},'Goods':[{'ProductName':'包','Volume':'','Weight':'1'}]}]}";$datas = array('EBusinessID' => EBusinessID,'RequestType' => '2006','RequestData' => urlencode($requestData) ,'DataType' => '2',);$datas['DataSign'] = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);//根据公司业务处理返回的信息......return $result;}/*** Json方式导入运费模板*/function importCostTemplateByJson(){$requestData= "{'MemberID':'123456','Detail':[{'ShipperCode':'YD','SendProvince':'广东','SendCity':'广州','SendExpArea':'天河','ReceiveProvince':'湖南','ReceiveCity':'长沙','ReceiveExpArea':'龙岗','FirstWeight':'1','FirstFee':'8','AdditionalWeight':'1','AdditionalFee':'10','WeightFormula':''},{'Ship perCode':'YD','SendProvince':'广东','SendCity':'广州','SendExpArea':'天河','ReceiveProvince':'湖南','ReceiveCity':'长沙','ReceiveExpArea':'雨花','FirstWeight':'1','FirstFee':'8','AdditionalWeight':'1','AdditionalFee':'10','WeightFormula':'{{w-0}-0.4}*{{{1000-w}-0.4}+1}*4.700+ {{w-1000}-0.6}*[(w-1000)/1000]*4.700）','ShippingType':'1','IntervalList':[{'StartWeight': 1.0,'EndWeight': 2.0, 'Fee': 3.0}]}]}";$datas = array('EBusinessID' => EBusinessID,'RequestType' => '2004','RequestData' => urlencode($requestData) ,'DataType' => '2',);$datas['DataSign'] = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);//根据公司业务处理返回的信息......return $result;}/*** post提交数据* @param string $url 请求Url* @param array $datas 提交的数据* @return url响应返回的html*/function sendPost($url, $datas) {$temps = array();foreach ($datas as $key => $value) {$temps[] = sprintf('%s=%s', $key, $value);}$post_data = implode('&', $temps);$url_info = parse_url($url);if(empty($url_info['port'])){$url_info['port']=80;}$httpheader = "POST " . $url_info['path'] . " HTTP/1.0\r\n";$httpheader.= "Host:" . $url_info['host'] . "\r\n";$httpheader.= "Content-Type:application/x-www-form-urlencoded\r\n";$httpheader.= "Content-Length:" . strlen($post_data) . "\r\n";$httpheader.= "Connection:close\r\n\r\n";$httpheader.= $post_data;$fd = fsockopen($url_info['host'], $url_info['port']);fwrite($fd, $httpheader);$gets = "";$headerFlag = true;while (!feof($fd)) {if (($header = @fgets($fd)) && ($header == "\r\n" || $header == "\n")) { break;}}while (!feof($fd)) {$gets.= fread($fd, 128);}fclose($fd);return $gets;}/*** 电商Sign签名生成* @param data 内容* @param appkey Appkey* @return DataSign签名*/function encrypt($data, $appkey) {return urlencode(base64_encode(md5($data.$appkey)));}?>2运费模板导入接口2.1功能说明ERP服务商也可以将用户的协议物流公司及其协议价格先保存到接口运费模板系统中，智选物流每次计算时：若接口传递了协议公司和价格，那么默认按照接口提供的数据进行计算；若接口没有提供数据，则获取以保存的运费模板进行计算。

快递鸟接口(API)技术文档1前言 (5)2接口规范说明 (5)2.1接口规范及说明 (5)2.1.1报文及报文编码 (5)2.1.2接口数据包结构 (5)2.1.3JSON示例 (6)2.1.4系统级参数 (6)2.1.5流程示意图 (7)2.2签名说明 (7)2.2.1关于签名 (7)2.2.2(C#)DataSign签名加密代码 (9)3下单类接口 (10)3.1接入步骤 (10)3.2预约取件接口 (11)3.2.1功能说明 (11)3.2.2基本信息 (11)3.2.3接口规则 (12)3.2.4支持情况 (12)3.2.5应用级参数 (12)3.2.6返回参数 (17)3.3预约取件取消接口 (17)3.3.1功能说明 (17)3.3.2基本信息 (17)3.3.3接口规则 (18)3.3.4支持情况 (18)3.3.5应用场景 (18)3.3.6应用级参数 (18)3.3.7返回参数 (19)3.4电子面单接口 (19)3.4.1功能说明 (19)3.4.2基本信息 (19)3.4.3应用场景 (20)3.4.4接口规则 (20)3.4.6应用场景 (21)3.4.7应用级参数 (21)3.4.8返回参数 (30)3.5电子面单取消接口 (35)3.5.1功能说明 (35)3.5.2基本信息 (36)3.5.3接口规则 (36)3.5.4支持情况 (36)3.5.5应用级参数 (36)3.5.6返回参数 (37)3.6电子面单追加子单接口 (37)3.6.1功能说明 (37)3.6.2基本信息 (37)3.6.3应用级参数 (38)3.6.4返回参数 (38)3.7获取电子面单文件接口 (39)3.7.1功能说明 (39)3.7.2基本信息 (39)3.7.3应用级参数 (39)3.7.4返回参数 (40)4轨迹查询类接口 (42)4.1即时查询接口 (42)4.1.1功能说明 (42)4.1.2基本信息 (42)4.1.3接口规则 (42)4.1.4支持情况 (42)4.1.5应用场景 (42)4.1.6应用级参数 (42)4.1.7返回参数 (43)4.2物流跟踪 (45)4.2.1轨迹订阅接口 (45)4.3单号识别接口 (64)4.3.1功能说明 (64)4.3.2基本信息 (64)4.3.3接口规则 (64)4.3.4应用级参数 (64)4.3.5返回参数 (65)5增值类接口 (66)5.1在途监控-国内版 (66)5.1.1即时查询接口(增值版) (66)5.1.2物流跟踪接口(增值版) (72)5.2快递查询接口 (78)5.2.1功能说明 (78)5.2.2基本信息 (78)5.2.3接口规则 (78)5.2.4支持情况 (78)5.2.5应用场景 (78)5.2.6应用级参数 (78)5.2.7返回参数 (79)5.3在途监控-国际版 (84)5.3.1物流跟踪接口(国际版) (84)5.4物流查询地图接口 (86)5.4.1即时查询接口(地图版) (87)5.4.2物流跟踪接口(地图版) (95)5.5短信服务 (100)5.5.1短信模板接口 (101)5.5.2短信发送接口 (103)5.5.3短信黑名单接口 (105)5.6智能地址解析接口 (106)5.6.1功能说明 (106)5.6.2基本信息 (106)5.6.3应用级参数 (106)5.6.4返回参数 (107)6附录 (109)6.1对接相关资料 (109)6.2电子面单模板规格 (109)6.3返回编码列表 (116)7技术支持 (117)1前言快递鸟API旨在为电商、电商平台、物流工具、打单工具、仓储系统、移动APP等系统提供专业、稳定、优质的API接口服务，满足不同用户的物流管理需求。