二、操作说明 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/。
二、自研商家自助对接说明 1.自助对接点击“商家自助对接申请”入口,也可以直接点击“商家登录”。 2.选择 “我们公司有自己的ISV合作伙伴”。 3.到家根据已对接商家的使用场景梳理出各种对接方案,根据“商家类型”,到家提供建议性对接方案,以及对接方案介绍《京东秒送开放平台对接方案流程图》。 4.服务类对接方案详细信息(以服务类为例):到家提供基础接口/消息推送两种形式的接口。 商家可以组合选择推荐的对接方案 5.商家可以把生成的方案信息,发给自己的合作伙伴,由合作伙伴进行“开发者注册”并向商家申请授权。