首页 > 解决方案 > 快递到车

快递到车

.业务背景

快递到车服务为京东与车企尝试的一种新的无人收货配送方式:通过车辆定位服务,授权的快递员可以在无钥匙的状态下打开汽车后备箱,并将包裹直接装车。

快递到车服务实施至少需要商流、物流公司、汽车企业3家公司配合,依托车联网技术,打通多个系统平台、服务场景的界限,进行深度融合才能落地。京东物流拥有电商、物流一体化的优势,实施快递到车更有保障!

本研发文档帮助车企研发团队实现车企APP端内用户将车企账户通过京东宙斯京东互联服务实现与京东账户关联绑定的操作,车企用户在车企APP内通过唤起京东APP一键登录授权车企APP的标准OAuth2.0流程,即可完成该京东用户使用京东账户授权车企APP获取用户信息并完成账户绑定的业务流程。


.接入规则

入驻标准:

1.完成京东账户注册;

2.公司身份;

3.京东账户资质认证;

4.行业资质;


接入规范:

同一个标签每个用户默认只能创建1个应用,需合理创建应用;


运营规范

1.应用创建超过3个月未上线成功,此应用将被删除;

2.上线成功后3个月无调用量,应用将被删除;


快递到车应用的接口数据权限

序号

API功能

API名称

1

查询用户UID

jingdong.uidbypin.query

2

获取用户昵称

jingdong.user.getUserInfoByOpenId

3

获取订单列表

jingdong.OrderCenterJsfExport.getOrderList

4

修改车企标签

jingdong.user.updateNioFlag

5

获取车企标签

jingdong.user.getFlagInfo


      宙斯授权开发请参照以下文档

      https://open.jd.com/home/home#/doc/common?listId=717

      

      唤起京东APP一键授权登录车企APP请参照以下文档

      https://open.jd.com/home/home#/doc/common?listId=808


.接入流程

1.入驻宙斯开发者

京东账号登录jos.jd.com


填写开发者信息、校验手机与邮箱,注册成为宙斯开发者

完成入驻成为宙斯开发者


2.创建快递到车应用

在控制台点击应用管理进入

点击创建应用卡片


选择京东物流下的快递到车类型点击创建应用;

创建该类型应用的用户需要提前联系京东负责快递到车业务负责同事给宙斯运营同事发送快递到车应用创建申请邮件(需确认申请人京东账户PIN),只有邮件申请过的用户才可以创建该类型应用。


3.开发测试

应用创建申请通过后生成APPKEY即可开始接口联调;


4.上线运行

测试状态应用每日接口调用量限制在5000次,完成开发的应用点击发布应用后应用可以完成上线操作,上线后应用切换为上线状态流控,接口调用量变为每日30万次。



名词解释:

三方应用:一般指工具服务提供商,例如ERP提供商、WMS提供商;

开放平台:京东实现的一套用户京东与外部系统做数据交换的系统;

宙斯网关:京东实现的一套系统,用于官方在网关上开放接口,三方通过网关获取数据;

SPI云网关:京东实现了一套系统,用于京东的系统滴啊用三方系统获取数据或者三让系统调用另外一个三方系统获取数据;

AppKey&AppSecret:第三方开发者在开发应用调用宙斯接口的时候都需要在开放平台申请一个Appkey作为应用的唯一标识。Secret是与appkey一一对应,类似于个人密码,不能对外泄露。主要用途是在isv发起接口调用的时候对请求参数做md5,防止数据被篡改;

授权:数据是商家的,而获取数据的应用是第三方的。所以数据在给到三方的应用获取的时候需要得到商家的授权;

测试环境:这个环境主要是用于开发,测试。

预发环境:预发环境是代码发布到正式环境之前的一个验证环境,使用的数据都是正式环境的真实的数据,但是运行的代码是新的代码。

正式环境:真正对外服务的环境。预发环境验证没问题之后就会把代码发布到正式环境。