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

1、JOS接入流程文檔(商家專用)應(yīng)用申請(qǐng)流程1.注冊(cè)成為開發(fā)者請(qǐng)?jiān)L問(wèn)：沙箱環(huán)境地址：正式環(huán)境地址：注冊(cè)京東好注冊(cè)京東好使用京東賬戶登錄使用京東賬戶登錄成為京東開發(fā)者成為京東開發(fā)者(1)訪問(wèn)開發(fā)者中心，點(diǎn)擊”申請(qǐng)成為開發(fā)者開始申請(qǐng)流程開發(fā)者(2)用京東賬戶登錄，沒(méi)有京東賬戶則注冊(cè)一個(gè)京東賬戶還不是京東藺城用戶？還不是京東藺城用戶？現(xiàn)在免費(fèi)注冊(cè)成為京東商城用戶，便能立刻享受便宜又放心的購(gòu)物樂(lè)趣?，F(xiàn)在免費(fèi)注冊(cè)成為京東商城用戶，便能立刻享受便宜又放心的購(gòu)物樂(lè)趣。注冊(cè)制用戶企業(yè)用戶注冊(cè)校園用戶注冊(cè)(3)登錄成功后，完善注冊(cè)信息(5)然后進(jìn)入我的開發(fā)中心位居管理供期創(chuàng)建調(diào)用京在商城API的應(yīng)用供邂營(yíng)理調(diào)用京

2、東商城片網(wǎng)的應(yīng)用(4)提交，申請(qǐng)成功!恭喜!操作成功!開友右開發(fā)者中心菜學(xué)苜由基本設(shè)苗小開發(fā)動(dòng)態(tài)管理應(yīng)甫M幫助中心開笈好闞介培開發(fā)起無(wú)開出工口就京東開放平臺(tái)流35上京東人才招聘信意2 .創(chuàng)建應(yīng)用( (1) )在開發(fā)者中心，點(diǎn)擊創(chuàng)建應(yīng)用”開發(fā)者中心丸創(chuàng)建nr應(yīng)用譏您創(chuàng)注淤二切、商城API的應(yīng)用管理應(yīng)用供您管理調(diào)用京琪商城API的應(yīng)用(2)填寫應(yīng)用名稱，選擇應(yīng)用類型開發(fā)者中心菜單匕應(yīng)用管理-基本設(shè)畜首頁(yè)開齒者中，L，首頁(yè)應(yīng)用首理基本設(shè)置通用應(yīng)用：此應(yīng)用ISV和商家都可以使用（針對(duì)的ISV的應(yīng)用需要商家進(jìn)行授權(quán)，商家不需要提供用戶名和密碼給第三方開發(fā)者）商家應(yīng)用：此應(yīng)用只有商家可以使用（3）保存成功

3、，可申請(qǐng)上線1.通用應(yīng)用:即供用戶訪問(wèn)的應(yīng)用地址中洋見(jiàn) v 京東說(shuō)明網(wǎng)址前須有“伸口：*監(jiān)控頁(yè)面URLhttp:/ v 京東說(shuō)明網(wǎng)址前須有力加獷詳細(xì)信息由清I線士應(yīng)用名解我的通用應(yīng)用不超過(guò)2時(shí)字符*回調(diào)頁(yè)面URL尺寸：B0 煙 0,大?。翰怀^(guò) 50 匕格式：qifjpg 朝 png*填寫您的回調(diào)地址http:/www.balduoom應(yīng)用圉標(biāo)選擇文件點(diǎn)擊申諳上城2.商家應(yīng)用說(shuō)明：（請(qǐng)選擇您所需要的應(yīng)用）1) )在開發(fā)者中心，點(diǎn)擊管理應(yīng)用開發(fā)者中心首頁(yè)開發(fā)者中心首頁(yè)(2)進(jìn)入應(yīng)用列表，點(diǎn)擊編輯3.管理應(yīng)用創(chuàng)建應(yīng)用供您創(chuàng)建調(diào)用京東商城API的應(yīng)用JML管理0 應(yīng)用供您營(yíng)理調(diào)用京東商城API的應(yīng)用

4、(3)進(jìn)入應(yīng)用詳情，這里可以查詢應(yīng)用的相關(guān)密鑰，及修改相關(guān)信息。MBKey：652101ASF71D4615D74BO36C0097650FAppSecrek香石重者證書費(fèi)里：汕。映慶證書擲肌基狷開放請(qǐng)保留appkey和appsecret到oauth授權(quán)認(rèn)證用到appkey與appsecrect釋義：appkey：JOS京東開放平臺(tái)頒發(fā)的唯一標(biāo)識(shí)一個(gè)應(yīng)用的ID號(hào)，該appkey可在開發(fā)者中心創(chuàng)建應(yīng)用后獲取，appSecret:(應(yīng)用密鑰，不可對(duì)外公開，商家需注意保密，調(diào)用API的時(shí)候需要使用，可以通過(guò)該密鑰獲得的商家所有數(shù)據(jù))。4上然運(yùn)行開發(fā)者中心苜 3*應(yīng)用營(yíng)陛=編輯應(yīng)用1.平臺(tái)也捏勝了短布

