阿里1688開放平臺

阿里1688開放平臺

專用API
【更新時間: 2024.07.23】 阿里1688開放平臺是面對1688商家及采購代發(fā)買家日益繁雜的電商管理需求，基于大數(shù)據(jù)提供快捷、高效的應(yīng)用工具
瀏覽次數(shù)
182
采購人數(shù)
7
試用次數(shù)
3
! SLA: N/A
! 響應(yīng): N/A
! 適用于個人&企業(yè)
試用
收藏
×
完成
取消
×
書簽名稱
確定
<
產(chǎn)品介紹
>

什么是阿里1688開放平臺?

阿里1688開放平臺是面對1688商家及采購代發(fā)買家日益繁雜的電商管理需求，基于大數(shù)據(jù)提供快捷、高效的應(yīng)用工具。

什么是阿里1688開放平臺接口？

由服務(wù)使用方的應(yīng)用程序發(fā)起，以Restful風(fēng)格為主、通過公網(wǎng)HTTP協(xié)議調(diào)用阿里1688開放平臺，從而實(shí)現(xiàn)程序的自動化交互，提高服務(wù)效率。

阿里1688開放平臺有哪些核心功能？

  1. 商品管理：提供自動重發(fā)、批量處理、一鍵復(fù)制、信息優(yōu)化等功能，幫助商家高效管理商品信息。
  2. 訂單管理：支持批量打印、批量發(fā)貨、自動評價(jià)、進(jìn)銷存等功能，簡化訂單處理流程。
  3. 流量推廣：提供網(wǎng)銷寶優(yōu)化、站外推廣、搜索優(yōu)化、無線引流等推廣工具，助力商家提升店鋪流量。
  4. 店鋪裝修：包括主圖制作、裝修模版、關(guān)聯(lián)營銷、詳情設(shè)計(jì)等功能，幫助商家打造專業(yè)美觀的店鋪形象。
  5. 鋪貨分銷：支持一鍵鋪貨、訂單回流、批量支付、自動發(fā)貨等功能，特別針對跨境電商和分銷商，實(shí)現(xiàn)快速高效的采購和分銷。
  6. 業(yè)務(wù)場景解決方案：深度開放B2B業(yè)務(wù)場景，提供完整的解決方案，讓ISV（獨(dú)立軟件開發(fā)商）可以“拎包入住”，快速對接平臺服務(wù)。
  7. API開發(fā)能力：提供模塊化的接口集合，清晰的接口分類，方便開發(fā)伙伴進(jìn)行二次開發(fā)和系統(tǒng)集成。

阿里1688開放平臺的核心優(yōu)勢是什么？

  1. 開放商業(yè)思維：平臺秉持開放的心態(tài)，積極與全球服務(wù)開發(fā)者合作，共同推動商業(yè)生態(tài)的繁榮。
  2. 多樣化的業(yè)務(wù)場景：支持豐富的業(yè)務(wù)場景，如跨境電商、鋪貨分銷等，滿足不同商家的多樣化需求。
  3. 高效的工具集：提供一系列快捷、高效的電商管理工具，幫助商家簡化流程，提升運(yùn)營效率。
  4. 強(qiáng)大的技術(shù)支持：通過API開放、多語言SDK、云環(huán)境集成等技術(shù)資源，為開發(fā)者提供強(qiáng)大的技術(shù)支持。
  5. 清晰的盈利模式：為商家和服務(wù)商提供清晰的盈利模式，促進(jìn)商業(yè)生態(tài)的可持續(xù)發(fā)展。
  6. 豐富的成功案例：平臺已合作超過1600家服務(wù)商，擁有眾多成功案例，證明了其市場價(jià)值和商業(yè)潛力。
  7. 優(yōu)質(zhì)的服務(wù)保障：提供一件代發(fā)包郵、快速發(fā)貨、退換貨保障等優(yōu)質(zhì)服務(wù)，增強(qiáng)買家信心，提升交易成功率。

在哪些場景會用到阿里1688開放平臺？

跨境電商

面向跨境電商平臺開店的1688采購商，與ISV一起實(shí)現(xiàn)智能選款、一鍵鋪貨、自動下單、批量支付和訂單信息同步等功能，幫助跨境平臺賣家輕松實(shí)現(xiàn)在下游跨境電商平臺銷售，在1688平臺快速完成采購的業(yè)務(wù)功能。

鋪貨分銷

面向在下游電商或內(nèi)容平臺（如淘寶/抖音/快手/小紅書/微信）開店的分銷商，通過結(jié)合ISV數(shù)據(jù)化技術(shù)能力，實(shí)現(xiàn)1688優(yōu)質(zhì)代發(fā)貨源一鍵智能多店鋪貨、下游訂單自動回流采購，自動發(fā)貨，幫助下游賣家輕松實(shí)現(xiàn)1688代發(fā)采購對接

貨源推薦

提供一件代發(fā)包郵、48小時內(nèi)發(fā)貨、7天包退等優(yōu)質(zhì)代發(fā)服務(wù)保障貨源品池，同時商品價(jià)格較下游零售面價(jià)平均低20%以上，結(jié)合ISV的用戶觸達(dá)渠道，幫助1688代發(fā)分銷買家實(shí)現(xiàn)更高利潤空間的優(yōu)質(zhì)貨源采購對接
<
使用指南
>

一、注冊成為開發(fā)者

注冊開發(fā)者身份，需同時具備以下兩個條件

1、具備一個阿里巴巴中國站帳號

2、必須綁定了通過個人或者企業(yè)實(shí)名認(rèn)證的支付寶帳號；個人開發(fā)者必須綁定通過個人實(shí)名認(rèn)證的支付寶賬號，企業(yè)開發(fā)者必須綁定通過商家認(rèn)證的支付寶賬號

