基本说明

串接前评估

若欲查看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官方网站