二、开发者操作说明


    1、 开发者登录:
    开发者账号需要技术人员自行操作注册,注册“用户名”不能与商家登录账号一致,保持手机验证号码的唯一性。





    2、资质信息
    营业执照:开发者营业执照并加盖红色公章
    授权书:开发者账号使用人员姓名或管理人员姓名
    公安部信息安全等级保护证明:公安部注册安全网络二级或三级等保资质




    3、创建应用




    应用回调URL要求支持POST方式且必填,可以通过测试token验证是否可用。
    token明细:https://opendj.jd.com/staticnew/widgets/resources.html?id=2022查看详情说明

    应用回调URL接收token请求参数格式:token={"token":"04bd44fe-c726-4a1b-89c2-ed2db1f4fd92",
    "expires_in":"31104000","time":"1450695743010","uid":"","user_nick":"zhangsan","venderId":"72700"},
    其中token有效期expire值为12个月(30天)的秒值,即31104000=12*30*24*60*60

    应用回调URL返回值要求按照格式返回:{"code":"0","msg":"success","data":""}



    4、待审批,需系统审核通过后,开发者才能向商家发起授权




    5、申请授权
    1、向商家申请授权,授权框中填写商家中心(store.jddj.com)提供的商家ID,授权申请后请联系商家为该应用授权,商家操作流程:https://opendj.jd.com/staticnew/widgets/resources.html?id=2002【1分钟每个应用只能申请两次授权,不能重复发起】
    2、商家操作授权后系统会将token信息发送至应用的回调url上,至此,完成ISV应用商家授权token操作





    6、批量创建应用操作
    1、批量上传限于当天最多可创建50个应用(如一次上传50个,创建时如有30个成功20个失败,需重新上传20个失败的应用。)
    2、TOKEN地址不校验有效性,请自行单独创建应用后调取通过后在批量上传配置
    3、批量创建时应用名称、商家名称不可重复,如有重复会创建失败






    7、已授权应用列表详情。
    ①“选择方案”可进入沙箱测试
    ②“编辑”可修改创建应用基本信息
    ③“删除”可清除已授权应用
    ④“复制应用”复制当前应用配置新应用可直接使用,无需再次进行测试
    ⑤“批量更改token自动授权”创建时配置手动更新token,可点击此处“批量变更为自动更新授权”模式
    ⑥“批量新增调频申请”可操作多个商家ID,批量申请同一个接口限频



    在已授权应用列表中,查看应用“方案接口信息”选择并确认系统对接方案接口。





    8、通过应用管理菜单,可查看授权信息、接口配置及测试。







    9、接口启用测试:
    方案选择后接口类系统自动“已启用”状态,接口启用状态后可在线上直接调取,无需测试通过并操作上线,如测试可根据以下图片展示内容操作。





    10、启用测试:开发者技术人员通过操作已开发的应用程序,调用到家侧沙箱环境地址的接口。
    平台根据接口出入参判断测试状态,商家可刷新此页面查看测试状态和测试结果,测试状态:等待测试、已通过、未通过。
    沙箱说明:需调用mockapi地址,例如调用订单查询接口的沙箱地址为:https://opendj.jd.com//mockapi/order/es/query。





    11、消息类订阅测试:
    对于已成功上线的接口无需重复测试上线,只需对新增或修改的接口进行测试上线,即只对本次上线的接口勾选测试上线操作。
    此部分测试需要手动触发,点击“发送消息”(前提已经配置好接收消息的url)。
    平台向商家配置的url地址发送消息,到家系统根据商家接收消息的返回结果判断测试状态。 通过查看结果,可以查看商家接收消息后返回的结果。





    12、沙箱全链路测试:
    采用线上实际单据数据,依据单据业务流程各场景,基于沙箱环境的全链路测试工具。
    其中常规接口调用的URL为mock地址,通知消息类接口的URL为商家侧的测试地址





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






    14、测试通过后,需要操作“我要上线”。在提交申请上线时,到家系统会检查所选启用或订阅的接口的测试状态,当所选的接口都测试通过后,才允许上线。在确认上线前,请先联系商家告知即将上线,确认后再操作上线。申请通过后,到家会将消息接口配置的正式地址切到线上环境并生效。








    15、系统对接完成