具備這兩個條件之后就可以在1688開放平臺注冊成為開發(fā)者

 

二、注冊應(yīng)用

注冊成為開發(fā)者之后就可以在1688開放平臺上注冊應(yīng)用

應(yīng)用注冊成功后isv可以獲得此app的關(guān)鍵信息，包括appkey、app密鑰以及流量上限（5000）。

注意：appkey和app密鑰相當(dāng)于用戶名和密碼，請不要隨意泄露

 

三、開發(fā)測試

說明：如果你的web app要在阿里巴巴應(yīng)用市場售賣，那么請選擇“托管式授權(quán)”，否則請選擇“WEB授權(quán)”；如果是客戶端app，請選擇“客戶端授權(quán)”。請參考授權(quán)分類

1、托管式授權(quán)方式： 
對于托管式授權(quán)開發(fā)方式而言，您的app需要與應(yīng)用市場配合完成授權(quán)過程，那么您可以參考如下授權(quán)流程編寫代碼

（1）用戶授權(quán)以及api調(diào)用，對應(yīng)圖中黃色部分。用戶通過應(yīng)用市場訂購你的app然后初次訪問時，應(yīng)用市場會302跳轉(zhuǎn)到你的app入口url，同時帶上參數(shù)code。 所以代碼中不需要涉及獲取code這一步，只需要使用getToken接口拿應(yīng)用市場傳過來的code換取accessToken， 并將getToken返回信息保存下來， 然后用返回信息中的accessToken作為參數(shù)調(diào)用api（參考 API調(diào)用說明 ） 在app測試過程中可以通過 授權(quán)測試工具 生成一個code，然后作為參數(shù)訪問應(yīng)用入口即可測試。 
注意：必須以getToken返回信息中的refreshToken為主，如果跟本地保存的refreshToken不一樣，那么本地的refreshToken廢棄。

（2）特殊情況處理，對應(yīng)圖中綠色部分。主要是accessToken失效的處理。 如果accessToken失效，那么就需要用保存的refreshToken調(diào)用getToken接口生成一個新的accessToken；

（3）錯誤處理，對應(yīng)圖中紅色部分。如果出現(xiàn)簽名錯誤、時間戳錯誤等異常情況，最好是能夠在日志中記錄當(dāng)前調(diào)用的url以及參數(shù)，這樣即使在出現(xiàn)問題時也能快速查找并解決問題。（參考 常見問題 ）

 

2、WEB授權(quán)方式：

對于WEB授權(quán)開發(fā)方式而言，您的app不會在阿里巴巴應(yīng)用市場售賣，那么您需要完成完整的授權(quán)過程，請參考如下授權(quán)流程

（1）用戶授權(quán)。請按照授權(quán)說明中的WEB授權(quán)流程編寫具體代碼。

（2）特殊情況處理。主要是accessToken失效以及refreshToken過期的處理。 如果accessToken失效，那么就需要用保存的refreshToken調(diào)用getToken接口生成一個新的accessToken； 如果refreshToken失效，那么需要重新進(jìn)行第一步。

（3）錯誤處理。如果出現(xiàn)簽名錯誤、時間戳錯誤等api調(diào)用失敗的情況，最好是能夠在日志中記錄當(dāng)前調(diào)用的url以及參數(shù)，這樣即使在出現(xiàn)問題時也能快速查找并解決問題。（參考常見問題）

 

3、客戶端授權(quán)方式

對于客戶端授權(quán)開發(fā)方式而言，跟WEB授權(quán)類似，也需要完成完整的授權(quán)過程，請參考如下授權(quán)流程

（1）用戶授權(quán)。請按照授權(quán)說明中的客戶端授權(quán)流程編寫具體代碼

（2）特殊情況處理。主要是accessToken失效以及refreshToken過期的處理。 如果accessToken失效，那么就需要用保存的refreshToken調(diào)用getToken接口生成一個新的accessToken； 如果refreshToken失效，那么需要重新進(jìn)行第一步。

（3）錯誤處理。如果出現(xiàn)簽名錯誤、時間戳錯誤等api調(diào)用失敗的情況，最好是能夠在日志中記錄當(dāng)前調(diào)用的url以及參數(shù)，這樣即使在出現(xiàn)問題時也能快速查找并解決問題。（參考常見問題）

 

四、提交申請

應(yīng)用測試無誤后還需要填寫更為詳細(xì)的app信息才能提交上線申請

1、如果您的app需要在應(yīng)用市場在線售賣，那么審核通過后會在應(yīng)用市場進(jìn)行上架配置；

2、如果您的app是通過自有渠道銷售或者僅供自用，那么審核通過后在應(yīng)用市場不顯示。

注意：app提交審核之后將無法修改，請確認(rèn)app測試通過并且重要信息填寫無誤后再提交審核 

 

五、審核并上線

提交審核申請之后，阿里巴巴工作人員會在一周內(nèi)進(jìn)行審核

如果審核通過則可在相關(guān)平臺提供服務(wù)；如果不通過，需要isv修改app然后再次提交申請

應(yīng)用審核關(guān)注的重點(diǎn)是應(yīng)用功能和安全性，請isv關(guān)注應(yīng)用接入審核規(guī)則

app審核通過并在應(yīng)用市場配置后即可上線，有以下兩點(diǎn)需要注意

1、app流量上限由原來的5000增加到100000，如果在app使用過程中發(fā)現(xiàn)流量不夠，可以向開放平臺申請擴(kuò)充

