商家接入流程文檔20120

1、商家接入流程文檔商家接入注冊成為開發(fā)者 （完善相關信息提交申請成為開發(fā)者）請訪問：創(chuàng)建應用在線測試（填入相應的信息并申請上線）。 請保留appkey 和 appsecret 到oauth授權認證用到appkey與appsecrect釋義：appkey：JOS京東開放平臺頒發(fā)的唯一標識一個應用的ID號，該appkey可在 HYPERLINK /isv/index.htm開發(fā)者中心創(chuàng)建應用后獲取，appSecret:（應用密鑰，不可對外公開，商家需注意保密，調用API的時候需要使用，可以通過該密鑰獲得的商家所有數(shù)據(jù)）。Oauth授權認證 訪問地址：Server-side flow(B/S)通過用戶

2、授權獲取授權碼Code獲取授權碼參數(shù) 參數(shù)名稱參數(shù)選項描述 response_type 必須 此流程下，該值固定為code client_id 必須 即創(chuàng)建應用時的Appkey (從開發(fā)者中心申請的應用中獲取) redirect_uri 必須 應用的回調地址，必須和應用的callback主域名匹配。 state 可選 狀態(tài)參數(shù)，由應用自定義，頒發(fā)授權后會原封不動返回 scope 短授權為必須 權限參數(shù)，API組名串，多個組名時，用“，”分隔，目前支持參數(shù)：read HYPERLINK /oauth/authorize/oauth/authorize （注意此地址需要拼參不能直接訪問）（詳細請參

3、考oauth文檔）示例： HYPERLINK /oauth/authorize?response_type=code&client_id=12439149&redirect_uri=&state=myststeid&scope=read/oauth/authorize?response_type=code&client_id=12439149&redirect_uri=&state=myststeid&scope=read用戶登陸輸入用戶名和密碼點擊登錄按鈕跳轉到授權頁面授權點擊授權按鈕跳轉到回調頁面若用戶選擇“授權“，則頁面跳轉至應用的回調地址，同時返回授權碼code以及state參數(shù)（co

4、de不能重復使用）用上一步獲取的Code和應用密鑰（AppSecret）通過Http Post方式換取Token獲取訪問令牌參數(shù) 參數(shù)名稱參數(shù)選項描述 grant_type 必須 授權類型，此流程下，該值固定為authorization_code code 必須 授權請求中的授權碼 redirect_uri 必須 應用的回調地址，必須和應用的callback主域名匹配。 client_id 必須 即Appkey(從開發(fā)者中心申請的應用中獲取) client_secret 必須 即Appsecret(從開發(fā)者中心申請的應用中獲取) scope 短授權為必須 權限參數(shù)，API組名串，多個組名時，用

5、“，”分隔，目前支持參數(shù)：read HYPERLINK /oauth/token/oauth/token （注意此地址需要拼參不能直接訪問）（詳細請參考oauth文檔）示例： HYPERLINK /oauth/token?grant_type=authorization_code&client_id=12439149&redirect_uri=http:/&code=tf5xM6&state=myststeid&client_secret=6d5524eb1c6c4f9caf8c7b430f1fdef9/oauth/token?grant_type=authorization_code&cli

6、ent_id=12439149&redirect_uri=&code=tf5xM6&state=myststeid&client_secret=6d5524eb1c6c4f9caf3c7b430f1fdef9TOP返回的參數(shù)如下： 參數(shù)名稱參數(shù)選項描述access_token用戶授權令牌，等價于Sessionkeyaccess_tokencode返回0，為成功codetoken_type授權令牌類型，暫做保留參數(shù)備用token_typeexpires_in授權令牌有效期，以秒為單位expires_inrefresh_token刷新令牌，當授權令牌過期時，可以刷新access_token，如果有

7、獲取權限則返回refresh_tokentime系統(tǒng)時間timeaccess_token用戶授權令牌，等價于Sessionkeyaccess_token結果如下：access_token: 47565790-662f-4b32-8cb7-8b4f984be462,code: 0,expires_in: 31104000,refresh_token: 71443717-d3ea-40df-9dc1-f7a77b448f91,time: 1337674952269,token_type: bearerPassword flow(C/S) 參數(shù)名稱參數(shù)選項描述grant_type是此流程下，該值固定

