快递物流接口文档_电子面单接口文档_快递100api接口文档
#快递100配置
express:
url: https://poll.kuaidi100.com/poll/query.do
mapUrl: https://poll.kuaidi100.com/poll/maptrack.do
key: xxxxxxxx
customer: xxxxxxxxxxxxxxxxxxxxxxxx
/**
* 快递100查询
*
* @author: cyl
* @date: 2022-07-03 09:59
*/
@Slf4j
public class ExpressUtil {
@Value("${express.url}")
private static String URL;
@Value("${express.mapUrl}")
private static String MAP_URL;
@Value("${express.key}")
private static String KEY;
@Value("${express.customer}")
private static String CUSTOMER;
private static final String SUCCESS_STATUS = "200";
/**
* 查询实时快递
*
* @param expressNo 快递单号
* @param expressCompanyNo 快递公司编码
* @param mobile 收、寄件人的电话号码
* @return
*/
public static JSONArray queryExpress(String expressNo, String expressCompanyNo, String mobile) {
JSONObject param = new JSONObject();
param.put("com", expressCompanyNo);
param.put("num", expressNo);
param.put("phone", mobile);
String sign = SecureUtil.md5(param.toJSONString() + KEY + CUSTOMER).toUpperCase();
Map<String, Object> map = Maps.newHashMap();
map.put("customer", CUSTOMER);
map.put("sign", sign);
map.put("param", param.toJSONString());
String result = HttpRequest.post(URL)
.header("Content-Type", "application/x-www-form-urlencoded")
.timeout(20000)
.form(map)
.execute()
.body();
JSONObject jsonObject = JSONObject.parseObject(result);
String status = jsonObject.getString("status");
if (StrUtil.isBlank(status) || !SUCCESS_STATUS.equals(status)) {
log.error("快递100查询异常:{}", result);
return new JSONArray();
}
return jsonObject.getJSONArray("data");
}
/**
* 查询地图轨迹
*
* @param expressNo 快递单号
* @param expressCompanyNo 快递公司编码
* @param from 出发地信息,最小颗粒到市级,例如:广东省深圳市
* @param to 目的地信息,最小颗粒到市级,例如:广东省深圳市
* @return
*/
public static JSONArray queryExpressMap(String expressNo, String expressCompanyNo, String from, String to) {
JSONObject param = new JSONObject();
param.put("com", expressCompanyNo);
param.put("num", expressNo);
param.put("from", from);
param.put("to", to);
String sign = SecureUtil.md5(param.toJSONString() + KEY + CUSTOMER).toUpperCase();
Map<String, Object> map = Maps.newHashMap();
map.put("customer", CUSTOMER);
map.put("sign", sign);
map.put("param", param.toJSONString());
String result = HttpRequest.post(MAP_URL)
.header("Content-Type", "application/x-www-form-urlencoded")
.timeout(20000)
.form(map)
.execute()
.body();
JSONObject jsonObject = JSONObject.parseObject(result);
String status = jsonObject.getString("status");
if (StrUtil.isBlank(status) || !SUCCESS_STATUS.equals(status)) {
log.error("快递100查询异常:{}", result);
return new JSONArray();
}
return jsonObject.getJSONArray("data");
}
}