2、app的基本信息中有部分信息可以修改，包括應(yīng)用簡介、應(yīng)用詳情、客服旺旺、客服郵箱以及客服電話。修改后同樣需要提交審核才能正式生效。

詳情參考：https://open.1688.com/api/apidoclist.htm?id=624392

<
產(chǎn)品問答
>
?
通過瀏覽器訪問直接報(bào)500錯誤
很有可能是使用ie瀏覽器的原因，建議使用chrome或者firefox瀏覽器，這樣可以清晰地看到返回的錯誤信息
?
簽名錯誤
返回結(jié)果為：{"error_code":400,"error_message":"com.alibaba.openapi.gateway.exceptions.RequestValidateException:Invalid signature.","exception":"com.alibaba.openapi.gateway.exceptions.RequestValidateException: Invalid signature."} a. 如果請求參數(shù)中帶中文或者日期（如：20120228212041422+0800），所有參數(shù)需在UrlEncode之前計(jì)算簽名，也就是用原始的參數(shù)計(jì)算簽名；簽名完成后，在請求前應(yīng)對參數(shù)用utf-8進(jìn)行UrlEncode，再訪問阿里巴巴開放平臺。可以使用簽名測試工具測試簽名的正確性 b. 如果根據(jù)當(dāng)前url和請求參數(shù)計(jì)算的簽名和簽名測試工具一致，那么只可能是傳到后端服務(wù)的參數(shù)與代碼中的參數(shù)不一致，可能原因是使用 get請求的參數(shù)內(nèi)容太長（換成post請求試試），也可能是特殊字符的編碼格式不對（設(shè)置Content-type為"application/x-www-form-urlencoded; charset=UTF-8"試試） c. 如果請求中涉及文件上傳，文件字節(jié)流參數(shù)不參與簽名計(jì)算；另外，需指定請求的form enctype屬性為multipart/form-data
?
app訪問頻率超限
返回信息{"error_code":"403","error_message":"Beyond the app call frequency limit","exception":"Beyond the app call frequency limit"} 通常app都會有訪問頻率的限制，可以在阿里巴巴開放平臺開發(fā)者中心看到自己的app的每日調(diào)用頻率上限， 這個值代表單臺服務(wù)器24小時內(nèi)訪問的頻率上限。一旦在某一臺服務(wù)器上通過此app調(diào)用api 的次數(shù)超過這個上限，那么就會報(bào)這個錯誤，這時候需要聯(lián)系開放平臺管理員修改調(diào)用頻率上限。
?
app怎么獲取臨時令牌code
對于托管式授權(quán)方式，由于app托管在應(yīng)用市場，那么用戶在進(jìn)入app應(yīng)用時，阿里巴巴開放平臺會302跳轉(zhuǎn)到app的入口地址，同時會附帶參數(shù)code。App在跳轉(zhuǎn)的http請求中，可取得此參數(shù)。 對于客戶端或者web端授權(quán)方式，需要app自己發(fā)起獲取code的請求，用戶登錄成功后就會返回code。
?
code錯誤
返回結(jié)果為：{"error":"invalid_request","error_description":"wrong authorizationCode:cb681549-c8de-441c-b96b-e0e224fb28e0"} 可能原因： a. code已失效，為了保證用戶數(shù)據(jù)安全，臨時令牌code的有效期為2分鐘。App在獲得令牌后，需同步調(diào)用getToken接口，獲取token。 b. 用該code多次獲取token。code為一次性消費(fèi)的臨時令牌，調(diào)用一次getToken后，此臨時令牌便已失效。 c. 獲取code使用的appKey和獲取token使用的appKey不一致。
?
未使用post調(diào)用getToken接口
返回結(jié)果為：{"error":"invalid_request","error_description":"Method not set to POST."} oauth2協(xié)議規(guī)定，getToken必須為post提交
?
未使用https調(diào)用getToken接口
返回結(jié)果為：{"error_code":"400","error_message":"API unsupport the channel: http.","exception":"API unsupport the channel: http."} getToken必須為https請求
?
調(diào)用getToken接口時缺少redirect_uri參數(shù)
返回結(jié)果為：{"error":"invalid_request","error_description":"Missing parameters: redirect_uri"} getToken的參數(shù)中redirect_uri必須要填
?
缺少簽名
返回結(jié)果為：{"error_code":"401","error_message":"Request need signature","exception":"Request need signature"} 原因是當(dāng)前訪問的api 需要簽名，但是傳入的參數(shù)中沒有_aop_signature。在調(diào)用api 時要注意看文檔中的系統(tǒng)級輸入?yún)?shù)，在其中可以看到請求簽名是否必須
?
accessToken過期
返回結(jié)果為：{"error_code":"401","error_message":"Request need user authorized","exception":"Request need user authorized"} 原因是傳入的參數(shù)access_token已經(jīng)過期，需要用refreshToken重新?lián)Q取accessToken。
?
沒有授權(quán)
返回結(jié)果為：{"error_code":"401","error_message":"Request need user authenticated","exception":"Request need user authenticated"} 原因是當(dāng)前訪問的api 需要用戶授權(quán)才能訪問，但是沒有傳入?yún)?shù)access_token。在調(diào)用api 時要注意看對于api 文檔中的"API用戶授權(quán)類型"，在其中可以看到是否需要授權(quán)。
?
refreshToken錯誤
返回結(jié)果為：{"error":"invalid_request","error_description":"wrong refreshToken"} 原因一般有兩種：refreshToken錯誤，refreshToken過期
?
沒有傳refreshToken參數(shù)
返回結(jié)果為：{"error":"invalid_request","error_description":"Missing parameters: refresh_token"} 原因是在用refreshToken換accessToken時refreshToken參數(shù)為空，請檢查post請求的refreshToken參數(shù)是否遺漏
?
密鑰校驗(yàn)不通過
返回結(jié)果為：{"error":"unauthorized_client","error_description":"getToken secret error! client_id: YOUR_APPKEY"} 原因是在使用getToken接口時傳入的client_secret參數(shù)跟client_id不匹配，也就是沒有傳入client_id（appkey）對應(yīng)的密鑰，導(dǎo)致后臺在校驗(yàn)密鑰時發(fā)現(xiàn)與預(yù)期的密鑰不符，所以報(bào)錯。 可能原因有以下兩種：一是傳入的client_secret錯誤，二是傳入了正確的密鑰但是在post調(diào)用時沒有進(jìn)行urlencode。
?
時間戳錯誤
返回結(jié)果為{"error_code":"400","error_message":"com.alibaba.openapi.exception.request.RequestValidateException: Request is expired.","exception":"com.alibaba.openapi.exception.request.RequestValidateException: Request is expired."} 時間戳參數(shù)代表著訪問api 的時間，只要傳入了這個參數(shù)，那么每次訪問時系統(tǒng)都會把這個參數(shù)與當(dāng)前時間進(jìn)行對比，如果二者相差超過了時間戳誤差的話，就會報(bào)這個錯誤。 所以對于這個時間戳參數(shù)有三點(diǎn)需要注意：（1）首先要閱讀api文檔的系統(tǒng)級輸入?yún)?shù)一節(jié)，看api 的訪問是否需要時間戳，如果不需要就沒有必要傳入這個參數(shù)。（2）如果api 要求必須傳入時間戳，那么最好是先進(jìn)行時間校準(zhǔn)然后再調(diào)用api。（3）時間戳的內(nèi)容為時間的毫秒值，在java中轉(zhuǎn)換方式為new Date().getTime()，其他編程語言也有類似的轉(zhuǎn)換方式 時間戳校準(zhǔn)方法：調(diào)用currentTime接口（http://gw.open.1688.com/openapi/param2/1/system/currentTime/{YOUR_APP_KEY}）獲取系統(tǒng)時間，然后跟本地取到的當(dāng)前時間對比取二者的差，這樣就得到了本地時間與阿里巴巴服務(wù)器的時間差；然后在調(diào)用api 時把當(dāng)前時間加上這個時間差作為時間戳參數(shù)
?
缺少時間戳參數(shù)
返回結(jié)果為{"error_code":"400","error_message":"API need time stamp verify, so request must has _aop_timestamp. ","exception":"API need time stamp verify, so request must has _aop_timestamp. "} 原因是api 必須要有時間戳參數(shù)，但是調(diào)用時沒有傳入這個參數(shù)
?
調(diào)用api 時使用的appkey不存在或者未通過審核
返回結(jié)果為{"error_code":"400","error_message":"com.alibaba.openapi.exception.request.RequestValidateException: Invalid appKey, unsport appKey: xxx","exception":"com.alibaba.openapi.exception.request.RequestValidateException: Invalid appKey, unsport appKey: xxx"} 對應(yīng)的app不存在或者未通過審核
<
關(guān)于我們
>
阿里巴巴開放平臺是面向1688商家及采購代發(fā)買家的電商管理需求，提供基于大數(shù)據(jù)的快捷、高效應(yīng)用工具。平臺涵蓋流量推廣、跨境電商、鋪貨分銷、貨源推薦等業(yè)務(wù)場景解決方案，同時提供API開發(fā)能力，支持會員、商品、旺鋪、訂單、支付、物流等服務(wù)。已合作服務(wù)商超過1600家，致力于幫助中小企業(yè)實(shí)現(xiàn)電商業(yè)務(wù)的高效管理。
聯(lián)系信息
服務(wù)時間： 09:00--18:00
電話號碼： 400-800-1688

