京东API接入流程文档

1、JOS接入流程文档（商家专用） 应用申请流程aww发者创sm发布应用授权认证调用API注册成为开发者注flfl懿明使用京东账户登录埴与开发者信息成为京东开其者请访问：沙箱环境地址：正式环境地址：开始申请流程访问开发者中心，点击”申请成为开发者气申请成为开发者用京东账户登录，没有京东账户则注册一个京东账户用户登录用户名：I密码:忘记掩码?回记住用户名口自动登录还不是京东商城用户？现在免赛注册成为京东商城用户，便能立刻享受便宜又株 心的购物乐趣。注册新用户企业用户注册校园用户注册（3）登录成功后，完善注册信息1注册京东账户N使用京东账户登录3.完善注册信息第三步:完善注册信息京东会员名垂直心跳提交

2、，申请成功!操作蛇！您已经成功注册为开发者了。您可以：前:往开发者中心首页.然后进入我的开发中心开发者中心菜单应用管理基本设置H应用管理A应用列表A创建新应用Q基本设置4创建rt*应用也管理M应用供您创建调用京东商城API的应用供您管理调用京东商城 API的应用开发者中心首页e开发动态e帮助中心开发环境介绍开发规范开发工具时京东开放平台微薄e问题公告A 舔幅息创建应用在开发者中心，点击“创建应用”开发者中心应用管理基本设置开发者中心首页开发者中心菜单Q应用管理0基本设置供您创建调用京东商城API的应用也管理应雨供您管理调用京东商城API的应用填写应用名称，选择应用类型开发者中心首页 应用管理n

3、添加应用1成为开发者2.创建应用3.在线测试4上线运行创建一个应用之前请您点击查看标签默迪皿，点击-提交一后，您将获得调用API所需的应用证书（包含：App Keyx App Secret. API流里 API权限）。*应用名称PQP商家工具I不超过个字符应用标签（标签是应用的美健标示、可荻得相应的权限与便于用户识别其应用类型）通用应用（京东通用应用）9商家应用（京东商家应用）3我-阅读并同章书京本开衲平台舍作伙伴开专协该通用应用：此应用ISV和商家都可以使用（针对的ISV的应用需要商家进行授权，商 家不需要提供用户名和密码给第三方开发者）商家应用：此应用只有商家可以使用 （3）保存成功，可申

4、请上线通用应用:*应用名称应用囹标*回调页面URL我的通用应用选择文件尺寸:30 x80,大小：不超过5叶，格式：gifjipg或png填写您的回调地址 http:/www. 即供用户访问的应用地址。详见京东说明网址前须有*监控页面URL详细信息http:/www. baidu.co m/pop_m onitor. html自动生成即供J 03访问检删的地址。详见=京东湖脂网址前须有http:/点击申请上线由话皆商家应用说明：（请选择您所需要的应用）*应用名称我们一个应用不超过如个字符应用囹标7圣： 迭择文件尺寸：珈腴，太小：不超过泗格式：gifjpgpng*构建类型9 WE日应用(BJS)

5、客月艮端应用(CJS)*回调页面URLhttp:/www. 即供用户访问的应用地址。详见京东说明=网址前须有http:/r详细信息由请I线管理应用(1)在开发者中心，点击“管理应用”开发者中心首页创建it*应用供您创建调用京东商城 API的应用0管理应用供您管理调用京东商城 API的应用(2)进入应用列表，点击，编辑”标篓证书状态操作商家应用AppKey： 653101A8F73D4515D74B036CBB97650F删试进行中流里：5G皿次氐(3)进入应用详情，这里可以查询应用的相关密钥，及修改相关信息。开发者中心首页 应用管理=编辑应用1.成为开发者2.削建应用3.在犊81试4.上犊运行

6、状态：测试进行中我们一个应用1.2.3.用户不但可以发布文宇内容，也可以添加图片。林证书App Key: 6531O1A0F73D4515D74BO36CB09765OFApp Secret：沓看重罟证书流fi： 5000次氐证书权限：基础开放标荟：商家应用平台也提供了发布微博信息的接口，在网站上绑定微博账户后，您可以在网站上整合发布信息的功能，让用户在您的网站上发布的信息 能够授时的同步到网站上。用户的关注者能够授时看到内容，可以通过内容的槌接或来源槌接点击进入网站。请保留appkey和appsecret到oauth授权认证用到appkey与appsecrect释义：appkey： JOS京

7、东开放平台颁发的唯一标识一个应用的ID 号，该appkey可在开发者中心创建应用后获取，appSecret:(应用密钥，不可对外公开，商家 需注意保密，调用API的时候需要使用，可以通过该密钥获得的商家所有数据)。修改应用信息*应用名称我们一个应用不超过知个字符应用囹标选择文件尺寸：机蜘,大小：不超过501,格式：gif.jpg或png*构建类型 WE日应用(B/S)客明端应用(C/S)* 回调页面URL http:Mwww.baidu.8m即供用户访问的应用地址。详见u京东说明网址前须有-httf7r详细信息由请I线二、Oauth授权认证访问地址:沙箱环境地址：正式环境地址：注意事项：请不要