8、為passwordclient_id是即創(chuàng)建應用時的Appkey（從開發(fā)者中心申請的應用中獲取)client_secret是即Appsecret(從開發(fā)者中心申請的應用中獲取)username是用戶名字password是用戶密碼 （需要MD5加密）scope否（短授權為必須）權限參數(shù)，API組名串，多個組名時，用“，”分隔，目前支持參數(shù)：readgrant_type是此流程下，該值固定為password 示例：（詳細請參考oauth文檔所需參數(shù)） /oauth/token （注意此地址需要拼參不能直接訪問）注意：password 需要進行MD5加密/oauth/token?grant_type

9、=password&client_id=291391DD610A10DE352D3B890BDAB221&username=lbp_1order&password=360buy&scope=readTOP返回的參數(shù)如下： 參數(shù)名稱描述access_token用戶授權令牌，等價于Sessionkeycode返回0，為成功token_type授權令牌類型，暫做保留參數(shù)備用expires_in授權令牌有效期，以秒為單位refresh_token刷新令牌，當授權令牌過期時，可以刷新access_token，如果有獲取權限則返回time系統(tǒng)時間access_token用戶授權令牌，等價于Sessionk

10、ey調用API接口準備調用接口所需要的數(shù)據(jù) 訪問地址： access_token：從OAuth授權認證中獲取 app_key：從開發(fā)者中心申請的應用的“京東證書”中獲取 sign：請參考 HYPERLINK l _簽名說明:簽名說明 調用示例： 接口名稱360buy.order.search功能說明根據(jù)條件檢索訂單信息系統(tǒng)級別輸入參數(shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是 HYPERLINK l _簽名說明:簽名timestampSt

11、ring是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協(xié)議版本，可選值:2.0.應用級輸入參數(shù)名稱類型是否必須示例值描述start_dateString否 2010-12-20 17:15:00開始時間 和 結束時間 不得相差超過1個月end_dateString否2010-12-20 17:15:00開始時間 和 結束時間 不得相差超過1個月order_stateString是WAIT_SELLER_STOCK_OUT每個訂單狀

12、態(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_fieldsString否商家希望返回的訂單的信息字段,每個字段以逗號分隔2. SDK調用示例（java）public JdClient client = new DefaultJdClient(SERVER_URL,c7b82199-f26d-459e-a

13、4b3-d6f6cec4b869,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);OrderSearchRequest request = new OrderSearchRequest();request.setStartDate(2012-01-10 12:12:23);request.setEndDate(2012-02-20 12:13:13);request.setOrderState(WAIT_SELLER_STOCK_OUT);request.setPage(1);request.setP

14、ageSize(100);request.setOptionalFields(vender_id,order_id,pay_type);OrderSearchResponse response = client.execute(request);3. url請求方式示例/routerjson?app_key=FDCE5CEC7B064A966CC3F4B36587F84F&access_token=f1df472e-f61a-4071-a203-eb77c427919f&sign=75357565E83CF434971BEDA453761265&format=json×tamp=20

15、12-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_total_price,freight_price,seller_discount,order_payment,delivery_type,order_state,order_state_remark,invoice_info,order_remark,order_start_time,orde

16、r_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、系統(tǒng)級輸入參數(shù)名稱類型是否必須描述示例值默認值methodString是API接口名稱methodStringaccess_tokenString是采用OAuth授權方式為必填參數(shù)access_tokenStringapp_keyString是應用的app_keyapp_keyStringtimestampString是時間戳，格式為y

17、yyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘無vString是API協(xié)議版本，可選值:2.0。無2、應用級輸入參數(shù)名稱類型描述示例360buy_param_jsonString標準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_t

18、ype,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 3、加密規(guī)則：所有請求參數(shù)按照字母先后順序排序 例如：將access_token,app_key,method,timestamp,v 排序為 access_token,app_key

19、,method,timestamp,v) 把所有參數(shù)名和參數(shù)值串在一起 例如：access_tokenxxxapp_keyxxxmethodxxxxxxtimestampxxxxxxvx把appSecret夾在字符串的兩端例如：appSecret+XXXX+appSecret使用MD5進行加密，再轉化成大寫4、示例 ： 調用api方法：360buy.order.search，appSecret: 6d5524eb1c6c4f9caf8c7b430d1fdef9 (1)、輸入參數(shù)：access_token=ad6c71c3-7fb3-4f7b-8258-9a6413a5bbbfapp_key=7

20、843A398CCE3397EC50C495458F64B64method=360buy.order.search timestamp=2011-07-20 11:10:04 v=2.0 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_

21、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 (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,

22、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:56access_token=ad6c71c3-7fb3-4f7b-8258-9a6413a5bbbf app_key=784