文化和價(jià)值觀

使命
讓天下沒有難做的生意。
愿景
追求成為一家活102年的好公司。我們的愿景是讓客戶相會、工作和生活在阿里巴巴。
 
價(jià)值觀
客戶第一，員工第二，股東第三
因?yàn)樾湃危院唵?/div>
唯一不變的是變化
今天最好的表現(xiàn)是明天最低的要求
此時此刻，非我莫屬
認(rèn)真生活，快樂工作
 
里程碑
阿里巴巴集團(tuán)由曾擔(dān)任英語教師的馬云與其他來自不同背景的伙伴共18人，于1999年在中國杭州創(chuàng)立。從一開始，所有創(chuàng)始人就深信互聯(lián)網(wǎng)能夠創(chuàng)造公平的環(huán)境，讓小企業(yè)通過創(chuàng)新與科技拓展業(yè)務(wù)，并更有效地參與中國及國際市場競爭。自推出讓中國中小企業(yè)接觸全球買家的首個網(wǎng)站以來，阿里巴巴作為控股公司持有六大業(yè)務(wù)集團(tuán)：淘天集團(tuán)、阿里國際數(shù)字商業(yè)集團(tuán)、云智能集團(tuán)、本地生活集團(tuán)、菜鳥集團(tuán)、大文娛集團(tuán)，以及各種其他業(yè)務(wù)。

關(guān)于1688開放平臺

   1688開放平臺，依托B2B海量用戶資源以及強(qiáng)大的平臺優(yōu)勢，是為阿里巴巴買賣家提供開放服務(wù)的重要平臺，幫助商家提升經(jīng)營能力、拓寬生意渠道、提高辦公效率；幫助買家提升選品、下單效率，降低采購成本等。

   

   我們致力于為企業(yè)構(gòu)建智能經(jīng)營服務(wù)網(wǎng)絡(luò)，開放和集成企業(yè)經(jīng)營生命周期所需的專業(yè)服務(wù)，解決企業(yè)經(jīng)營問題。賦能生態(tài)伙伴以靈活、安全及低成本形式進(jìn)行系統(tǒng)對接，信息互聯(lián)。

 