8、将地址直接贴于地址栏访问，否者提示您：“异常访问”请不要沙箱环境和正式环境穿插调用。前言：如果您的应用和京东的JOS对接后，需要获取一些与用户紧密相关的信息（如订单、 商品、促销等），为保证数据的安全性和隐私性，需要取得用户的同意，引导用户授权。JOS 采用国际通用的OAuth2.0标准协议，支持网站、桌面客户端、ERP系统。如果要了解更多 关于OAuth2.0的技术说明，请参考官方网站/2Z目前，JOS的OAuth2.0支持 以下方式获取Access Token :注意：所有授权流程都不需要商家提供用户名、密码给第三方开发者，商家请 保护好自己的账号安全1 Server-side flow（

9、B/S）此授权指对应用标签中的：“商家应用（京东商家应用）”里的“ WEB应用（B/S）” 通过用户授权获取授权码Code获取授权码参数参数名称参数选项描述response_type必须此流程下，该值固定为codeclient_id必须即创建应用时的Appkey （从开发者中心申请的应用中 获取）redirect_uri必须应用的回调地址，必须和应用的callback主域名匹配。state可选状态参数，由应用自定义，颁发授权后会原封不动返 回scope否（短授权为必须）权限参数，API组名串，多个组名时，用“，”分隔， 目前支持参数：read HYPERLINK /oauth/authoriz

10、e /oauth/authorize （注意此地址需要拼参不能直接访问）（详细请参考oauth文档）示例： HYPERLINK /oauth/authorizefresponse /oauth/authorizefresponse type=code&client id二 12439149&redirect uri=&state二myststeid&scope二read用户登陆提供授权的京东信息提供京东增值月艮务登录授权后fbp_ordlernj得您的个人信息，为您提供更加优质的服务!查看里京宓服瓢设也用户名输入用户名和密码点击登录按钮跳转到授权页面授权提供授枳的京东信息提供京东增值振务登录授

11、权后fb，_Qde可获得您的个人信息，为您提供更加优质的服 务!查看虫京本网服务地通-京东账号信息；店浦内商品信息；交易相关订单和客户信息；授权成功后，您也可以随时在授权管理里查看和取消授权刖消者用户选择授权，则页面跳转至应用的回调地址，同时返回授权码code以及state参数（code不能重复使用，下次使用需要重新获取）W 圈 /?code=tOEY7C&staite=my5tsteid用上一步获取的Code和应用密钥（AppSecret）通过Http Post方式换取Token获取访问令牌参数参数名称参数选项描述grant_type必须授权类型，此流程下，该值固定为authorizatio

12、n_codecode必须授权请求中的授权码redirect_uri必须应用的回调地址，必须和应用的callback主域名匹配。client_id必须即Appkey（从开发者中心申请的应用中获取）client_secret必须即Appsecret（从开发者中心申请的应用中获取）scope否（短授权为必须）权限参数，API组名串，多个组名时，用“，”分隔， 目前支持参数：read HYPERLINK /oauth/token /oauth/token（注意此地址需要拼参不能直接访问）（详细请参考oauth文档）示例： HYPERLINK /oauth/tokeMgrant_type=authori

13、zation_code&cli /oauth/tokeMgrant_type=authorization_code&client_id = 12439149&redirect_uri=&code=tf5xM6&state二mystSteid&client_secret=6d5524eb1c6c4f9caf3c7b430f1fdef9TOP返回的参数如下:参数名称参数选项描述access_token用户授权令牌，等价于Sessionkeyaccess_tokencode返回0，为成功codetoken_type授权令牌类型，暂做保留参数备用token_typeexpires_in授权令牌有效期，

14、以秒为单位expires_inrefresh_token刷新令牌，当授权令牌过期时，可以刷新access_token，如果有获取权限则返回refresh_tokentime系统时间time结果如下:access_token”: 47565790-662f-4b32-8cb7-8b4f984be462”,code: 0,expires_in”: 31104000,refresh_token: 71443717-d3ea-40df-9dc1-f7a77b448f91”,time: 1337674952269,token_type: bearer2.Password flow（C/S）此授权指对应用

15、标签中的：“商家应用（京东商家应用）”里的“客服端应用（C/S）”请将您的商家店铺名和商家Id以及联系方式发送到邮箱获取C/S授权方式： HYPERLINK mailto:jos360 jos360三.调用API接口1.准备调用接口所需要的数据访问地址：沙箱环境地址：正式环境地址：SERVER_UR L地址：请写相对应的地址示例：/routerjsonaccess_token :从OAuth授权认证中获取app_key :从开发者中心申请的应用的“京东证书”中获取sign :请参考签名说明调用示例：接口名称 360buy.ordersearch 功能说明根据条件检索订单信息系统级别输入参数名称

16、类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳，格式为 yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东 API 服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString是API协议版本，可选值:2.0.应用级输入参数名称类型是否必须示例值描述start_dateString否2010-12-2017:15:00开始时间和结束时

