京東API接入流程文檔 商家版

1、jos接入流程文檔（商家專用）一、 應(yīng)用申請流程1. 注冊成為開發(fā)者 請訪問：沙箱環(huán)境地址 ： 正式環(huán)境地址： (1) 訪問開發(fā)者中心，點(diǎn)擊”申請成為開發(fā)者“，開始申請流程(2) 用京東賬戶登錄，沒有京東賬戶則注冊一個京東賬戶（3） 登錄成功后，完善注冊信息（4） 提交，申請成功！(5) 然后進(jìn)入我的開發(fā)中心2. 創(chuàng)建應(yīng)用（1） 在開發(fā)者中心，點(diǎn)擊“創(chuàng)建應(yīng)用”(2) 填寫應(yīng)用名稱，選擇應(yīng)用類型通用應(yīng)用：此應(yīng)用isv和商家都可以使用（針對的isv的應(yīng)用需要商家進(jìn)行授權(quán)，商家不需要提供用戶名和密碼給第三方開發(fā)者）商家應(yīng)用：此應(yīng)

2、用只有商家可以使用（3）保存成功，可申請上線 1.通用應(yīng)用：2. 商家應(yīng)用說明：(請選擇您所需要的應(yīng)用)3. 管理應(yīng)用（1） 在開發(fā)者中心，點(diǎn)擊“管理應(yīng)用”(2) 進(jìn)入應(yīng)用列表，點(diǎn)擊“編輯”(3) 進(jìn)入應(yīng)用詳情，這里可以查詢應(yīng)用的相關(guān)密鑰，及修改相關(guān)信息。請保留appkey 和 appsecret 到oauth授權(quán)認(rèn)證用到appkey與appsecrect釋義：appkey：jos京東開放平臺頒發(fā)的唯一標(biāo)識一個應(yīng)用的id號，該appkey可在開發(fā)者中心創(chuàng)建應(yīng)用后獲取，appsecret:（應(yīng)用密鑰，不可對外公開，商家需注意保密，調(diào)用api的時候需要使用，可以通過該密鑰獲得的商家所有數(shù)據(jù)）。(4

3、)修改應(yīng)用信息二、 oauth授權(quán)認(rèn)證 訪問地址：沙箱環(huán)境地址 ： 正式環(huán)境地址： 注意事項：請不要將地址直接貼于地址欄訪問，否者提示您：“異常訪問”請不要沙箱環(huán)境和正式環(huán)境穿插調(diào)用。前言:如果您的應(yīng)用和京東的jos對接后，需要獲取一些與用戶緊密相關(guān)的信息（如訂單、商品、促銷等），為保證數(shù)據(jù)的安全性和隱私性，需要取得用戶的同意，引導(dǎo)用戶授權(quán)。jos采用國際通用的oauth2.0標(biāo)準(zhǔn)協(xié)議，支持網(wǎng)站、桌面客戶端、erp系統(tǒng)。如果要了解更多關(guān)于oauth2.0的技術(shù)說明，請參考官方網(wǎng)站 /2/

4、 目前，jos的oauth2.0支持以下方式獲取access token ：注意：所有授權(quán)流程都不需要商家提供用戶名、密碼給第三方開發(fā)者，商家請保護(hù)好自己的賬號安全1. server-side flow(b/s)此授權(quán)指對應(yīng)用標(biāo)簽中的：“商家應(yīng)用（京東商家應(yīng)用）”里的“ web應(yīng)用（b/s）” 通過用戶授權(quán)獲取授權(quán)碼code獲取授權(quán)碼參數(shù) 參數(shù)名稱參數(shù)選項描述 response_type 必須 此流程下，該值固定為code client_id 必須 即創(chuàng)建應(yīng)用時的appkey (從開發(fā)者中心申請的應(yīng)用中獲取) redirect_uri 必須 應(yīng)用的回調(diào)地址，必須和應(yīng)用的callback主域名匹