5、他博管窗捶口，在碘上邯定儆I瓢戶后，你可以在網(wǎng)站上整合卷布信里的臃，讓用戶在你的網(wǎng)站上壺布的信皇勘爭(zhēng)展時(shí)的同步到網(wǎng)站上 C3用戶的美迂者前窗后時(shí)看到內(nèi)苔，可咽垣肉苔的疑接朝海辨攝點(diǎn)擊進(jìn)入網(wǎng)站3.用戶不但可以短布交室向智，也可以東儂(4)修改應(yīng)用信息Oauth 授權(quán)認(rèn)證訪問(wèn)地址:* *應(yīng)用書稱我們一個(gè)應(yīng)用應(yīng)用書稱我們一個(gè)應(yīng)用不超過(guò)不超過(guò)2沖字符沖字符選擇文件選擇文件尺寸：尺寸：80 x80)大小：不超過(guò)大小：不超過(guò)50K,格式二格式二gifjpg或口或口ng* *胸建類型胸建類型Q QWE電電z用用( (日陰日陰客服端應(yīng)用客服端應(yīng)用(c/s)* *回潮頁(yè)面回潮頁(yè)面URLhttp：/wwbaidu

6、com即供用戶訪問(wèn)的應(yīng)用地址。詳見(jiàn)京東說(shuō)明即供用戶訪問(wèn)的應(yīng)用地址。詳見(jiàn)京東說(shuō)明下下網(wǎng)址前須有力即獷網(wǎng)址前須有力即獷詳期信息詳期信息應(yīng)用圉標(biāo)應(yīng)用圉標(biāo)申諳卜畿申諳卜畿沙箱環(huán)境地址：正式環(huán)境地址：注意事項(xiàng)：請(qǐng)不要將地址直接貼于地址欄訪問(wèn)，否者提示您:請(qǐng)不要沙箱環(huán)境和正式環(huán)境穿插調(diào)用。前言：如果您的應(yīng)用和京東的JOS對(duì)接后，需要獲取一些與用戶緊密相關(guān)的信息（如訂單、商品、促銷等），為保證數(shù)據(jù)的安全性和隱私性，需要取得用戶的同意，引導(dǎo)用戶授權(quán)。JOS采用國(guó)際通用的OAuth2.0標(biāo)準(zhǔn)協(xié)議，支持網(wǎng)站、桌面客戶端、ERP系統(tǒng)。如果要了解更多關(guān)于OAuth2.0的技術(shù)說(shuō)明，請(qǐng)參考官方網(wǎng)站http:/ A京東賬

7、號(hào)信息；店浦內(nèi)商品信息三交易相關(guān)訂單和客戶信息；投根成功后，您也可以隨時(shí)在授根管理里查看和取消授權(quán)期消點(diǎn)擊授權(quán)按鈕跳轉(zhuǎn)到回調(diào)頁(yè)面若用戶選擇“授權(quán)“，則頁(yè)面跳轉(zhuǎn)至應(yīng)用的回調(diào)地址，同時(shí)返回授權(quán)碼code以及提供授權(quán)的京宇信息提供京東增值即皆授權(quán)授權(quán)state參數(shù)（code不能重復(fù)使用，下次使用需要重新獲?。﹚vv-.-.baiiduxomkode=tJEVC&state=m;.ststeid用上一步獲取的Code和應(yīng)用密鑰（AppSecret）通過(guò)HttpPost方式換取Token能直接訪問(wèn)）（詳細(xì)請(qǐng)參考o(jì)auth文檔）示例:http:/ Id 以及聯(lián)系方式發(fā)送到郵箱獲取 C/S 授權(quán)方式

8、：三.調(diào)用API接口1.準(zhǔn)備調(diào)用接口所需要的數(shù)據(jù)訪問(wèn)地址：沙箱環(huán)境地址：正式環(huán)境地址：SERVER_URL地址：請(qǐng)寫相對(duì)應(yīng)的地址示例：http:/ OAuth 授權(quán)認(rèn)證中獲取app_key：從開發(fā)者中心申請(qǐng)的應(yīng)用的“京東證書”中獲取sign：請(qǐng)參考簽名說(shuō)明調(diào)用示例:接口名稱360buy.ordersearch功能說(shuō)明根據(jù)條件檢索訂單信息系統(tǒng)級(jí)別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_tokenString是采用 OAuth 授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格

9、式為yyyy-MM-ddHH:mm:ss,例如：2011-06-1613:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值：2.0.應(yīng)用級(jí)輸入?yún)?shù)名稱是否必須示例值描述start_dateString否2010-12-2017:15:00開始時(shí)間和不得相差超過(guò)結(jié)束時(shí)間1個(gè)月end_dateString否2010-12-2017:15:00開始時(shí)間和不得相差超過(guò)結(jié)束時(shí)間1個(gè)月order_stateString是WAIT_SELLER_STOCK_OUT；每個(gè)訂單狀態(tài)以逗號(hào)分隔,（該接口只提供三個(gè)狀態(tài)，WA

