介紹eBay的交易API-設置-php教程-PHP中文網

做到這一點，一旦您驗證了電子郵件，您將獲得類似於以下屏幕：

>我們將使用MySQL作為此應用。以下表將使用：

使用eBay的交易API時，我可能會遇到什麼常見錯誤？每個錯誤都由特定的錯誤代碼和消息表示，當發生錯誤時，響應消息中包含在響應消息中。

首頁

後端開發

php教程

介紹eBay的交易API-設置

尊渡假赌尊渡假赌尊渡假赌

Feb 18, 2025 am 10:38 AM

介紹eBay的交易API-設置

在這個教程系列中，我會帶您瀏覽eBay的交易API。交易API允許您構建可用於在eBay中銷售的應用程序。以下是您可以使用API做的一些示例：

在本教程中，我們將創建一個應用程序，允許用戶通過使用API在eBay上創建產品。

鑰匙要點

>使用開發人員工具：探索eBay的開發人員工具，例如用於測試的Sandbox帳戶和用於在不同環境中模擬API調用的API測試工具。
>數據庫設置：建立一個MySQL數據庫，並為設置，商店設置，產品等創建表格，以有效地管理應用程序數據。 >

註冊一個應用

>您需要做的第一件事是在eBay開發人員網站上註冊一個開發人員帳戶。

做到這一點，一旦您驗證了電子郵件，您將獲得類似於以下屏幕：

>：

在該頁面上，單擊“獲取應用程序鍵”鏈接，該鏈接將帶您到達可以生成沙箱和生產鍵的頁面。然後，單擊“生成沙盒密鑰”按鈕以生成可以用於測試我們將要構建的應用程序的鍵。另外，單擊“生成生產密鑰”按鈕以生成部署應用程序時可以使用的鍵。請注意，這些鍵可以與eBay提供的任何API一起使用，因此您只需要一次執行此操作。

生成鍵後，單擊任何鍵上的“配置設置”鏈接（沙盒或生產）。介紹eBay的交易API-設置 >在“自定義eBay用戶同意表”部分下，

>單擊“自定義eBay用戶同意表”鏈接。這將允許您配置應用程序使用的URL。這基本上是應用程序主頁的URL。到達那里後，在“管理您的運行符號”部分下，單擊“為應用程序生成運行Amber”鏈接。運行AMAME等同於應用程序。如果要創建將與不同的eBay API交互的不同應用，則可以為每個應用程序創建一個運行AMAME。一旦生成了運行amam，就會向您詢問以下信息：

顯示標題 - 用戶以後授予應用程序的授權時要顯示的應用程序標題。（例如產品創建者）顯示描述：顯示描述是描述您應用程序的文本。（例如，此應用程序允許用戶輕鬆地將產品添加到其eBay商店）
>
>
拒絕重定向URL用戶拒絕應用程序時將其重定向到的URL。

沙盒帳戶

>讓我們看一下Sandbox用戶註冊工具。註冊沙盒帳戶後，請訪問sandbox.ebay.com進行測試登錄。一旦您驗證了它的工作正常，請返回您的eBay開發人員帳戶頁面。

API測試工具

下一步是API測試工具。在該頁面上後，您會看到有很多選項，但是默認情況下它們已經預先填寫，因此您會了解每個字段的作用。在繼續使用此工具之前，這裡是每個字段的簡短描述：

選擇一個環境 - 這使您可以在沙箱和生產環境之間切換。通常，當您僅從API測試工具進行測試時，您需要為此使用“沙盒”。兩者之間的主要區別在於，沙箱只能與沙盒/測試eBay帳戶一起使用，並且只能與實際的eBay帳戶一起使用。
選擇一個密鑰集 - 這允許您更改將用於製作API調用的鍵。大多數情況下，您實際上不必觸摸它，因為當您選擇鑰匙已經改變的環境類型時。
選擇一個API - 這使您可以選擇要撥打呼叫的API。您可能已經知道，eBay具有不同的API：交易，查找，購物，反饋和Open API。我們主要將使用該教程的交易API，因此請繼續選擇。請注意，選擇交易API後，出現了另一組字段。它提示您生成用戶令牌或手動輸入現有的代幣。由於我們已經在較早的沙箱帳戶中創建了一個，因此我們可以單擊“生成用戶令牌”按鈕。這將把您重定向到看起來像這樣的頁面：

介紹eBay的交易API-設置

>確認為環境選擇了沙箱，然後單擊“繼續生成令牌”按鈕。這將把您重定向到Sandbox eBay網站登錄頁面。用您的沙盒登錄憑據填寫。如果登錄成功，它將將您重定向到授權頁面：

介紹eBay的交易API-設置

>同意授權該應用程序。請注意，這是eBay主要用於測試的通用應用程序。這不是我們之前創建的應用程序。之後，您將被重定向到以下頁面：

介紹eBay的交易API-設置