5、配。 state 可選 狀態(tài)參數(shù)，由應(yīng)用自定義，頒發(fā)授權(quán)后會原封不動返回 scope否（短授權(quán)為必須） 權(quán)限參數(shù)，api組名串，多個組名時，用“，”分隔，目前支持參數(shù)：read/oauth/authorize （注意此地址需要拼參不能直接訪問）（詳細(xì)請參考o(jì)auth文檔）示例：/oauth/authorize?response_type=code&client_id=12439149&redirect_uri=&state=myststeid

6、&scope=read 用戶登陸輸入用戶名和密碼點(diǎn)擊登錄按鈕跳轉(zhuǎn)到授權(quán)頁面 授權(quán)點(diǎn)擊授權(quán)按鈕跳轉(zhuǎn)到回調(diào)頁面 若用戶選擇“授權(quán)“，則頁面跳轉(zhuǎn)至應(yīng)用的回調(diào)地址，同時返回授權(quán)碼code以及state參數(shù)（code不能重復(fù)使用，下次使用需要重新獲?。?用上一步獲取的code和應(yīng)用密鑰（appsecret）通過http post方式換取token獲取訪問令牌參數(shù) 參數(shù)名稱參數(shù)選項描述 grant_type 必須 授權(quán)類型，此流程下，該值固定為authorization_code code 必須 授權(quán)請求中的授權(quán)碼 redirect_uri 必須 應(yīng)用的回調(diào)地址，必須和應(yīng)用的callback主域名匹配。

7、client_id 必須 即appkey(從開發(fā)者中心申請的應(yīng)用中獲取) client_secret 必須 即appsecret(從開發(fā)者中心申請的應(yīng)用中獲取) scope否（短授權(quán)為必須） 權(quán)限參數(shù)，api組名串，多個組名時，用“，”分隔，目前支持參數(shù)：read/oauth/token （注意此地址需要拼參不能直接訪問）（詳細(xì)請參考o(jì)auth文檔）示例：/oauth/token?grant_type=authorization_code&client_id=12439149&r

8、edirect_uri=&code=tf5xm6&state=myststeid&client_secret=6d5524eb1c6c4f9caf3c7b430f1fdef9top返回的參數(shù)如下： 參數(shù)名稱參數(shù)選項描述access_token用戶授權(quán)令牌，等價于sessionkeyaccess_tokencode返回0，為成功codetoken_type授權(quán)令牌類型，暫做保留參數(shù)備用token_typeexpires_in授權(quán)令牌有效期，以秒為單位expires_inrefresh_token刷新令牌，當(dāng)授權(quán)令牌過期時，可以刷新access_token，如

9、果有獲取權(quán)限則返回refresh_tokentime系統(tǒng)時間time結(jié)果如下： 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)此授權(quán)指對應(yīng)用標(biāo)簽中的：“商家應(yīng)用（京東商家應(yīng)用）”里的“客服端應(yīng)用（c/s）”請將您的商家店鋪名和商家id以及聯(lián)系方式發(fā)送到郵

10、箱獲取c/s授權(quán)方式：3 調(diào)用api接口1. 準(zhǔn)備調(diào)用接口所需要的數(shù)據(jù) 訪問地址：沙箱環(huán)境地址 ：正式環(huán)境地址： server_url地址：請寫相對應(yīng)的地址 示例：/routerjson access_token：從oauth授權(quán)認(rèn)證中獲取 app_key：從開發(fā)者中心申請的應(yīng)用的“京東證書”中獲取 sign：請參考簽名說明 調(diào)用示例： 接口名稱360buy.order.search 功能說明根據(jù)條件檢索訂單信息 系統(tǒng)級別

