站长答疑:(张先生) | 手机:18616712339 | 在线QQ: | . |
|
钮门快递软件 >> 常见问题 GInfo.dll的DoApi接口 | GINFO接口的PDF标签获取 | 其他下家接口的PDF标签通过EMMIS系统文件共享中心获取的标准通用接口调用格式 | 其他下家接口通用调取下家转单PDF标签
一、总概
1.1、通讯协议遵循 HTTP (1.0/1.1) 1.2、数据包装采用JSON,遵循RFC4627 非ASCII字符编码:UTF-8 (65001) 或者 \u转义 *特别提示,共有8个ASCII码采用x编码转义: "(双引号) = \x22 \(反斜杠) = \x5C /(斜杠) = \x2F (换行符) = \x0A (回车符) = \x0D (制表符) = \x09 (罕用) (退格符) = \x08 (极罕用) (换页符) = \x0C (极罕用) *POST数据,遵循上述编码规则,建议不进行URL_Encode(定义URL_ENCODE=1,强制URL_ENCODE) 1.3、接口API为:“/cgi-bin/GInfo.dll?DoApi” 1.4、接口请求方式为:POST 1.5、安全控制,MD5数字签名,绑定客户ID、客户密钥,通过与时间戳生成摘要码验证。 MD5:数字签名,=MD5(icID+TimeStamp+客户密钥) *比如客户密钥为“1234ABCD”,如上例程为:MD5("7914055344211231234ABCD")="306f241be2d5963f20be2966f9961f55" 【3.4.1、sGetLabel】 3.4.1、请求: {"RequestName":"sGetLabel","icID":1193,"TimeStamp":1504208184000,"MD5":"e319155c729acc8410350510c353cbbf","iNoType":1,"cModelName":"EMS10_10","aNo":["EM123456780CN","EM123456781CN"]} 3.4.1.1、字段名解释 iTable:记录查询源选择,默认0。(0:正式快递业务记录;1:预录单记录) iNoType:运单号类别,默认0。(0:内单号;1:转单号) cModelName:PDF模板名称,1-30字节,必须。可以通过GInfo接口[/cgi-bin/GInfo.dll?ajxEmsQueryPDFLabel&r=0.123456]查询可用的模板名称 aNo:运单号数组,1-20个运单号字串,每个运单号7-30字节 ***e邮宝,澳邮标签批量生成,确认为同一帐号下记录(转单号),使用固定模板名称: 1、“EUB_A4_PDF_BATCH”:EUBA4纸张输出 2、“EUB_44_PDF_BATCH”:EUB4*4标签输出 3、“AUPX_A4_PDF_BATCH”:澳邮A4纸张输出 4、“AUPX_44_PDF_BATCH”:澳邮标签输出 5、“FILE_STORE_PDF”:单个标签输出,EMMis文件共享中心下载保存的级别为"119"的pdf标签文件 如果成功,ReturnValue为1,将会在cMess中输出文件下载的URL 形如:{"ReturnValue":1,"cMess":"http://www.ems.cn/xxx/fe783ff83c354113877ffcc82daff421.pdf"} 3.4.2、响应: 1,成功:PDF文件数据,可判断PDF文件类型"Content-Type: application/pdf"或者字节大小,比如大于1000字节,或者PDF的BOM 2,失败:返回JSON,形如{"ReturnValue":0,"cMess":"没有符合条件的记录"} *判断ReturnValue,查看cMess 【测试连接:】 查询PDF模版名称:http://网址/cgi-bin/GInfo.dll?ajxEmsQueryPDFLabel&r=0.2433155 获取自定义PDF标签: http://网址/cgi-bin/GInfo.dll?DoApi&{"RequestName":"sGetLabel","icID":1193,"TimeStamp":1504208184000,"MD5":"e319155c729acc8410350510c353cbbf","iNoType":1,"iTable":0,"cModelName":"A4纸标准面单-1页2份","aNo":"1059835883"} EUB/ETK等标签获取: http://网址/cgi-bin/GInfo.dll?DoApi&{"RequestName":"sGetLabel","icID":1,"TimeStamp":1508267180000,"MD5":"089ed46b4ff01ab171747b28df77c286","iNoType":1,"iTable":0,"cModelName":"EUB_A4_PDF_BATCH","aNo":"EV887416346CN"} 邮政小包标签获取【或者其他下家接口的PDF标签通过EMMIS系统文件共享中心获取的标准通用接口调用格式】: http://网址/cgi-bin/GInfo.dll?DoApi&{"RequestName":"sGetLabel","icID":1,"TimeStamp":1507837417000,"MD5":"b67dbca61cfadc49a94f2162273844ea","iNoType":1,"iTable":0,"cModelName":"FILE_STORE_PDF","aNo":"小包单号"} 钮门快递软件|EMMIS[2018.11.13-18:12]编辑:钮门快递软件|EMMIS 访问:2280
|
|
关于本网站
|
... |
物流查询工具
|
网站快速通道
|
其他服务与支持
|