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

基本說明

串接前評(píng)估

若欲查看Open API平臺(tái)相關(guān)介紹和API功能，請(qǐng)查看此說明事項(xiàng)。

或請(qǐng)貴司的工程師參考此平臺(tái)文件，以評(píng)估您預(yù)期欲使用的功能是否可透過本API串接達(dá)成。

使用資格說明

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

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

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

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

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

開發(fā)者類型說明

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

此部分在申請(qǐng)開發(fā)者賬號(hào)時(shí)需選定，賬號(hào)申請(qǐng)請(qǐng)見"開發(fā)者信息"。開發(fā)者類型如下：

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

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

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

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

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

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

v1&v2 API辨別方式

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

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

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

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

問題排除方法

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

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

●   對(duì)應(yīng)的問題描述:

●   所使用的對(duì)應(yīng)環(huán)境:

●   所使用的對(duì)應(yīng)API接口:

●   所使用的對(duì)應(yīng)request body及所屬站點(diǎn):

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

基本說明

串接前評(píng)估

若欲查看Open API平臺(tái)相關(guān)介紹和API功能，請(qǐng)查看此說明事項(xiàng)。

或請(qǐng)貴司的工程師參考此平臺(tái)檔，以評(píng)估您預(yù)期欲使用的功能是否可透過本API串接達(dá)成。

使用資格說明

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

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

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

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

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

開發(fā)者類型說明

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

此部分在申請(qǐng)開發(fā)者帳號(hào)時(shí)需選定，帳號(hào)申請(qǐng)請(qǐng)見"開發(fā)者資訊"。開發(fā)者類型如下：

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

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

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

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

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

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

v1&v2 API辨別方式

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

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

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

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

問題排除方法

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

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

●   對(duì)應(yīng)的問題描述:

●   所使用的對(duì)應(yīng)環(huán)境:

●   所使用的對(duì)應(yīng)API介面:

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

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

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