10、IT_SELLER_STOCK_OUT 等待出庫(kù)，WAIT_SELLER_DELIVERY 等待發(fā)貨（只適用于 SOP商家）,TRADE_CANCELED 取消）pageString是1查詢的頁(yè)數(shù)page_sizeString是12每頁(yè)的條婁k（最大page_size100條)optional_fieldsString否商家希望返回的訂單的信息字段，每個(gè)字段以逗號(hào)分隔2. SDK調(diào)用示例（java）publicJdClientclient=newDefaultJdClient(SERVER_URL,c7b82199-f26d-459e-a4b3d6f6cec4b869,36AB8642CCEF

11、66293AD391EE7E4E9510da953632d0a4741beb0bbd096214605”)；OrderSearchRequestrequest=newOrderSearchRequest();request.setStartDate(2012-01-1012:12:23);request.setEndDate(2012-02-2012:13:13);request.setOrderState(WAIT_SELLER_STOCK_OUT);request.setPage(1);request.setPageSize(100);request.setOptionalFields(v

12、ender_id,order_id,pay_type);OrderSearchResponseresponse=client.execute(request);3. url請(qǐng)求方式示例http:gw.api.sandbox.360buycom/routerjson?app_key=FDCE5CEC7B064A966CC3F4B36587F84F&access_token=f1df472e-f61a-4071-a203-eb77c427919f&sign=75357565E83CF434971BEDA453761265&format=json&timestamp=

13、2012-05-16+17%3a03%3a55&v=2.0&method=360buyorder.search&360buy_param_json=end_date:2012-05-1617: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_sta

14、rt_time,order_end_time,consignee_info,item_info_list,order_state:WAIT_SELLER_STOCK_OUT,page:1,page_size:20,start_date:2012-05-1417:03:56四.簽名說(shuō)明1、系統(tǒng)級(jí)輸入?yún)?shù)名稱類型是否必須描述示例值默認(rèn)值methodString是API接口名稱methodStringaccess_tokenString是采用 OAuth 授權(quán)方式為必填參數(shù)access_tokenStringapp_keyString是應(yīng)用的app_keyapp_keyStringtimestamp

15、String是時(shí)間戳，格式為 yyyy-MM-ddHH:mm:ss,例如：2011-06-1613:23:30。京東 API 服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為 6 分鐘無(wú)vString是API 協(xié)議版本，可選值：2.0。無(wú)2、應(yīng)用級(jí)輸入?yún)?shù)名稱類型描述示例360buy_param_jsonString標(biāo)準(zhǔn) json 類型， 而且是按照字母先后順序排序的end_date:2012-05-1617:03:56”,optional_fields:vender_id,order_id,pay_type,order_total_price,freight_price,seller_discount,ord

16、er_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-1417:03:56)金加密規(guī)則：a)所有請(qǐng)求參數(shù)按照字母先后順序排序例如：將access_token,app_key,method,timestamp,v排序?yàn)閍c

17、cess_token,app_key,method,timestamp,v)b)把所有參數(shù)名和參數(shù)值串在一起例如：access_tokenxxxapp_keyxxxmethodxxxxxxtimestampxxxxxxvxc)把a(bǔ)ppSecret夾在字符串的兩端例如：appSecret+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-9a64

18、13a5bbbfapp_key=7843A398CCE3397EC50C495458F64B64method=360buy.order.searchtimestamp=2011-07-2011:10:04v=2.0360buy_param_json=end_date:2012-05-1617: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_re

19、mark,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-1417:03:56)(2)按照參數(shù)名稱排序360buy_param_json=(end_date:2012-05-1617:03:56,optional_fields:vender_id,order_id,pay_type,order_total_price,fr

20、eight_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-1417:03:56access_token=ad6c71c3-7fb3-4f7b-8258-9a641

21、3a5bbbfapp_key=7843A398CCE3397EC50C495458F64B64method=360buy.order.searchtimestamp=2011-07-2011:10:04v=2.0(3)連接參數(shù)名與參數(shù)值，并在首尾加上appSecret6d5524eb1c6c4f9caf8c7b430d1fdef9360buy_param_json(end_date:2012-05-1617: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_