我們服務(wù)哪些伙伴

    1688開放平臺服務(wù)兩類最基礎(chǔ)的伙伴，為買賣家提供服務(wù)工具的1688服務(wù)商（isv），以及有1688電商系統(tǒng)對接需求并有開發(fā)能力的買賣家。

    · 第一種 - 合作伙伴銷售服務(wù)模式：服務(wù)商伙伴使用開放平臺的場景解決方案（api）開發(fā)工具或服務(wù)，并在1688服務(wù)市場售賣給買賣家。提供包括但不限于電商經(jīng)營所需的管理工具和買家采購提效工具或服務(wù)，如商品管理，訂單管理，電商ERP等工具。

    · 第二種 - 買賣家自開發(fā)模式：有開發(fā)能力的1688商家或買家，使用平臺解決方案，開發(fā)滿足自身電商場景所需的工具，如買家采購場景，以及部分垂直業(yè)務(wù)的開放場景，如跨境電商、社交電商等，此場景僅限企業(yè)用戶自開發(fā)自使用，禁止私自線下售賣或授權(quán)其他企業(yè)使用，如因此產(chǎn)生的數(shù)據(jù)泄漏、法律責(zé)任由開發(fā)者全權(quán)承擔(dān)。

 

我們將提供哪些服務(wù)

    我們?yōu)橐陨祥_發(fā)者伙伴提供了基礎(chǔ)的產(chǎn)品研發(fā)平臺，包括組成場景解決方案的API，消息，介紹，幫助文檔等，以及研發(fā)輔助相關(guān)的測試工具、咨詢工具、信息反饋渠道等，幫助合作伙伴解決研發(fā)問題。

    我們開放的解決方案主要是圍繞商家電商經(jīng)營和買家采購場景，如常見的商家場景有：訂單管理解決方案、商品管理解決方案等；常見的買家場景有：采購解決方案，跨境采購解決方案，社交電商解決方案等。

    另外，我們還開放專業(yè)智能技術(shù)作為特色增值能力，通過將人工智能和垂直產(chǎn)業(yè)相結(jié)合，幫助合作伙伴用技術(shù)手段在產(chǎn)品價(jià)值，如智能摳圖，智能搜索等；

<
最可能同場景使用的其他API
>
API接口列表
<
使用指南
>

一、注冊成為開發(fā)者

注冊開發(fā)者身份，需同時具備以下兩個條件

1、具備一個阿里巴巴中國站帳號

2、必須綁定了通過個人或者企業(yè)實(shí)名認(rèn)證的支付寶帳號；個人開發(fā)者必須綁定通過個人實(shí)名認(rèn)證的支付寶賬號，企業(yè)開發(fā)者必須綁定通過商家認(rèn)證的支付寶賬號

具備這兩個條件之后就可以在1688開放平臺注冊成為開發(fā)者

 

二、注冊應(yīng)用

注冊成為開發(fā)者之后就可以在1688開放平臺上注冊應(yīng)用

應(yīng)用注冊成功后isv可以獲得此app的關(guān)鍵信息，包括appkey、app密鑰以及流量上限（5000）。

注意：appkey和app密鑰相當(dāng)于用戶名和密碼，請不要隨意泄露

 

三、開發(fā)測試

說明：如果你的web app要在阿里巴巴應(yīng)用市場售賣，那么請選擇“托管式授權(quán)”，否則請選擇“WEB授權(quán)”；如果是客戶端app，請選擇“客戶端授權(quán)”。請參考授權(quán)分類

1、托管式授權(quán)方式： 
對于托管式授權(quán)開發(fā)方式而言，您的app需要與應(yīng)用市場配合完成授權(quán)過程，那么您可以參考如下授權(quán)流程編寫代碼

（1）用戶授權(quán)以及api調(diào)用，對應(yīng)圖中黃色部分。用戶通過應(yīng)用市場訂購你的app然后初次訪問時，應(yīng)用市場會302跳轉(zhuǎn)到你的app入口url，同時帶上參數(shù)code。 所以代碼中不需要涉及獲取code這一步，只需要使用getToken接口拿應(yīng)用市場傳過來的code換取accessToken， 并將getToken返回信息保存下來， 然后用返回信息中的accessToken作為參數(shù)調(diào)用api（參考 API調(diào)用說明 ） 在app測試過程中可以通過 授權(quán)測試工具 生成一個code，然后作為參數(shù)訪問應(yīng)用入口即可測試。 
注意：必須以getToken返回信息中的refreshToken為主，如果跟本地保存的refreshToken不一樣，那么本地的refreshToken廢棄。

（2）特殊情況處理，對應(yīng)圖中綠色部分。主要是accessToken失效的處理。 如果accessToken失效，那么就需要用保存的refreshToken調(diào)用getToken接口生成一個新的accessToken；

（3）錯誤處理，對應(yīng)圖中紅色部分。如果出現(xiàn)簽名錯誤、時間戳錯誤等異常情況，最好是能夠在日志中記錄當(dāng)前調(diào)用的url以及參數(shù)，這樣即使在出現(xiàn)問題時也能快速查找并解決問題。（參考 常見問題 ）

 

2、WEB授權(quán)方式：

