二、操作说明


    1、进入自助对接流程,点击“商家自助对接”入口,也可以直接点击“商家登录”进入。





    2、自研商家自助对接—商家有自己的研发团队并能实施系统对接(自研)。





    3、到家根据已对接商家的使用场景梳理出各种对接方案,根据“商家类型”,到家提供建议性对接方案。





    4、实物类对接方案详细信息(以实物类为例):到家提供基础接口/消息推送两种形式的接口。

    商家可以组合选择推荐的对接方案






    5、选好方案提交后,需留下商家对接联系人信息,以便后期技术对接沟通。





    6、申请成功后,技术人员需要在“应用管理”中,进行自助授权。





    7、输入商家用于接收授权码的服务器URL地址,通过测试按钮验证URL地址是否可用,提交“授权”成功后,系统完成已选方案下的接口授权。





    8、自助授权成功,可以查看授权信息,其中token有效期expire值为12个月(30天)的秒值,即31104000=12*30*24*60*60。





    9、自助授权成功,可以查看所选择的方案及其接口启用状态。




    10、进入接口配置,可以启用或配置所选的接口,对于商家不需要的接口,商家可以点击“禁用”。





    11、接口配置:编辑已选方案,在平台推荐的方案范围内,商家可以修改已选择的方案。





    12、接口配置:配置接口出参,商家可以对接口部分出参自定义配置值,测试时,接口返回值优先按照商家配置值返回,否则接口按默认值返回数据。





    13、进入接口配置,可以订阅或配置所选的消息,对于商家不需要的消息,商家可以点击“取消订阅”。





    14、接口配置:配置地址,测试时发送消息使用的是测试地址,申请上线后,正式地址才被线上环境使用。





    15、启用测试:商家技术人员通过操作已开发的应用程序,调用到家侧沙箱环境地址的接口。

    平台根据接口出入参判断测试状态,商家可刷新此页面查看测试状态和测试结果,测试状态:等待测试、已通过、未通过。

    沙箱说明:需调用mockapi地址,例如调用订单查询接口的沙箱地址为:https://opendj.jd.com/mockapi/order/es/query。






    16、接口测试:经测试后,可以查看测试结果,接口返回值状态不同,对应的测试结果也不同,依据测试结果信息排查直至测试通过。





    17、消息类接口测试:

    对于已成功上线的接口无需重复测试上线,只需对新增或修改的接口进行测试上线,即只对本次上线的接口勾选测试上线操作。

    此部分测试需要手动触发,点击“发送消息”(前提已经配置好接收消息的url)。

    平台向商家配置的url地址发送消息,到家系统根据商家接收消息的返回结果判断测试状态。

    通过查看结果,可以查看商家接收消息后返回的结果。





    18、沙箱全链路测试:

    采用线上实际单据数据,依据单据业务流程各场景,基于沙箱环境的全链路测试工具。

    其中常规接口调用的URL为mock地址,通知消息类接口的URL为商家侧的测试地址。





    19、沙箱全链路测试时需要真实的单据号进行测试,在启动一键测试后,可以根据节点颜色变化查看当前接口或消息的测试结果。




    20、测试通过后,需要操作“我要上线”,在提交申请上线时,到家系统会检查商家所有启用或订阅的接口的测试状态,

    当所有的接口都测试通过后,才允许上线,申请通过后,到家会把配置部分配置的消息接收地址切到线上环境。





    21、上线申请通过后,商家已具备上线条件,需要商家技术人员部署服务器进行上线,在上线完成后,

    如果线上出现错误,可以通过此处的“导出线上日志”导出日志。商家可以指定日期导出日志(单位:天),商家依据异常日志分析错误原因。

    批注:此功能目前还没有全面开放,如商家需要开通请提交在线问答说明。






    22、自研商家自助对接—上线后,问题反馈途径。

    上线后,遇到问题:

    有任何问题,请及时通过在线问答系统提交,商家在线问答访问地址:http://t.cn/EMuefUG/。