查物流快递信息
用户使用快递单号及快递公司编码，可同步查询单号物流轨迹。
使用HTTP的get或post请求，以普通表单提交方式，编码：Content-Type=application/x-www-form-urlencoded发送数据，同步阻塞式调用。其流程图如下所示：
图流程图
为什么要用按单查询？
1单在30天内只计费一次，可任意查询。概念清晰，性价比高，便于用户管理成本。
查物流快递信息
#http头
host: //易源推送服务器地址，会改变
content-type:application/x-www-form-urlencoded;charset=utf-8
content-length:697
user-agent:lua-resty-http/ (Lua) ngx_lua/10013
#http body
result=%7B%22queryTimes%22%3A1%2C%22upgrade_info%22%3A%22%22%2C%22fee_num%22%3A0%2C%22status%22%3A2%2C%22expSpellName%22%3A%22huitong%22%2C%22msg%22%3A%22%E6%9F%A5%E8%AF%A2%E6%88%90%E5%8A%9F%22%2C%22updateStr%22%3A%222020-11-02%2010%3A47%3A37%22%2C%22outCode%22%3A%22%22%2C%22flag%22%3Atrue%2C%22tel%22%3A%2295320%22%2C%22ret_code%22%3A0%2C%22logo%22%3A%22http%3A%2F%(%E5%8E%9F%E6%B1%87%E9%80%9A)%22%2C%22data%22%3A%5B%7B%22context%22%3A%22%E3%80%90%E4%B9%89%E4%B9%8C%E8%BD%AC%E8%BF%90%E4%B8%AD%E5%BF%83%E3%80%91%EF%BC%8C%E6%AD%A3%E5%8F%91%E5%BE%80%E3%80%90%E5%A4%A9%E6%B4%A5%E8%BD%AC%E8%BF%90%E4%B8%AD%E5%BF%83%E3%80%91%22%2C%22time%22%3A%222020-11-01%2022%3A57%3A19%22%7D%2C%7B%22context%22%3A%22%E5%88%B0%E3%80%90%E4%B9%89%E4%B9%8C%E8%BD%AC%E8%BF%90%E4%B8%AD%E5%BF%83%E3%80%91%22%2C%22time%22%3A%222020-11-01%2022%3A55%3A13%22%7D%2C%7B%22context%22%3A%22%E3%80%90%E5%85%B0%E6%BA%AA%E3%80%91%EF%BC%8C%E6%AD%A3%E5%8F%91%E5%BE%80%E3%80%90%E9%87%91%E5%8D%8E%E8%BD%AC%E8%BF%90%E4%B8%AD%E5%BF%83%E3%80%91%22%2C%22time%22%3A%222020-11-01%2017%3A56%3A19%22%7D%2C%7B%22context%22%3A%22%E5%88%B0%E3%80%90%E5%85%B0%E6%BA%AA%E9%9B%86%E8%B4%A7%E7%82%B9%E3%80%91%22%2C%22time%22%3A%222020-11-01%2017%3A42%3A28%22%7D%2C%7B%22context%22%3A%22%E3%80%90%E4%B9%89%E4%B9%8C%E9%BE%9A%E5%A4%A7%E5%A1%98%E5%88%86%E9%83%A8-%E4%BC%98%E8%B4%A8%E5%AE%A2%E6%88%B7%E3%80%91%EF%BC%8C%E3%80%90%E5%BC%A0%E6%9F%B3%E5%A9%B7%2F15658902667%E3%80%91%E5%B7%B2%E6%8F%BD%E6%94%B6%22%2C%22time%22%3A%222020-11-01%2017%3A08%3A49%22%7D%5D%2C%22mailNo%22%3A%22557030343293696%22%2C%22possibleExpList%22%3A%5B%5D%2C%22dataSize%22%3A5%2C%22update%22%3A1604285257608%7D
可查询易源支持的1500+家快递公司列表。
http[s]:_appid=替换自己的值&showapi_sign=替换自己的值
Json
新增一个快递时，将会更新一次
以下是JAVA代码示例:
//更多说明请访问仓库地址：_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到
String res=new ShowApiRequest(__,_showapi_appid_,_showapi_sign_)
.addTextPara(_expName_,_风_)
.addTextPara(_maxSize_,__)
.addTextPara(_page_,__)
.post();
(res);
_showapi_res_error_: __,
_showapi_res_code_: 0,
_showapi_res_id_: __,
_showapi_res_body_: {
_ret_code_: 0,
_express_list_: [
{
_img_url_: __,
_phone_: _95338_,
_exp_name_: _顺丰速运_,
_com_: _shunfeng_,
_url_: __,
_note_: __
}
],
_msg_: _查询成功!_
}
}
通过单号推测其所属的快递公司列表,以可能性大小逆序排序
http[s]:_appid=替换自己的值&showapi_sign=替换自己的值
Json
立即返回结果数据未做缓存，返回的是最新实时数据
以下是JAVA代码示例:
//更多说明请访问仓库地址：_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到
String res=new ShowApiRequest(__,_showapi_appid_,_showapi_sign_)
.addTextPara(_nu_,_SF1163287169821_)
.addTextPara(_addOther_,_1_)
.post();
(res);
_showapi_res_code_: 0,
_showapi_res_error_: __,
_showapi_res_id_:__,
_showapi_res_body_: {
_ret_code_: 0,
_data_: [
{
_simpleName_: _zhongtong_,
_expName_: _中通快递_
},
{
_simpleName_: _shunfeng_,
_expName_: _顺丰速运_
}
],
_msg_: _操作成功!_
}
快递单有更新时，易源主动将全量物流轨迹以POST请求到此URL。本接入点负责设置/修改此URL
http[s]:_appid=替换自己的值&showapi_sign=替换自己的值
Json
立即返回结果数据未做缓存，返回的是最新实时数据
以下是JAVA代码示例:
//更多说明请访问仓库地址：_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到
String res=new ShowApiRequest(__,_showapi_appid_,_showapi_sign_)
.addTextPara(_callBackUrl_,__)
.post();
(res);
{
_showapi_res_error_: __,
_showapi_res_id_: __,
_showapi_res_code_: 0,
_showapi_res_body_: {
_ret_code_: 0,
_updateTime_: _1561711425361_,
_showapi_fee_code_: 0,
_callback_method_: _get_,
_callback_url_: __,
_updateTimeStr_: _2019-06-28 16:43:_,
_msg_: _成功_
}
查物流快递信息
批量提交快递单号（每次最多提交100单），如果此单物流轨迹有更新，则易源会将物流结果推送至用户定义的回调URL（此URL由_【工具】设置推送回调地址_接入点来设定），直至签收结束。
由于是异步操作，易源加入了多次重试、容错切换等机制，可以大大避免快递查询高峰带来的业务抖动，提高查询成功率。
更多帮助请查看
推送时，您的服务器需要返回：
返回状态码=200
2.返回体为{_success_:true} 或 success 确认收信成功。
http[s]:_appid=替换自己的值&showapi_sign=替换自己的值
json
每个快递被揽收完成，录入相应的快递公司后，官网即可查询到物流信息
json
以下是JAVA代码示例:
//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到
String res=new ShowApiRequest(__,_showapi_appid_,_showapi_sign_)
.addTextPara(_com_nu_,__)
.post();
(res);
查物流快递信息
比如您在提交查询时，传入outCode=myOrderId123456,那么易源在推送结果到回调URL时，会带上outCode=myOrderId123456给您，便于您做单号对应。 outCode是一个< 200长度的串（也可以是json的string格式），易源回推时将原封返回。
易源在回推单号物流时，会将您提交的outCode值一并提交过来，便于您标识单号身份。