對于WEB授權(quán)開發(fā)方式而言，您的app不會在阿里巴巴應(yīng)用市場售賣，那么您需要完成完整的授權(quán)過程，請參考如下授權(quán)流程

（1）用戶授權(quán)。請按照授權(quán)說明中的WEB授權(quán)流程編寫具體代碼。

（2）特殊情況處理。主要是accessToken失效以及refreshToken過期的處理。 如果accessToken失效，那么就需要用保存的refreshToken調(diào)用getToken接口生成一個新的accessToken； 如果refreshToken失效，那么需要重新進(jìn)行第一步。

（3）錯誤處理。如果出現(xiàn)簽名錯誤、時間戳錯誤等api調(diào)用失敗的情況，最好是能夠在日志中記錄當(dāng)前調(diào)用的url以及參數(shù)，這樣即使在出現(xiàn)問題時也能快速查找并解決問題。（參考常見問題）

 

3、客戶端授權(quán)方式

對于客戶端授權(quán)開發(fā)方式而言，跟WEB授權(quán)類似，也需要完成完整的授權(quán)過程，請參考如下授權(quán)流程

（1）用戶授權(quán)。請按照授權(quán)說明中的客戶端授權(quán)流程編寫具體代碼

（2）特殊情況處理。主要是accessToken失效以及refreshToken過期的處理。 如果accessToken失效，那么就需要用保存的refreshToken調(diào)用getToken接口生成一個新的accessToken； 如果refreshToken失效，那么需要重新進(jìn)行第一步。

（3）錯誤處理。如果出現(xiàn)簽名錯誤、時間戳錯誤等api調(diào)用失敗的情況，最好是能夠在日志中記錄當(dāng)前調(diào)用的url以及參數(shù)，這樣即使在出現(xiàn)問題時也能快速查找并解決問題。（參考常見問題）

 

四、提交申請

應(yīng)用測試無誤后還需要填寫更為詳細(xì)的app信息才能提交上線申請

1、如果您的app需要在應(yīng)用市場在線售賣，那么審核通過后會在應(yīng)用市場進(jìn)行上架配置；

2、如果您的app是通過自有渠道銷售或者僅供自用，那么審核通過后在應(yīng)用市場不顯示。

注意：app提交審核之后將無法修改，請確認(rèn)app測試通過并且重要信息填寫無誤后再提交審核 

 

五、審核并上線

提交審核申請之后，阿里巴巴工作人員會在一周內(nèi)進(jìn)行審核

如果審核通過則可在相關(guān)平臺提供服務(wù)；如果不通過，需要isv修改app然后再次提交申請

應(yīng)用審核關(guān)注的重點(diǎn)是應(yīng)用功能和安全性，請isv關(guān)注應(yīng)用接入審核規(guī)則

app審核通過并在應(yīng)用市場配置后即可上線，有以下兩點(diǎn)需要注意

1、app流量上限由原來的5000增加到100000，如果在app使用過程中發(fā)現(xiàn)流量不夠，可以向開放平臺申請擴(kuò)充

2、app的基本信息中有部分信息可以修改，包括應(yīng)用簡介、應(yīng)用詳情、客服旺旺、客服郵箱以及客服電話。修改后同樣需要提交審核才能正式生效。

詳情參考：https://open.1688.com/api/apidoclist.htm?id=624392

