shopee v1&v2 API辨別方式、授權(quán)和驗證-ESG跨境

基本說明

串接前評估

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

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

使用資格說明

目前TW Shopee Open API只提供給商城賣家或是第三方系統(tǒng)供貨商(e.g. ERP供貨商)，不符合資格將無法申請成功。

●   若您為自行開發(fā)自家系統(tǒng)或是有自有工程師協(xié)助串接，請透過此文件說明注冊開發(fā)者賬號和賣場授權(quán)。

●   若你的系統(tǒng)為委外開發(fā)或由第三方系統(tǒng)商協(xié)助串接，請先與您的系統(tǒng)商聯(lián)絡(luò)，協(xié)助您完成串接，不需繼續(xù)本文件以下教

●   若您為系統(tǒng)供貨商，欲申請密鑰為您的客戶做串接，請先填寫此窗體并至開放平臺提交正確的開發(fā)者信息，后再依說明流程申請密鑰。

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

開發(fā)者類型說明

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

此部分在申請開發(fā)者賬號時需選定，賬號申請請見"開發(fā)者信息"。開發(fā)者類型如下：

舊開發(fā)者類型轉(zhuǎn)移說明

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

舊開發(fā)者APP處理說明

在 Open Paltform 2.0上線前(即2020/09/10前)建立的APP將會有如下變化：

●   Approve狀態(tài)的APP，2.0上線后APP類型為原始(Original)類型，接口權(quán)限不變，擁有所有v1 API的權(quán)限。

●   Audting/Reject狀態(tài)的APP，將會移除，需要開發(fā)者重新建立APP，創(chuàng)建流程參考"建立APP"。

v1&v2 API辨別方式

可透過呼叫網(wǎng)址判斷該API是v1或v2，如下表：

v1&v2 API授權(quán)和驗證

為了保護Shopee OpenPlatform免受潛在的漏洞影響并更好地保護開發(fā)人員的機密性，OpenAPI 2.0（v2）引入了更新方法來授權(quán)商店和驗證API請求。授權(quán)方法相關(guān)說明，請務必閱讀。

v2方法只能應用于v2 API，而v1方法只能應用于v1 API。v1 / v2 API可以通過API網(wǎng)址進行區(qū)分，如上述判別方式。

問題排除方法

若您串接時遇到問題，建議可先查找F&Q。

若仍無法解決您的問題，請來信openapi@support..com或是聯(lián)系您的客戶經(jīng)理且提供以下信息。

●   對應的問題描述:

●   所使用的對應環(huán)境:

●   所使用的對應API接口:

●   所使用的對應request body及所屬站點:

●   調(diào)用接口之后所得到的對應返回req_id（具體時間）及對應返回的信息（錯誤代碼和錯誤信息）:

基本說明

串接前評估

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

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

使用資格說明

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

●   若您為自行開發(fā)自家系統(tǒng)或是有自有工程師協(xié)助串接，請透過此文件說明註冊開發(fā)者帳號和賣場授權(quán)。

●   若你的系統(tǒng)為委外開發(fā)或由協(xié)力廠商系統(tǒng)商協(xié)助串接，請先與您的系統(tǒng)商聯(lián)絡(luò)，協(xié)助您完成串接，不需繼續(xù)本檔以下教

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

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

開發(fā)者類型說明

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

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

舊開發(fā)者類型轉(zhuǎn)移說明

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

舊開發(fā)者APP處理說明

在 Open Paltform 2.0上線前(即2020/09/10前)建立的APP將會有如下變化：

●   Approve狀態(tài)的APP，2.0上線後APP類型為原始(Original)類型，介面許可權(quán)不變，擁有所有v1 API的許可權(quán)。

●   Audting/Reject狀態(tài)的APP，將會移除，需要開發(fā)者重新建立APP，創(chuàng)建流程參考"建立APP"。

v1&v2 API辨別方式

可透過呼叫網(wǎng)址判斷該API是v1或v2，如下表：

v1&v2 API授權(quán)和驗證

為了保護Shopee OpenPlatform免受潛在的漏洞影響並更好地保護開發(fā)人員的機密性，OpenAPI 2.0（v2）引入了更新方法來授權(quán)商店和驗證API請求。授權(quán)方法相關(guān)說明，請務必閱讀。

v2方法只能應用於v2 API，而v1方法只能應用於v1 API。v1 / v2 API可以通過API網(wǎng)址進行區(qū)分，如上述判別方式。

問題排除方法

若您串接時遇到問題，建議可先查找F&Q。

若仍無法解決您的問題，請來信openapi@support.shopee.com或是聯(lián)繫您的客戶經(jīng)理且提供以下資訊。

●   對應的問題描述:

●   所使用的對應環(huán)境:

●   所使用的對應API介面:

●   所使用的對應request body及所屬網(wǎng)站:

●   調(diào)用介面之後所得到的對應返回req_id（具體時間）及對應返回的資訊（錯誤代碼和錯誤資訊）:

特別聲明：以上文章內(nèi)容僅代表作者本人觀點，不代表ESG跨境電商觀點或立場。如有關(guān)于作品內(nèi)容、版權(quán)或其它問題請于作品發(fā)表后的30日內(nèi)與ESG跨境電商聯(lián)系。