>您在此頁面上要做的只是複制生成的令牌，然後單擊“保存令牌”按鈕。完成此操作後，您可以返回到API測試工具頁面，然後粘貼在用戶令牌中，您剛剛複製到用戶令牌字段中。

>
選擇一個API調用 - 您要請求的API中的實際資源。您可以打出很多電話。您可以選擇任何引起您興趣的東西。
>
選擇一個模板 - 它可以具有“完整，通用”或“部分，預先填充”的值。選擇“完整的，通用”將為您提供XML請求框中的空白字段，同時選擇“部分，預填充”將為您提供一些已經填充的基本示例字段。由於我們剛剛起步，因此使用“部分，預填充”是最好的選擇，因為這已經為我們提供了我們選擇的資源所需的一些領域。例如，如果我們為API呼叫字段選擇“ getItem”，則已經為我們提供了示例itemID和警告級別，而我們要做的就是單擊XML請求Textarea下方的“提交”按鈕以便啟動請求。一旦使用API感到滿意，您就可以將值直接添加到XML請求TextArea中，以修改提交給API的實際數據。
>
>
選擇網站ID - 您可能已經知道有不同的eBay網站。該字段代表您要撥打電話的實際eBay網站。由於我們只是使用API測試工具進行測試，因此我們可以為此提供美國。
解釋不清楚的：

> x-ebay-api-call-name - 您要調用的API中的資源或方法。以下是您可以通過交易API進行的呼叫的引用。

X-EBAY-API-COMPATIBILITY-LEVEL:your-request-version
X-EBAY-API-DEV-NAME:your-dev-id
X-EBAY-API-APP-NAME:your-app-id
X-EBAY-API-CERT-NAME:your-cert-id
X-EBAY-API-SITEID:your-site-id
X-EBAY-API-CALL-NAME:YourAPICallMethod

登入後複製

> XML請求 - 您的請求正文。交易API僅支持XML和肥皂格式。但是XML看起來更簡潔，因此我們將使用XML為此。這也是API測試工具中使用的默認格式，因此確實需要解決。這是示例XML請求：

X-EBAY-API-COMPATIBILITY-LEVEL:your-request-version
X-EBAY-API-DEV-NAME:your-dev-id
X-EBAY-API-APP-NAME:your-app-id
X-EBAY-API-CERT-NAME:your-cert-id
X-EBAY-API-SITEID:your-site-id
X-EBAY-API-CALL-NAME:YourAPICallMethod

登入後複製

這是我們要求的包裝器。它使用getItem請求方法。請注意，getItem是API中方法的名稱，但我們必須將請求附加到它。 XMLN用於指定呼叫所屬的命名空間。在大多數情況下，這將是urn：eBay：apis：eblbasecomponents。當我大多數時候說這意味著交易API中的大多數方法都使用此特定的名稱空間。

<span><?xml version="1.0" encoding="utf-8"?>
</span><span><span><span><GetItemRequest</span> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></span>
</span><span><span><span><ItemID</span>></span>110072510158<span><span></ItemID</span>></span>
</span><span><span><span><RequesterCredentials</span>></span>
</span><span><span><span><eBayAuthToken</span>></span>your-user-token<span><span></eBayAuthToken</span>></span>
</span><span><span><span></RequesterCredentials</span>></span>
</span><span><span><span><WarningLevel</span>></span>High<span><span></WarningLevel</span>></span>
</span><span><span><span></GetItemRequest</span>></span></span>

登入後複製

接下來是eBay中項目的ID。

<span><?xml version="1.0" encoding="utf-8"?></span>

登入後複製

要找到此信息，請在eBay中搜索一個項目，然後單擊返回的任何結果。 URL看起來像這樣：

<span><span><span><GetItemRequest</span> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></span>
</span><span><span><span></GetItemRequest</span>></span></span>

登入後複製

項目ID是項目標題之後的數字集。
接下來是請求者憑據的包裝器：

<span><span><span><ItemID</span>></span>110072510158<span><span></ItemID</span>></span></span>

登入後複製

請求者憑據包裝器應包含用戶令牌。我們已經看到瞭如何較早獲取用戶令牌的沙盒帳戶。獲取該應用程序的用戶令牌基本相同，但是我們必須處理保存令牌在數據庫中，以便我們可以在以後使用它。

http://www.ebay.co.uk/itm/Apple-MacBook-Pro-15-4-2-66Ghz-Dual-Core-8GB-RAM-250GB-Latest-OS-X-10-9-/301305989202?pt=UK_Computing_Apple_Laptops_ET&hash=item46273c8852

登入後複製

接下來是警告級別。這可以具有高或低的值。應始終將其設置為高，以告訴eBay以返回未識別的，棄用的元素或無效的值的警告。如果請求出現問題，這將使您可以檢查響應。

<span><span><span><RequesterCredentials</span>></span>
</span><span><span><span></RequesterCredentials</span>></span></span>

登入後複製

>呼叫響應 - API返回的實際響應。無需修改它，因為它僅用於顯示響應。 >

api呼叫使用報告

