基本说明
串接前评估
若欲查看Open API平台相关介绍和API功能,请查看此说明事项。
或请贵司的工程师参考此平台文件,以评估您预期欲使用的功能是否可透过本API串接达成。
使用资格说明
目前TW Shopee Open API只提供给商城卖家或是第三方系统供货商(e.g. ERP供货商),不符合资格将无法申请成功。
● 若您为自行开发自家系统或是有自有工程师协助串接,请透过此文件说明注册开发者账号和卖场授权。
● 若你的系统为委外开发或由第三方系统商协助串接,请先与您的系统商联络,协助您完成串接,不需继续本文件以下教
● 若您为系统供货商,欲申请密钥为您的客户做串接,请先填写此窗体并至开放平台提交正确的开发者信息,后再依说明流程申请密钥。
● 另外,若于一周内未收到通知,则为资格不符,将不另行通知。
开发者类型说明
v2.0调整成四种开发者类型,每个开发者类型可使用的API不尽相同,每个开发类型对应的API请见"开发者类型对应API说明"。
此部分在申请开发者账号时需选定,账号申请请见"开发者信息"。开发者类型如下:
开发者类型 | 说明 |
第三方企业开发者 (Enterprise 3rd Party) | 第三方开发者,非Shopee卖家 |
商城卖家 (Enterprise Seller) | 商城卖家自行开发 |
第三方个人开发者 (Individual 3rd Party) | 第三方个人开发者,非Shopee卖家 请注意!TW仅开放给第三方企业开发者和商城卖家,不包含此类卖家。 |
非商城卖家 (Individual Seller) | 一般卖家自行开发请注意!TW仅开放给第三方企业开发者和商城卖家,不包含此类卖家。 |
旧开发者类型转移说明
在Shopee Open Paltform 2.0上线前(即2020/09/10前)注册的旧开发者,将对应2.0的开发者类型如下:
旧开发者类型 | 对应的2.0开发者类型 |
third party erp | 第三方企业开发者 (Enterprise 3rd Party) |
own system | 商城卖家(商城卖家自行开发) |
旧开发者APP处理说明
在Shopee Open Paltform 2.0上线前(即2020/09/10前)建立的APP将会有如下变化:
● Approve状态的APP,2.0上线后APP类型为原始(Original)类型,接口权限不变,拥有所有v1 API的权限。
● Audting/Reject状态的APP,将会移除,需要开发者重新建立APP,创建流程参考"建立APP"。
v1&v2 API辨别方式
可透过呼叫网址判断该API是v1或v2,如下表:
API呼叫网址 |
https://partner.shopeemobile.com/api/v1/item/add |
https://partner.shopeemobile.com/api/v2/shop/cancel_auth_partner |
v1&v2 API授权和验证
为了保护Shopee OpenPlatform免受潜在的漏洞影响并更好地保护开发人员的机密性,OpenAPI 2.0(v2)引入了更新方法来授权商店和验证API请求。授权方法相关说明,请务必阅读。
v2方法只能应用于v2 API,而v1方法只能应用于v1 API。v1 / v2 API可以通过API网址进行区分,如上述判别方式。
问题排除方法
若您串接时遇到问题,建议可先查找F&Q。
若仍无法解决您的问题,请来信openapi@support.shopee.com或是联系您的客户经理且提供以下信息。
● 对应的问题描述:
● 所使用的对应环境:
● 所使用的对应API接口:
● 所使用的对应request body及所属站点:
● 调用接口之后所得到的对应返回req_id(具体时间)及对应返回的信息(错误代码和错误信息):
shopee官网原文详情:
基本說明
串接前評估
若欲查看Open API平臺相關介紹和API功能,請查看此說明事項。
或請貴司的工程師參考此平臺檔,以評估您預期欲使用的功能是否可透過本API串接達成。
使用資格說明
目前TW Shopee Open API只提供給商城賣家或是協力廠商系統供應商(e.g. ERP供應商),不符合資格將無法申請成功。
● 若您為自行開發自家系統或是有自有工程師協助串接,請透過此文件說明註冊開發者帳號和賣場授權。
● 若你的系統為委外開發或由協力廠商系統商協助串接,請先與您的系統商聯絡,協助您完成串接,不需繼續本檔以下教
● 若您為系統供應商,欲申請金鑰為您的客戶做串接,請先填寫此表單並至開放平臺提交正確的開發者資訊,後再依說明流程申請金鑰。
● 另外,若于一周內未收到通知,則為資格不符,將不另行通知。
開發者類型說明
v2.0調整成四種開發者類型,每個開發者類型可使用的API不盡相同,每個開發類型對應的API請見"開發者類型對應API說明"。
此部分在申請開發者帳號時需選定,帳號申請請見"開發者資訊"。開發者類型如下:
開發者類型
說明
協力廠商企業開發者
(Enterprise 3rd Party)
協力廠商開發者,非Shopee賣家
商城賣家
(Enterprise Seller)
商城賣家自行開發
協力廠商個人開發者
(Individual 3rd Party)
協力廠商個人開發者,非Shopee賣家
請注意!TW僅開放給協力廠商企業開發者和商城賣家,不包含此類賣家。
非商城賣家
(Individual Seller)
一般賣家自行開發請注意!TW僅開放給協力廠商企業開發者和商城賣家,不包含此類賣家。
舊開發者類型轉移說明
在Shopee Open Paltform 2.0上線前(即2020/09/10前)註冊的舊開發者,將對應2.0的開發者類型如下:
舊開發者類型
對應的2.0開發者類型
third party erp
協力廠商企業開發者 (Enterprise 3rd Party)
own system
商城賣家(商城賣家自行開發)
舊開發者APP處理說明
在Shopee Open Paltform 2.0上線前(即2020/09/10前)建立的APP將會有如下變化:
● Approve狀態的APP,2.0上線後APP類型為原始(Original)類型,介面許可權不變,擁有所有v1 API的許可權。
● Audting/Reject狀態的APP,將會移除,需要開發者重新建立APP,創建流程參考"建立APP"。
v1&v2 API辨別方式
可透過呼叫網址判斷該API是v1或v2,如下表:
API呼叫網址
https://partner.shopeemobile.com/api/v1/item/add
https://partner.shopeemobile.com/api/v2/shop/cancel_auth_partner
v1&v2 API授權和驗證
為了保護Shopee OpenPlatform免受潛在的漏洞影響並更好地保護開發人員的機密性,OpenAPI 2.0(v2)引入了更新方法來授權商店和驗證API請求。授權方法相關說明,請務必閱讀。
v2方法只能應用於v2 API,而v1方法只能應用於v1 API。v1 / v2 API可以通過API網址進行區分,如上述判別方式。
問題排除方法
若您串接時遇到問題,建議可先查找F&Q。
若仍無法解決您的問題,請來信openapi@support.shopee.com或是聯繫您的客戶經理且提供以下資訊。
● 對應的問題描述:
● 所使用的對應環境:
● 所使用的對應API介面:
● 所使用的對應request body及所屬網站:
● 調用介面之後所得到的對應返回req_id(具體時間)及對應返回的資訊(錯誤代碼和錯誤資訊):
文章来源:shopee官方网站