<
依賴服務(wù)
>
<
產(chǎn)品問答
>
?
通過瀏覽器訪問直接報(bào)500錯誤
很有可能是使用ie瀏覽器的原因，建議使用chrome或者firefox瀏覽器，這樣可以清晰地看到返回的錯誤信息
?
簽名錯誤
返回結(jié)果為：{"error_code":400,"error_message":"com.alibaba.openapi.gateway.exceptions.RequestValidateException:Invalid signature.","exception":"com.alibaba.openapi.gateway.exceptions.RequestValidateException: Invalid signature."} a. 如果請求參數(shù)中帶中文或者日期（如：20120228212041422+0800），所有參數(shù)需在UrlEncode之前計(jì)算簽名，也就是用原始的參數(shù)計(jì)算簽名；簽名完成后，在請求前應(yīng)對參數(shù)用utf-8進(jìn)行UrlEncode，再訪問阿里巴巴開放平臺。可以使用簽名測試工具測試簽名的正確性 b. 如果根據(jù)當(dāng)前url和請求參數(shù)計(jì)算的簽名和簽名測試工具一致，那么只可能是傳到后端服務(wù)的參數(shù)與代碼中的參數(shù)不一致，可能原因是使用 get請求的參數(shù)內(nèi)容太長（換成post請求試試），也可能是特殊字符的編碼格式不對（設(shè)置Content-type為"application/x-www-form-urlencoded; charset=UTF-8"試試） c. 如果請求中涉及文件上傳，文件字節(jié)流參數(shù)不參與簽名計(jì)算；另外，需指定請求的form enctype屬性為multipart/form-data
?
app訪問頻率超限
返回信息{"error_code":"403","error_message":"Beyond the app call frequency limit","exception":"Beyond the app call frequency limit"} 通常app都會有訪問頻率的限制，可以在阿里巴巴開放平臺開發(fā)者中心看到自己的app的每日調(diào)用頻率上限， 這個值代表單臺服務(wù)器24小時內(nèi)訪問的頻率上限。一旦在某一臺服務(wù)器上通過此app調(diào)用api 的次數(shù)超過這個上限，那么就會報(bào)這個錯誤，這時候需要聯(lián)系開放平臺管理員修改調(diào)用頻率上限。
?
app怎么獲取臨時令牌code
對于托管式授權(quán)方式，由于app托管在應(yīng)用市場，那么用戶在進(jìn)入app應(yīng)用時，阿里巴巴開放平臺會302跳轉(zhuǎn)到app的入口地址，同時會附帶參數(shù)code。App在跳轉(zhuǎn)的http請求中，可取得此參數(shù)。 對于客戶端或者web端授權(quán)方式，需要app自己發(fā)起獲取code的請求，用戶登錄成功后就會返回code。
?
code錯誤
返回結(jié)果為：{"error":"invalid_request","error_description":"wrong authorizationCode:cb681549-c8de-441c-b96b-e0e224fb28e0"} 可能原因： a. code已失效，為了保證用戶數(shù)據(jù)安全，臨時令牌code的有效期為2分鐘。App在獲得令牌后，需同步調(diào)用getToken接口，獲取token。 b. 用該code多次獲取token。code為一次性消費(fèi)的臨時令牌，調(diào)用一次getToken后，此臨時令牌便已失效。 c. 獲取code使用的appKey和獲取token使用的appKey不一致。
?
未使用post調(diào)用getToken接口
返回結(jié)果為：{"error":"invalid_request","error_description":"Method not set to POST."} oauth2協(xié)議規(guī)定，getToken必須為post提交
?
未使用https調(diào)用getToken接口
返回結(jié)果為：{"error_code":"400","error_message":"API unsupport the channel: http.","exception":"API unsupport the channel: http."} getToken必須為https請求
?
調(diào)用getToken接口時缺少redirect_uri參數(shù)
返回結(jié)果為：{"error":"invalid_request","error_description":"Missing parameters: redirect_uri"} getToken的參數(shù)中redirect_uri必須要填
?
缺少簽名
返回結(jié)果為：{"error_code":"401","error_message":"Request need signature","exception":"Request need signature"} 原因是當(dāng)前訪問的api 需要簽名，但是傳入的參數(shù)中沒有_aop_signature。在調(diào)用api 時要注意看文檔中的系統(tǒng)級輸入?yún)?shù)，在其中可以看到請求簽名是否必須
?
accessToken過期
返回結(jié)果為：{"error_code":"401","error_message":"Request need user authorized","exception":"Request need user authorized"} 原因是傳入的參數(shù)access_token已經(jīng)過期，需要用refreshToken重新?lián)Q取accessToken。
?
沒有授權(quán)
返回結(jié)果為：{"error_code":"401","error_message":"Request need user authenticated","exception":"Request need user authenticated"} 原因是當(dāng)前訪問的api 需要用戶授權(quán)才能訪問，但是沒有傳入?yún)?shù)access_token。在調(diào)用api 時要注意看對于api 文檔中的"API用戶授權(quán)類型"，在其中可以看到是否需要授權(quán)。
?
refreshToken錯誤
返回結(jié)果為：{"error":"invalid_request","error_description":"wrong refreshToken"} 原因一般有兩種：refreshToken錯誤，refreshToken過期
?
沒有傳refreshToken參數(shù)
返回結(jié)果為：{"error":"invalid_request","error_description":"Missing parameters: refresh_token"} 原因是在用refreshToken換accessToken時refreshToken參數(shù)為空，請檢查post請求的refreshToken參數(shù)是否遺漏
?
密鑰校驗(yàn)不通過
返回結(jié)果為：{"error":"unauthorized_client","error_description":"getToken secret error! client_id: YOUR_APPKEY"} 原因是在使用getToken接口時傳入的client_secret參數(shù)跟client_id不匹配，也就是沒有傳入client_id（appkey）對應(yīng)的密鑰，導(dǎo)致后臺在校驗(yàn)密鑰時發(fā)現(xiàn)與預(yù)期的密鑰不符，所以報(bào)錯。 可能原因有以下兩種：一是傳入的client_secret錯誤，二是傳入了正確的密鑰但是在post調(diào)用時沒有進(jìn)行urlencode。
?
時間戳錯誤
返回結(jié)果為{"error_code":"400","error_message":"com.alibaba.openapi.exception.request.RequestValidateException: Request is expired.","exception":"com.alibaba.openapi.exception.request.RequestValidateException: Request is expired."} 時間戳參數(shù)代表著訪問api 的時間，只要傳入了這個參數(shù)，那么每次訪問時系統(tǒng)都會把這個參數(shù)與當(dāng)前時間進(jìn)行對比，如果二者相差超過了時間戳誤差的話，就會報(bào)這個錯誤。 所以對于這個時間戳參數(shù)有三點(diǎn)需要注意：（1）首先要閱讀api文檔的系統(tǒng)級輸入?yún)?shù)一節(jié)，看api 的訪問是否需要時間戳，如果不需要就沒有必要傳入這個參數(shù)。（2）如果api 要求必須傳入時間戳，那么最好是先進(jìn)行時間校準(zhǔn)然后再調(diào)用api。（3）時間戳的內(nèi)容為時間的毫秒值，在java中轉(zhuǎn)換方式為new Date().getTime()，其他編程語言也有類似的轉(zhuǎn)換方式 時間戳校準(zhǔn)方法：調(diào)用currentTime接口（http://gw.open.1688.com/openapi/param2/1/system/currentTime/{YOUR_APP_KEY}）獲取系統(tǒng)時間，然后跟本地取到的當(dāng)前時間對比取二者的差，這樣就得到了本地時間與阿里巴巴服務(wù)器的時間差；然后在調(diào)用api 時把當(dāng)前時間加上這個時間差作為時間戳參數(shù)
?
缺少時間戳參數(shù)
返回結(jié)果為{"error_code":"400","error_message":"API need time stamp verify, so request must has _aop_timestamp. ","exception":"API need time stamp verify, so request must has _aop_timestamp. "} 原因是api 必須要有時間戳參數(shù)，但是調(diào)用時沒有傳入這個參數(shù)
?
調(diào)用api 時使用的appkey不存在或者未通過審核
返回結(jié)果為{"error_code":"400","error_message":"com.alibaba.openapi.exception.request.RequestValidateException: Invalid appKey, unsport appKey: xxx","exception":"com.alibaba.openapi.exception.request.RequestValidateException: Invalid appKey, unsport appKey: xxx"} 對應(yīng)的app不存在或者未通過審核
<
關(guān)于我們
>
阿里巴巴開放平臺是面向1688商家及采購代發(fā)買家的電商管理需求，提供基于大數(shù)據(jù)的快捷、高效應(yīng)用工具。平臺涵蓋流量推廣、跨境電商、鋪貨分銷、貨源推薦等業(yè)務(wù)場景解決方案，同時提供API開發(fā)能力，支持會員、商品、旺鋪、訂單、支付、物流等服務(wù)。已合作服務(wù)商超過1600家，致力于幫助中小企業(yè)實(shí)現(xiàn)電商業(yè)務(wù)的高效管理。
聯(lián)系信息
服務(wù)時間： 09:00--18:00
電話號碼： 400-800-1688