>我們要瀏覽的最後一個工具是API呼叫使用報告。這使您可以在特定時間範圍內生成API使用情況的報告。如果您稍後將部署應用程序，這是一個不錯的工具，因為這將使您確定是否超過了您用於應用程序的特定API的API呼叫限制。在這種情況下，您只能向eBay提交申請即可增加API限制。

>數據庫

>我們將使用MySQL作為此應用。以下表將使用：

>設置 - 存儲像用戶令牌和應用程序ID這樣的常規應用程序設置。

產品 - 存儲產品詳細信息。

> prentiy_types - 存儲項目條件ID及其相應的名稱。

listing_types - 存儲清單代碼。

listing_durations - 存儲清單持續時間代碼。 >

>使用phpMyAdmin之類的東西創建一個新數據庫，然後執行以下SQL語句以創建單個表：

設置

store_settings

>產品

<span><span><span><eBayAuthToken</span>></span>your-user-token<span><span></eBayAuthToken</span>></span></span>

登入後複製

>條件_types

<span><span><span><WarningLevel</span>></span>High<span><span></WarningLevel</span>></span></span>

登入後複製

> listing_types

<span>CREATE TABLE IF NOT EXISTS <span>`settings`</span> (
</span>  <span><span>`id`</span> int(11) NOT NULL AUTO_INCREMENT,
</span>  <span><span>`user_token`</span> text NOT NULL,
</span>  <span><span>`dev_id`</span> varchar(300) NOT NULL,
</span>  <span><span>`app_id`</span> varchar(300) NOT NULL,
</span>  <span><span>`cert_id`</span> varchar(300) NOT NULL,
</span>  <span><span>`run_name`</span> varchar(300) NOT NULL,
</span>  <span><span>`site_id`</span> varchar(60) NOT NULL,
</span>  <span>PRIMARY KEY (<span>`id`</span>)
</span><span>)</span>

登入後複製

X-EBAY-API-COMPATIBILITY-LEVEL:your-request-version
X-EBAY-API-DEV-NAME:your-dev-id
X-EBAY-API-APP-NAME:your-app-id
X-EBAY-API-CERT-NAME:your-cert-id
X-EBAY-API-SITEID:your-site-id
X-EBAY-API-CALL-NAME:YourAPICallMethod

登入後複製

> listing_durations

<span><?xml version="1.0" encoding="utf-8"?>
</span><span><span><span><GetItemRequest</span> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></span>
</span><span><span><span><ItemID</span>></span>110072510158<span><span></ItemID</span>></span>
</span><span><span><span><RequesterCredentials</span>></span>
</span><span><span><span><eBayAuthToken</span>></span>your-user-token<span><span></eBayAuthToken</span>></span>
</span><span><span><span></RequesterCredentials</span>></span>
</span><span><span><span><WarningLevel</span>></span>High<span><span></WarningLevel</span>></span>
</span><span><span><span></GetItemRequest</span>></span></span>

登入後複製

對於條件類型，清單類型和列表持續時間，我們可以直接插入默認數據。還執行以下查詢。

<span><?xml version="1.0" encoding="utf-8"?></span>

登入後複製

<span><span><span><GetItemRequest</span> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></span>
</span><span><span><span></GetItemRequest</span>></span></span>

登入後複製

<span><span><span><ItemID</span>></span>110072510158<span><span></ItemID</span>></span></span>

登入後複製

結論

在這一部分中，我們準備了環境，並為第2部分和第3部分的平滑開發工作流進行了準備。請繼續關注隨訪，我們將開始構建應用程序的邏輯！

經常詢問有關eBay交易API

的問題

>什麼是eBay的交易API？它如何工作？

eBay的交易API是一種強大的工具，可允許開發人員創建可以執行與eBay交易相關的各種操作的應用程序。它通過提供一組用於應用程序和eBay服務器之間通信的協議來起作用。這些協議允許您的應用程序執行諸如待售的列表項目，管理活動列表，檢索用戶信息以及完成銷售交易的任務。 Trading API使用基於XML的消息進行通信，並且需要一個身份驗證令牌才能安全訪問。

>

>我如何開始使用eBay的交易API？，您首先需要在eBay的開發人員計劃網站上註冊為開發人員。註冊後，您可以創建一個應用程序鍵，其中包括Appid，certID和DEVID。這些密鑰用於在撥打API調用時對您的應用程序進行身份驗證。您還需要生成一個用戶令牌，代表eBay用戶您的應用程序代表。您可以執行的操作範圍。其中包括待售的清單項目，管理主動列表，檢索用戶信息，完成銷售交易等等。每個操作都由特定的API調用表示，每個呼叫的詳細信息都在eBay的API文檔中記錄。

>如何使用eBay的eBay交易API？ API通過eBay的交易API調用，您需要將HTTP POST請求發送到API端點。請求主體應包含XML消息，該消息指定您要進行的API調用和任何必需的參數。請求的標題應包括您的appid，certID和DEVID以進行身份驗證。