11、輸入?yún)?shù)名稱類型是否必須描述methodstring是api接口名稱access_tokenstring是采用oauth授權(quán)方式為必填參數(shù)app_keystring是應(yīng)用的app_keysignstring是簽名timestampstring是時間戳，格式為yyyy-mm-ddhh:mm:ss，例如：2011-06-16 13:23:30。京東api服務(wù)端允許客戶端請求時間誤差為6分鐘formatstring否暫時只支持jsonvstring是api協(xié)議版本，可選值:2.0. 應(yīng)用級輸入?yún)?shù)名稱類型是否必須示例值描述start_datestring否 2010-12-20 17:15:00開始

12、時間 和 結(jié)束時間 不得相差超過1個月end_datestring否2010-12-20 17:15:00開始時間 和 結(jié)束時間 不得相差超過1個月order_statestring是wait_seller_stock_out每個訂單狀態(tài)以逗號分隔,(該接口只提供三個狀態(tài)， wait_seller_stock_out 等待出庫， wait_seller_delivery 等待發(fā)貨(只適用于sop商家)， trade_canceled 取消)pagestring是1查詢的頁數(shù)page_sizestring是12每頁的條數(shù)（最大page_size 100條）optional_fieldsstrin

13、g否商家希望返回的訂單的信息字段,每個字段以逗號分隔2. sdk調(diào)用示例（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

14、);request.setenddate(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請求方式示例/routerjson?app_

15、key=fdce5cec7b064a966cc3f4b36587f84f&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=end_date:2012-05-16 17:03:56,optional_fields:vender_id,order_id,pay_type,order

16、_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,start_date:2012-05-14 17:03:564 簽名說明1、系統(tǒng)級輸入?yún)?shù)名稱類型是否必須描述示

17、例值默認(rèn)值methodstring是api接口名稱methodstringaccess_tokenstring是采用oauth授權(quán)方式為必填參數(shù)access_tokenstringapp_keystring是應(yīng)用的app_keyapp_keystringtimestampstring是時間戳，格式為yyyy-mm-dd hh:mm:ss，例如：2011-06-16 13:23:30。京東api服務(wù)端允許客戶端請求時間誤差為6分鐘無vstring是api協(xié)議版本，可選值:2.0。無2、應(yīng)用級輸入?yún)?shù)名稱類型描述示例360buy_param_jsonstring標(biāo)準(zhǔn)json 類型,而且是按照字母先

18、后順序排序的 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,consignee_info,item_info_list, order_state: wai

19、t_seller_stock_out, page: 1, page_size: 20, start_date: 2012-05-14 17:03:56 3、加密規(guī)則：a) 所有請求參數(shù)按照字母先后順序排序 例如：將access_token,app_key,method,timestamp,v 排序為 access_token,app_key,method,timestamp,v)b) 把所有參數(shù)名和參數(shù)值串在一起 例如：access_tokenxxxapp_keyxxxmethodxxxxxxtimestampxxxxxxvxc) 把a(bǔ)ppsecret夾在字符串的兩端例如：appsecret+

20、xxxx+appsecretd) 使用md5進(jìn)行加密，再轉(zhuǎn)化成大寫4、示例 ： 調(diào)用api方法：360buy.order.search，appsecret: 6d5524eb1c6c4f9caf8c7b430d1fdef9 （1）輸入?yún)?shù)：access_token=ad6c71c3-7fb3-4f7b-8258-9a6413a5bbbfapp_key=7843a398cce3397ec50c495458f64b64method=360buy.order.searchtimestamp=2011-07-20 11:10:04v=2.0360buy_param_json= end_date: 20

21、12-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, consignee_info,item_info_list, order_state: wait_seller_stock_out,

22、 page: 1, page_size: 20, start_date: 2012-05-14 17:03:56（2）按照參數(shù)名稱排序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,or

23、der_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:56access_token=ad6c71c3-7fb3-4f7b-8258-9a6413a5bbbf app_key=7843a398cce3397ec50c495458f64b64 method=360buy.order.searchtimestamp=2011-07-20 11:10:04v=2.0（3）連接參數(shù)名與參數(shù)值,并在首尾加上appsecret6d5524eb1c6c4f9caf8c7b430d1fdef9360buy_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_remar