文化和價(jià)值觀

使命
讓天下沒有難做的生意。
愿景
追求成為一家活102年的好公司。我們的愿景是讓客戶相會、工作和生活在阿里巴巴。
 
價(jià)值觀
客戶第一，員工第二，股東第三
因?yàn)樾湃危院唵?/div>
唯一不變的是變化
今天最好的表現(xiàn)是明天最低的要求
此時此刻，非我莫屬
認(rèn)真生活，快樂工作
 
里程碑
阿里巴巴集團(tuán)由曾擔(dān)任英語教師的馬云與其他來自不同背景的伙伴共18人，于1999年在中國杭州創(chuàng)立。從一開始，所有創(chuàng)始人就深信互聯(lián)網(wǎng)能夠創(chuàng)造公平的環(huán)境，讓小企業(yè)通過創(chuàng)新與科技拓展業(yè)務(wù)，并更有效地參與中國及國際市場競爭。自推出讓中國中小企業(yè)接觸全球買家的首個網(wǎng)站以來，阿里巴巴作為控股公司持有六大業(yè)務(wù)集團(tuán)：淘天集團(tuán)、阿里國際數(shù)字商業(yè)集團(tuán)、云智能集團(tuán)、本地生活集團(tuán)、菜鳥集團(tuán)、大文娛集團(tuán)，以及各種其他業(yè)務(wù)。

關(guān)于1688開放平臺

   1688開放平臺，依托B2B海量用戶資源以及強(qiáng)大的平臺優(yōu)勢，是為阿里巴巴買賣家提供開放服務(wù)的重要平臺，幫助商家提升經(jīng)營能力、拓寬生意渠道、提高辦公效率；幫助買家提升選品、下單效率，降低采購成本等。

   

   我們致力于為企業(yè)構(gòu)建智能經(jīng)營服務(wù)網(wǎng)絡(luò)，開放和集成企業(yè)經(jīng)營生命周期所需的專業(yè)服務(wù)，解決企業(yè)經(jīng)營問題。賦能生態(tài)伙伴以靈活、安全及低成本形式進(jìn)行系統(tǒng)對接，信息互聯(lián)。

 

我們服務(wù)哪些伙伴

    1688開放平臺服務(wù)兩類最基礎(chǔ)的伙伴，為買賣家提供服務(wù)工具的1688服務(wù)商（isv），以及有1688電商系統(tǒng)對接需求并有開發(fā)能力的買賣家。

    · 第一種 - 合作伙伴銷售服務(wù)模式：服務(wù)商伙伴使用開放平臺的場景解決方案（api）開發(fā)工具或服務(wù)，并在1688服務(wù)市場售賣給買賣家。提供包括但不限于電商經(jīng)營所需的管理工具和買家采購提效工具或服務(wù)，如商品管理，訂單管理，電商ERP等工具。

    · 第二種 - 買賣家自開發(fā)模式：有開發(fā)能力的1688商家或買家，使用平臺解決方案，開發(fā)滿足自身電商場景所需的工具，如買家采購場景，以及部分垂直業(yè)務(wù)的開放場景，如跨境電商、社交電商等，此場景僅限企業(yè)用戶自開發(fā)自使用，禁止私自線下售賣或授權(quán)其他企業(yè)使用，如因此產(chǎn)生的數(shù)據(jù)泄漏、法律責(zé)任由開發(fā)者全權(quán)承擔(dān)。

 

我們將提供哪些服務(wù)

    我們?yōu)橐陨祥_發(fā)者伙伴提供了基礎(chǔ)的產(chǎn)品研發(fā)平臺，包括組成場景解決方案的API，消息，介紹，幫助文檔等，以及研發(fā)輔助相關(guān)的測試工具、咨詢工具、信息反饋渠道等，幫助合作伙伴解決研發(fā)問題。

    我們開放的解決方案主要是圍繞商家電商經(jīng)營和買家采購場景，如常見的商家場景有：訂單管理解決方案、商品管理解決方案等；常見的買家場景有：采購解決方案，跨境采購解決方案，社交電商解決方案等。

    另外，我們還開放專業(yè)智能技術(shù)作為特色增值能力，通過將人工智能和垂直產(chǎn)業(yè)相結(jié)合，幫助合作伙伴用技術(shù)手段在產(chǎn)品價(jià)值，如智能摳圖，智能搜索等；

<
最可能同場景使用的其他API
>