17、间不得相差超过1个月end_dateString否2010-12-2017:15:00开始时间和结束时间不得相差超过1个月order_stateString是WAIT_SELLER_STOCK_OUT每个订单状态以逗号分隔,（该接口只提供三个状态，WAIT_SELLER_STOCK_OUT等待出库，WAIT_SELLER_DELIVERY等待发货（只适用于SOP商家），TRADE_CANCELED 取消）pageString是1查询的页数page_sizeString是12每页的条数（最大page_size 100 条)optional_fieldsString否商家希望返回的订单的 信息字段

18、,每个字段以逗 号分隔2. SDK调用示例(java)public JdClient client = new DefaultJdClient(SERVER_URL,c7b82199-f26d-459e-a4b3-d6f6cec4b869”,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”)OrderSearchRequest request = new OrderSearchRequest();request.setStartDate(2012-01-10 12:12:23);request.setEn

19、dDate(2012-02-20 12:13:13);request.setOrderState(WAIT_SELLER_STOCK_OUT);request.setPage(1);request.setPageSize(100);request.setOptionalFields(vender_id,order_id,pay_type);OrderSearchResponse response 二 client.execute(request);3. url请求方式示例http:/gw.api.sandbox.360buycom/routerjson?app_key=FDCE5CEC7B06

20、4A966CC3F4B36587F84F&access_token=f1df472e-f61a-4071-a203-eb77c427919f&sign=75357565E83CF434971BEDA453761265&format=json×tamp=2012-05-16+17%3a03%3a55&v=2.0&method=360buy.order.search&360buy_param_json=en d_date:2012-05-1617:03:56,optional_fields:vender_id,order_id,pay_type,order_total_price,fre

21、ight_price,seller_discount,order_payment,delivery_type,order_state,order_state_remark,invoice_info,order_remark,order_start_time,order_end_time,consignee_info,item_info_list”,order_state”:WAIT_SELLER_STOCK_OUT”,page”:1”,page_size”:20”,start_date”:2012-05-14 17:03:56四.签名说明1、系统级输入参数名称类型是否必须描述示例值默认值met

22、hodString是API接口名称methodStringaccess_tokenString是采用OAuth授权方式为必填参数access_tokenStringapp_keyString是应用的app_keyapp_keyStringtimestampString是时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。 京东API服务端允许客户端请求时间 误差为6分钟无vString是API协议版本，可选值:2.0。无2、应用级输入参数名称类型描述示例360buy_param _jsonString标准json类型，而且是按照字母先后顺 序排序

23、的end_date:2012-05-16 17:03:56”,optional_fields:vender_id,order_id,pay_type,order_tot al_price,freight_price,seller_discount,order_payment,delivery_typ e,order_state,order_state_remark,invoice_ info,order_remark,order_start_time,order_end_time,consignee_info,item_in fo_list,order_state:WAIT_SELLER_ST

24、OCK_ OUT,page: 1,page_size: 20, start_date:2012-05-14 17:03:563、加密规则：a）所有请求参数按照字母先后顺序排序例如：将 access_token,app_key,method,timestamp,v 排序为access_token,app_key,method,timestamp,v）b）把所有参数名和参数值串在一起例如：access_tokenxxxapp_keyxxxmethodxxxxxxtimestampxxxxxxvxc）把appSecret夹在字符串的两端例如：appSecret+XXXX+appSecretd）使用M

25、D5进行加密，再转化成大写4、示例:调用 api 方法：360buy.order.search，appSecret: 6d5524eb1c6c4f9caf8c7b430d1fdef9（1）输入参数：access_token =ad6c71c3-7fb3-4f7b-8258-9a6413a5bbbfapp_key=7843A398CCE3397EC50C495458F64B64method=360buy.order.searchtimestamp=2011-07-20 11:10:04v=2.0360buy_param_json=end_date”: 2012-05-16 17:03:56,op

26、tional_fields: vender_id,order_id,pay_type,order_total_price,freight_price, seller_discount,order_payment,delivery_type,order_state,order_state_remark,invoice_info,order_remark,order_start_time,order_end_time, consignee_info,item_info_list,order_state: WAIT_SELLER_STOCK_OUT,page: 1,page_size: 20,sta

27、rt_date: 2012-05-14 17:03:56（2）按照参数名称排序360buy_param_json=end_date”: 2012-05-16 17:03:56,optional_fields: vender_id,order_id,pay_type,order_total_price,freight_price, seller_discount,order_payment,delivery_type, order_state,order_state_remark,invoice_info,order_remark,order_start_time,order_end_time,

28、 consignee_info,item_info_list,order_state: WAIT_SELLER_STOCK_OUT”,page: 1,page_size: 20,start_date: 2012-05-14 17:03:56access_token =ad6c71c3-7fb3-4f7b-8258-9a6413a5bbbfapp_key=7843A398CCE3397EC50C495458F64B64method=360buy.order.searchtimestamp=2011-07-20 11:10:04v=2.0（3）连接参数名与参数值,并在首尾加上appSecret6d5524eb1c6c4f9caf8c7b430d1fdef9 360buy_param_jsonend_date: 2012-05-16 17:03:56,opti