京东api接入流程-商家版

《京东api接入流程-商家版》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、JOS接入流程文档（商家专用）一、应用申请流程1.注册成为开发者请访问：沙箱环境地址：dev.sandbox.360buy.com正式环境地址：jos.360buy.com(1)访问开发者中心，点击”申请成为开发者“，开始申请流程(2)用京东账户登录，没有京东账户则注册一个京东账户（3）登录成功后，完善注册信息（4）提交，申请成功！(5)然后进入我的开发中心1.创建应用（1）在开发者中心，点击“创建应用”(2)填写应用名称，选择应用类型通用应用：此应用ISV和商家都可以使用（针对的ISV的应用需要商家进行授权

2、，商家不需要提供用户名和密码给第三方开发者）商家应用：此应用只有商家可以使用（3）保存成功，可申请上线1.通用应用：2.商家应用说明：(请选择您所需要的应用)3.管理应用（1）在开发者中心，点击“管理应用”(2)进入应用列表，点击“编辑”(3)进入应用详情，这里可以查询应用的相关密钥，及修改相关信息。请保留appkey和appsecret到oauth授权认证用到appkey与appsecrect释义：appkey：JOS京东开放平台颁发的唯一标识一个应用的ID号，该appkey可在开发者中心创建应用后获取，a

3、ppSecret:（应用密钥，不可对外公开，商家需注意保密，调用API的时候需要使用，可以通过该密钥获得的商家所有数据）。(4)修改应用信息一、Oauth授权认证访问地址：沙箱环境地址：auth.sandbox.360buy.com正式环境地址：auth.360buy.com注意事项：请不要将地址直接贴于地址栏访问，否者提示您：“异常访问”请不要沙箱环境和正式环境穿插调用。前言:如果您的应用和京东的JOS对接后，需要获取一些与用户紧密相关的信息（如订单、商品、促销等），为保证数据的安全性和隐私性，需要取得用户

4、的同意，引导用户授权。JOS采用国际通用的OAuth2.0标准协议，支持网站、桌面客户端、ERP系统。如果要了解更多关于OAuth2.0的技术说明，请参考官方网站http://oauth.net/2/目前，JOS的OAuth2.0支持以下方式获取AccessToken：注意：所有授权流程都不需要商家提供用户名、密码给第三方开发者，商家请保护好自己的账号安全1.Server-sideflow(B/S)此授权指对应用标签中的：“商家应用（京东商家应用）”里的“WEB应用（B/S）”Ø通过用户授权获取授权码Code

5、获取授权码参数参数名称参数选项描述response_type必须此流程下，该值固定为codeclient_id必须即创建应用时的Appkey(从开发者中心申请的应用中获取)redirect_uri必须应用的回调地址，必须和应用的callback主域名匹配。state可选状态参数，由应用自定义，颁发授权后会原封不动返回scope否（短授权为必须）权限参数，API组名串，多个组名时，用“，”分隔，目前支持参数：readhttp://auth.sandbox.360buy.com/oauth/authorize（注

6、意此地址需要拼参不能直接访问）（详细请参考oauth文档）示例：http://auth.sandbox.360buy.com/oauth/authorize?response_type=code&client_id=12439149&redirect_uri=http://www.baidu.com&state=myststeid&scope=read²用户登陆输入用户名和密码点击登录按钮跳转到授权页面²授权点击授权按钮跳转到回调页面²若用户选择“授权“，则页面跳转至应用的回调地址，同时返回授权码code以及

7、state参数（code不能重复使用，下次使用需要重新获取）Ø用上一步获取的Code和应用密钥（AppSecret）通过HttpPost方式换取Token获取访问令牌参数参数名称参数选项描述grant_type必须授权类型，此流程下，该值固定为authorization_codecode必须授权请求中的授权码redirect_uri必须应用的回调地址，必须和应用的callback主域名匹配。client_id必须即Appkey(从开发者中心申请的应用中获取)client_secret必须即Appsecret(

8、从开发者中心申请的应用中获取)scope否（短授权为必须）权限参数，API组名串，多个组名时，用“，”分隔，目前支持参数：readhttp://auth.sandbox.360buy.com/oauth/token（注意此地址需要拼参不能直接访问）（详细请参考oauth文档）示例：http://auth.sandbox.360buy.com/oauth/token?grant_type=author