阿里1688開放平臺

阿里1688開放平臺

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

什么是阿里1688開放平臺?

阿里1688開放平臺是面對1688商家及采購代發買家日益繁雜的電商管理需求,基于大數據提供快捷、高效的應用工具。

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

由服務使用方的應用程序發起,以Restful風格為主、通過公網HTTP協議調用阿里1688開放平臺,從而實現程序的自動化交互,提高服務效率。

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

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

阿里1688開放平臺的核心優勢是什么?

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

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

跨境電商

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

鋪貨分銷

面向在下游電商或內容平臺(如淘寶/抖音/快手/小紅書/微信)開店的分銷商,通過結合ISV數據化技術能力,實現1688優質代發貨源一鍵智能多店鋪貨、下游訂單自動回流采購,自動發貨,幫助下游賣家輕松實現1688代發采購對接

貨源推薦

提供一件代發包郵、48小時內發貨、7天包退等優質代發服務保障貨源品池,同時商品價格較下游零售面價平均低20%以上,結合ISV的用戶觸達渠道,幫助1688代發分銷買家實現更高利潤空間的優質貨源采購對接

<
使用指南
>

一、注冊成為開發者

注冊開發者身份,需同時具備以下兩個條件

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

2、必須綁定了通過個人或者企業實名認證的支付寶帳號;個人開發者必須綁定通過個人實名認證的支付寶賬號,企業開發者必須綁定通過商家認證的支付寶賬號

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

 

二、注冊應用

注冊成為開發者之后就可以在1688開放平臺上注冊應用

應用注冊成功后isv可以獲得此app的關鍵信息,包括appkey、app密鑰以及流量上限(5000)。

注意:appkey和app密鑰相當于用戶名和密碼,請不要隨意泄露

 

三、開發測試

說明:如果你的web app要在阿里巴巴應用市場售賣,那么請選擇“托管式授權”,否則請選擇“WEB授權”;如果是客戶端app,請選擇“客戶端授權”。請參考授權分類

1、托管式授權方式: 
對于托管式授權開發方式而言,您的app需要與應用市場配合完成授權過程,那么您可以參考如下授權流程編寫代碼

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

(2)特殊情況處理,對應圖中綠色部分。主要是accessToken失效的處理。 如果accessToken失效,那么就需要用保存的refreshToken調用getToken接口生成一個新的accessToken;

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

 

2、WEB授權方式:

對于WEB授權開發方式而言,您的app不會在阿里巴巴應用市場售賣,那么您需要完成完整的授權過程,請參考如下授權流程

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

(2)特殊情況處理。主要是accessToken失效以及refreshToken過期的處理。 如果accessToken失效,那么就需要用保存的refreshToken調用getToken接口生成一個新的accessToken; 如果refreshToken失效,那么需要重新進行第一步。

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

 

3、客戶端授權方式

對于客戶端授權開發方式而言,跟WEB授權類似,也需要完成完整的授權過程,請參考如下授權流程

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

(2)特殊情況處理。主要是accessToken失效以及refreshToken過期的處理。 如果accessToken失效,那么就需要用保存的refreshToken調用getToken接口生成一個新的accessToken; 如果refreshToken失效,那么需要重新進行第一步。

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

 

四、提交申請

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

1、如果您的app需要在應用市場在線售賣,那么審核通過后會在應用市場進行上架配置;

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

注意:app提交審核之后將無法修改,請確認app測試通過并且重要信息填寫無誤后再提交審核 

 

五、審核并上線

提交審核申請之后,阿里巴巴工作人員會在一周內進行審核

如果審核通過則可在相關平臺提供服務;如果不通過,需要isv修改app然后再次提交申請

應用審核關注的重點是應用功能和安全性,請isv關注應用接入審核規則

app審核通過并在應用市場配置后即可上線,有以下兩點需要注意

1、app流量上限由原來的5000增加到100000,如果在app使用過程中發現流量不夠,可以向開放平臺申請擴充

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

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

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

文化和價值觀

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

關于1688開放平臺

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

   

   我們致力于為企業構建智能經營服務網絡,開放和集成企業經營生命周期所需的專業服務,解決企業經營問題。賦能生態伙伴以靈活、安全及低成本形式進行系統對接,信息互聯。

 

我們服務哪些伙伴

    1688開放平臺服務兩類最基礎的伙伴,為買賣家提供服務工具的1688服務商(isv),以及有1688電商系統對接需求并有開發能力的買賣家。

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

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

 

