注意:该应用类型需由开发者的京东内部接口同事发起内部申请,京东内部接口同事需将业务背景与接入需求阐述清楚并将相关申请资料发送至 jos@jd.com 发起内部申请。
宙斯京东登录应用通过以下几个步骤,即可接入互联开放平台:
宙斯开发者入驻 > 宙斯京东登录应用申请 > 宙斯京东登录应用开发 > 调用宙斯API
一.开发者入驻
1. 在京东宙斯开放平台首页 open.jd.com ,点击右上角的“登录”按钮,使用京东账号登录,如下图所示:
重要提示:
开发者京东账户一旦注册不能变更,建议使用公司账户而不是员工个人账户注册,以免遇到员工离职等情况造成不必要的麻烦。
2. 登录成功后会跳转到开发者注册页面,在注册页面需要提交公司或个人的基本资料。下图所示的是公司注册页面:
二.宙斯京东登录应用接入申请
宙斯京东登录应用接入前,需首先进行申请,获得对应的Appkey与Appsecret,以保证后续流程中可正确对宙斯京东登录应用与用户进行验证与授权。
1.创建宙斯京东登录应用
开发者注册成功后,会跳转到“应用管理”页面,如下图所示:
点击“创建应用”,选择京东互联->京东登录,如下图所示:
点击“创建应用”后,填写宙斯京东登录应用信息后点击提交按钮,如下图所示:
待京东运营审核通过后即可获取的Appkey与Appsecret,如下图所示:
2.宙斯京东登录应用信息完善
点击申请的宙斯京东登录应用下的“应用管理”,进入编辑页面,点击左侧的“应用设置”按钮,页面进入编辑状态,即可对宙斯京东登录应用信息进行修改和完善,如下图所示:
三.宙斯京东登录应用开发
进入宙斯控制台DEV.JD.COM,可以看到宙斯京东登录应用申请处于“审核成功”状态。宙斯京东登录应用上线,首先需对宙斯京东登录应用进行开发,即完成京东账户登录功能并正常放置京东登录按钮,如下图所示:
3.1 开发流程概述
开发流程主要包括如下几个步骤:
3.1.1 宙斯京东登录应用上设置京东登录入口
宙斯京东登录应用开发者可以在自己的宙斯京东登录应用首页入口和主要的登录、注册页面上放置“京东登录”标识:
3.1.2 用户登录验证和授权
用户点击按钮之后弹出登录京东账号的窗口,第一次登录或第一次访问某个未授权的宙斯API时,在登录窗口中同时需要用户授权,用户可以选择授权宙斯京东登录应用访问自己的相关信息:
如下图所示:
3.1.3 登录和授权完成后,跳转回宙斯京东登录应用
如果用户成功登录并授权,则跳转到指定的回调地址,该回调地址由第三方宙斯京东登录应用自行配置(在上一步的请求中传入),回调地址建议设置为宙斯京东登录应用首页或宙斯京东登录应用的用户中心。
3.1.4 获取并存储access token以及openid
成功登录后,即可发送请求来获取access token以及openid,这两个参数在调用宙斯API访问和修改用户数据时必须传入,宙斯京东登录应用需自行绑定或存储:
(1)access token用来判断用户在本宙斯京东登录应用上的登录状态,具有有效期,用户再次登录时自动刷新。
(2)openid是此宙斯京东登录应用上唯一对应用户身份的标识,宙斯京东登录应用可将此ID进行存储便于用户下次登录时辨识其身份,或将其与用户在宙斯京东登录应用上的原有账号进行绑定。
3.1.5 在宙斯京东登录应用上显示用户登录昵称与京东头像
建议宙斯京东登录应用调用jingdong.user.getUserInfoByOpenId
接口,在应用中显示用户的信息,包括用户昵称、京东头像,如下图所示:
详见:jingdong.user.getUserInfoByOpenId
3.2 开发说明
京东登录功能使用国际通用的OAuth2.0协议进行验证与授权,可通过以下方式进行宙斯京东登录应用开发:
根据京东登录OAuth2.0协议,自主开发,此方法自定义程度较高,需要与现有系统进行整合的宙斯京东登录应用可选用此方法。
四.宙斯京东互联应用上线
完成宙斯京东登录应用的开发后,即可在“宙斯控制台”的“应用管理”页面,点击该应用卡片下的“发布应用”,发布成功后应用处于“上线运行”状态,应用的接口调用量也会有5000次提升到300000次,可授权用户数量也由5个提升至不限,入下图所示: