顺丰物流轨迹推送服务接口Java文档

为客户开发的顺丰物流轨迹推送服务接口是开放的API接口,主要用来接收顺丰快递推送的订单状态。

快递鸟在途监控汇集国内外1600多家快递公司的物流轨迹数据,以接口形式开放给用户使用,支持即时查询+订阅两种调用方式,为用户提供全流程的物流状态查询服务(包括已揽收、在途中、到达派件城市、派件中、已签收等20多种物流节点状态)。

顺丰物流轨迹推送服务接口在线调试时,您的测试地址需先通过“IT技术支持”发给开发人员,待开通白名单后再测试,生产地址如下流程:

通过客户提供的url地址实时推送物流状态,仅支持form表单的提交方式。具体可在开放平台联调界面测试。

1.接口参数结构 

 

2.请求参数列表

 

​3.返回参数列表

4.请求格式举例-logistics_interface字段内容

接单(针对需要上门揽收服务的订单)

 

揽收(已收件)

 

<
Java中调用顺丰路由推送接口通常需要以下几个步骤: 1. **注册并获取API密钥**:首先,你需要在顺丰官方开发者平台上注册账号,申请相应的服务权限,并获得API Key、Secret Key等身份凭证。 2. **添加依赖库**:在项目中引入顺丰物流的SDK,这通常是通过Maven或Gradle等包管理工具。例如,你可以使用`com.sf.netapi`的包名。 ```xml <!-- Maven --> <dependency> <groupId>com.sf</groupId> <artifactId>sfnetapi-sdk</artifactId> <version>最新版本号</version> </dependency> // Gradle implementation 'com.sf:sfnetapi-sdk:最新版本号' ``` 3. **初始化客户端**:使用获取到的API Key和Secret Key初始化顺丰物流客户端。 ```java SfnetApiClient client = new SfnetApiClient(); client.setApiKey("your_api_key"); client.setAppKey("your_app_key"); client.setEncrypt(true); // 如果涉及敏感信息,开启加密 ``` 4. **构建请求**:根据需求选择合适的路由推送服务,比如`RoutePushService`,然后创建一个请求对象,设置必要的参数如起始点、终点、货物信息等。 5. **发送请求和处理响应**:调用`client.send()`方法发起请求,返回的是一个Future对象,可以使用`get()`方法等待结果。响应通常包含路由建议和状态码,可以根据文档解析响应内容。 ```java RoutePushRequest request = new RoutePushRequest(); // 设置请求参数... try { RoutePushResponse response = client.send(request).get(); if (response.isSuccess()) { // 处理成功响应 } else { // 处理错误 } } catch (InterruptedException | ExecutionException e) { e.printStackTrace(); } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值