我們將提供哪些服務

    我們為以上開發者伙伴提供了基礎的產品研發平臺,包括組成場景解決方案的API,消息,介紹,幫助文檔等,以及研發輔助相關的測試工具、咨詢工具、信息反饋渠道等,幫助合作伙伴解決研發問題。

    我們開放的解決方案主要是圍繞商家電商經營和買家采購場景,如常見的商家場景有:訂單管理解決方案、商品管理解決方案等;常見的買家場景有:采購解決方案,跨境采購解決方案,社交電商解決方案等。

    另外,我們還開放專業智能技術作為特色增值能力,通過將人工智能和垂直產業相結合,幫助合作伙伴用技術手段在產品價值,如智能摳圖,智能搜索等;

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

一、注冊成為開發者

注冊開發者身份,需同時具備以下兩個條件

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

2、必須綁定了通過個人或者企業實名認證的支付寶帳號;個人開發者必須綁定通過個人實名認證的支付寶賬號,企業開發者必須綁定通過商家認證的支付寶賬號

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

 

二、注冊應用

注冊成為開發者之后就可以在1688開放平臺上注冊應用

應用注冊成功后isv可以獲得此app的關鍵信息,包括appkey、app密鑰以及流量上限(5000)。

注意:appkey和app密鑰相當于用戶名和密碼,請不要隨意泄露

 

三、開發測試

說明:如果你的web app要在阿里巴巴應用市場售賣,那么請選擇“托管式授權”,否則請選擇“WEB授權”;如果是客戶端app,請選擇“客戶端授權”。請參考授權分類

1、托管式授權方式: 
對于托管式授權開發方式而言,您的app需要與應用市場配合完成授權過程,那么您可以參考如下授權流程編寫代碼

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

(2)特殊情況處理,對應圖中綠色部分。主要是accessToken失效的處理。 如果accessToken失效,那么就需要用保存的refreshToken調用getToken接口生成一個新的accessToken;

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

 

2、WEB授權方式:

對于WEB授權開發方式而言,您的app不會在阿里巴巴應用市場售賣,那么您需要完成完整的授權過程,請參考如下授權流程

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

(2)特殊情況處理。主要是accessToken失效以及refreshToken過期的處理。 如果accessToken失效,那么就需要用保存的refreshToken調用getToken接口生成一個新的accessToken; 如果refreshToken失效,那么需要重新進行第一步。

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

 

3、客戶端授權方式

對于客戶端授權開發方式而言,跟WEB授權類似,也需要完成完整的授權過程,請參考如下授權流程

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

(2)特殊情況處理。主要是accessToken失效以及refreshToken過期的處理。 如果accessToken失效,那么就需要用保存的refreshToken調用getToken接口生成一個新的accessToken; 如果refreshToken失效,那么需要重新進行第一步。

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

 

四、提交申請

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

1、如果您的app需要在應用市場在線售賣,那么審核通過后會在應用市場進行上架配置;

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

注意:app提交審核之后將無法修改,請確認app測試通過并且重要信息填寫無誤后再提交審核 

 

五、審核并上線

提交審核申請之后,阿里巴巴工作人員會在一周內進行審核

如果審核通過則可在相關平臺提供服務;如果不通過,需要isv修改app然后再次提交申請

應用審核關注的重點是應用功能和安全性,請isv關注應用接入審核規則

app審核通過并在應用市場配置后即可上線,有以下兩點需要注意

1、app流量上限由原來的5000增加到100000,如果在app使用過程中發現流量不夠,可以向開放平臺申請擴充

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

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

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

文化和價值觀

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

關于1688開放平臺

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

   

   我們致力于為企業構建智能經營服務網絡,開放和集成企業經營生命周期所需的專業服務,解決企業經營問題。賦能生態伙伴以靈活、安全及低成本形式進行系統對接,信息互聯。

 

我們服務哪些伙伴

    1688開放平臺服務兩類最基礎的伙伴,為買賣家提供服務工具的1688服務商(isv),以及有1688電商系統對接需求并有開發能力的買賣家。

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

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

 

我們將提供哪些服務

    我們為以上開發者伙伴提供了基礎的產品研發平臺,包括組成場景解決方案的API,消息,介紹,幫助文檔等,以及研發輔助相關的測試工具、咨詢工具、信息反饋渠道等,幫助合作伙伴解決研發問題。

    我們開放的解決方案主要是圍繞商家電商經營和買家采購場景,如常見的商家場景有:訂單管理解決方案、商品管理解決方案等;常見的買家場景有:采購解決方案,跨境采購解決方案,社交電商解決方案等。

    另外,我們還開放專業智能技術作為特色增值能力,通過將人工智能和垂直產業相結合,幫助合作伙伴用技術手段在產品價值,如智能摳圖,智能搜索等;

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