最新消息: USBMI致力于为网友们分享Windows、安卓、IOS等主流手机系统相关的资讯以及评测、同时提供相关教程、应用、软件下载等服务。

物流快递商家寄件运力查询接口API代码实例

IT圈 admin 6浏览 0评论

物流快递商家寄件运力查询接口API代码实例

一、 商家寄件运力接口

查询全国快递公司运力覆盖情况。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

.do

请求参数:

参数名是否必填类型说明
methodstring业务类型(默认:querymkt)
keystring授权码,请到快递100页面申请企业版接口获取
signstring32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号 secret可在企业管理后台查看
tstring时间戳如:1576123932000
paramparam由其他字段拼接

param数据结构:

参数名是否必填类型说明
sendAddrstring寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10

1.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
provincestring
citystring
districtstring
addrstring地址
latitudestring经度
longitudestring纬度
mktInfomktInfo覆盖运力快递公司列表

mktInfo数据结构

字段类型说明备注
serviceTypestring业务服务类型
mktIdstring内部属性忽略
kuaidiComstring支持的快递公司编码
bigCustPriceDOListstring内部属性忽略

1.4 提供数据内容

{"data": {"province": "广东","city": "深圳市","district": "南山区","latitude": "22.465335763306832","mktInfo": [{"serviceType": ["快递包裹"],"mktId": 98959397,"kuaidiCom": "youzhengguonei","bigCustPriceDOList": null},{"serviceType": null,"mktId": 98959397,"kuaidiCom": "zhaijisong","bigCustPriceDOList": null}],"addr": "海运大厦","longitude": "113.88346197876328"},"message": "成功","result": true,"returnCode": "200"
} 

1.5 信息代码含义

信息代码信息内容描述原因及建议处理方式
200提交成功提交成功
201无法获取运力该地址没有快递公司运力,需联系快递100工作人员添加
400参数错误请根据技术文档请求,注意参数类型及是否必填。
400非法IP请联系快递100工作人员添加白名单
500服务器错误快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误
500没法识别到寄件地址/地址缺失市区/地址缺失区信息/没有填入寄件人地址地址错误,请填写完整的地址信息
503签名认证失败请检查加密方式,param + t + key + secret 的顺序进行MD5加密,加密后字符串转大写,不用加上“+”号
600您不是合法的用户(即授权Key出错)账号无可用单量,需要充值
601KEY已过期账号无可用单量,需要充值

物流快递商家寄件运力查询接口API代码实例

一、 商家寄件运力接口

查询全国快递公司运力覆盖情况。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

.do

请求参数:

参数名是否必填类型说明
methodstring业务类型(默认:querymkt)
keystring授权码,请到快递100页面申请企业版接口获取
signstring32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号 secret可在企业管理后台查看
tstring时间戳如:1576123932000
paramparam由其他字段拼接

param数据结构:

参数名是否必填类型说明
sendAddrstring寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10

1.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
provincestring
citystring
districtstring
addrstring地址
latitudestring经度
longitudestring纬度
mktInfomktInfo覆盖运力快递公司列表

mktInfo数据结构

字段类型说明备注
serviceTypestring业务服务类型
mktIdstring内部属性忽略
kuaidiComstring支持的快递公司编码
bigCustPriceDOListstring内部属性忽略

1.4 提供数据内容

{"data": {"province": "广东","city": "深圳市","district": "南山区","latitude": "22.465335763306832","mktInfo": [{"serviceType": ["快递包裹"],"mktId": 98959397,"kuaidiCom": "youzhengguonei","bigCustPriceDOList": null},{"serviceType": null,"mktId": 98959397,"kuaidiCom": "zhaijisong","bigCustPriceDOList": null}],"addr": "海运大厦","longitude": "113.88346197876328"},"message": "成功","result": true,"returnCode": "200"
} 

1.5 信息代码含义

信息代码信息内容描述原因及建议处理方式
200提交成功提交成功
201无法获取运力该地址没有快递公司运力,需联系快递100工作人员添加
400参数错误请根据技术文档请求,注意参数类型及是否必填。
400非法IP请联系快递100工作人员添加白名单
500服务器错误快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误
500没法识别到寄件地址/地址缺失市区/地址缺失区信息/没有填入寄件人地址地址错误,请填写完整的地址信息
503签名认证失败请检查加密方式,param + t + key + secret 的顺序进行MD5加密,加密后字符串转大写,不用加上“+”号
600您不是合法的用户(即授权Key出错)账号无可用单量,需要充值
601KEY已过期账号无可用单量,需要充值
发布评论

评论列表 (0)

  1. 暂无评论