shopee v1&v2 API辨别方式、授权和验证-ESG跨境

基本说明

串接前评估

若欲查看Open API平台相关介绍和API功能，请查看此说明事项。

或请贵司的工程师参考此平台文件，以评估您预期欲使用的功能是否可透过本API串接达成。

使用资格说明

目前TW Shopee Open API只提供给商城卖家或是第三方系统供货商(e.g. ERP供货商)，不符合资格将无法申请成功。

●   若您为自行开发自家系统或是有自有工程师协助串接，请透过此文件说明注册开发者账号和卖场授权。

●   若你的系统为委外开发或由第三方系统商协助串接，请先与您的系统商联络，协助您完成串接，不需继续本文件以下教

●   若您为系统供货商，欲申请密钥为您的客户做串接，请先填写此窗体并至开放平台提交正确的开发者信息，后再依说明流程申请密钥。

●   另外，若于一周内未收到通知，则为资格不符，将不另行通知。

开发者类型说明

v2.0调整成四种开发者类型，每个开发者类型可使用的API不尽相同，每个开发类型对应的API请见"开发者类型对应API说明"。

此部分在申请开发者账号时需选定，账号申请请见"开发者信息"。开发者类型如下：

旧开发者类型转移说明

在 Open Paltform 2.0上线前(即2020/09/10前)注册的旧开发者，将对应2.0的开发者类型如下：

旧开发者APP处理说明

在 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，如下表：

v1&v2 API授权和验证

为了保护Shopee OpenPlatform免受潜在的漏洞影响并更好地保护开发人员的机密性，OpenAPI 2.0（v2）引入了更新方法来授权商店和验证API请求。授权方法相关说明，请务必阅读。

v2方法只能应用于v2 API，而v1方法只能应用于v1 API。v1 / v2 API可以通过API网址进行区分，如上述判别方式。

问题排除方法

若您串接时遇到问题，建议可先查找F&Q。

若仍无法解决您的问题，请来信openapi@support..com或是联系您的客户经理且提供以下信息。

●   对应的问题描述:

●   所使用的对应环境:

●   所使用的对应API接口:

●   所使用的对应request body及所属站点:

●   调用接口之后所得到的对应返回req_id（具体时间）及对应返回的信息（错误代码和错误信息）:

基本說明

串接前評估

若欲查看Open API平臺相關介紹和API功能，請查看此說明事項。

或請貴司的工程師參考此平臺檔，以評估您預期欲使用的功能是否可透過本API串接達成。

使用資格說明

目前TW Shopee Open API只提供給商城賣家或是協力廠商系統供應商(e.g. ERP供應商)，不符合資格將無法申請成功。

●   若您為自行開發自家系統或是有自有工程師協助串接，請透過此文件說明註冊開發者帳號和賣場授權。

●   若你的系統為委外開發或由協力廠商系統商協助串接，請先與您的系統商聯絡，協助您完成串接，不需繼續本檔以下教

●   若您為系統供應商，欲申請金鑰為您的客戶做串接，請先填寫此表單並至開放平臺提交正確的開發者資訊，後再依說明流程申請金鑰。

●   另外，若于一周內未收到通知，則為資格不符，將不另行通知。

開發者類型說明

v2.0調整成四種開發者類型，每個開發者類型可使用的API不盡相同，每個開發類型對應的API請見"開發者類型對應API說明"。

此部分在申請開發者帳號時需選定，帳號申請請見"開發者資訊"。開發者類型如下：

舊開發者類型轉移說明

在Shopee Open Paltform 2.0上線前(即2020/09/10前)註冊的舊開發者，將對應2.0的開發者類型如下：

舊開發者APP處理說明

在 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，如下表：

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（具體時間）及對應返回的資訊（錯誤代碼和錯誤資訊）:

特别声明：以上文章内容仅代表作者本人观点，不代表ESG跨境电商观点或立场。如有关于作品内容、版权或其它问题请于作品发表后的30日内与ESG跨境电商联系。