介紹eBay的交易API-設置

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

>

檢索存儲信息
>更新存儲首選項
>將產品添加到特定的eBay商店
>結束產品列表
更新產品價格
檢索產品信息

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

鑰匙要點

>需要註冊：首先在eBay的開發人員網站上註冊開發人員帳戶，以訪問沙箱和生產環境的應用程序密鑰。
配置應用程序設置：自定義eBay用戶同意表格並管理設置，例如授權類型和返回URL，確保所有URL均為https。
• >使用開發人員工具：探索eBay的開發人員工具，例如用於測試的Sandbox帳戶和用於在不同環境中模擬API調用的API測試工具。
>
• >數據庫設置：建立一個MySQL數據庫，並為設置，商店設置，產品等創建表格，以有效地管理應用程序數據。 >
了解API調用：學習使用交易API進行API調用，重點介紹XML請求格式，並為成功的eBay交易操作處理響應。 >
註冊一個應用
>您需要做的第一件事是在eBay開發人員網站上註冊一個開發人員帳戶。

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

>：

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

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

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

>

• 顯示標題 - 用戶以後授予應用程序的授權時要顯示的應用程序標題。 （例如產品創建者）顯示描述：顯示描述是描述您應用程序的文本。 （例如，此應用程序允許用戶輕鬆地將產品添加到其eBay商店）
• >
令牌返回方法 - 令牌返回方法是用戶授予應用程序授權後應用程序使用的方法。為此，所提供的價值應為“獲取”。
• >
授權類型 - 用戶授予應用程序授權之後的應用程序類型。這可以是授權或ID。驗證。為此領域提供“授權”的價值，因為我們需要用戶賦予我們的應用程序授權，以為他們執行不同的操作。
應用程序類型 - 應用程序的類型。這應該是“基於Web”的。
接受重定向URL - 用戶賦予應用程序授權時將其重定向的URL。請注意，eBay僅允許HTTPS URL。如果您想稍後再關注，建議您在openshift.com上註冊一個帳戶。您託管的應用程序默認情況下將具有HTTP，並且是免費的。
• 拒絕重定向URL用戶拒絕應用程序時將其重定向到的URL。
隱私政策URL - 隱私政策URL。當用戶在頁面中以授予應用程序的授權時，該URL將包含在應用程序描述中。
>工具
> eBay的開發人員儀表板為我們提供了各種工具。

沙盒帳戶

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

API測試工具

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

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

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

>

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

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

>

• >

  選擇一個API調用 - 您要請求的API中的實際資源。您可以打出很多電話。您可以選擇任何引起您興趣的東西。

  >

• 選擇一個模板 - 它可以具有“完整，通用”或“部分，預先填充”的值。選擇“完整的，通用”將為您提供XML請求框中的空白字段，同時選擇“部分，預填充”將為您提供一些已經填充的基本示例字段。由於我們剛剛起步，因此使用“部分，預填充”是最好的選擇，因為這已經為我們提供了我們選擇的資源所需的一些領域。例如，如果我們為API呼叫字段選擇“ getItem”，則已經為我們提供了示例itemID和警告級別，而我們要做的就是單擊XML請求Textarea下方的“提交”按鈕以便啟動請求。一旦使用API​​感到滿意，您就可以將值直接添加到XML請求TextArea中，以修改提交給API的實際數據。

  >
選擇一個呼叫變化- API中的每個資源都可能具有不同的變化，但是大多數情況下，您只想進行基本調用，因此您實際上不必實際修改此字段的默認值。

• >
選擇呼叫請求版本 - eBay API經歷了許多更改，這意味著仍有不同版本的API浮動以支持較舊的系統。由於我們剛剛開始使用API​​，因此我們可以選擇最新版本，截至此時是版本885。

• 選擇網站ID - 您可能已經知道有不同的eBay網站。該字段代表您要撥打電話的實際eBay網站。由於我們只是使用API​​測試工具進行測試，因此我們可以為此提供美國。

Web Service URI - 提出所有請求的URL。您不必修改此字段。
HTTP標頭 - 標題中提供給API的每個請求中提供的信息。默認情況下使用以下標題：
• 解釋不清楚的：

x-ebay-api-siteid - 您要提出請求的eBay網站的ID。這是您可以使用的站點ID列表。您可能需要找到站點名稱，然後注意相應的eBay站點ID。

> 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請求：

分解它，這指定了我們正在使用的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> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></getitemrequest></span>
</span><span><span><span><itemid>></itemid></span>110072510158<span><span></span>></span>
</span><span><span><span><requestercredentials>></requestercredentials></span>
</span><span><span><span><ebayauthtoken>></ebayauthtoken></span>your-user-token<span><span></span>></span>
</span><span><span><span></span>></span>
</span><span><span><span><warninglevel>></warninglevel></span>High<span><span></span>></span>
</span><span><span><span></span>></span></span></span></span></span></span></span>

接下來是eBay中項目的ID。

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

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

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

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

<span><span><span><itemid>></itemid></span>110072510158<span><span></span>></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>></requestercredentials></span>
</span><span><span><span></span>></span></span></span>

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

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

>數據庫

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

>設置 - 存儲像用戶令牌和應用程序ID這樣的常規應用程序設置。
store_settings - 存儲創建產品時要使用的eBay商店設置。 >
• 產品 - 存儲產品詳細信息。
• > prentiy_types - 存儲項目條件ID及其相應的名稱。
>
• listing_types - 存儲清單代碼。
• listing_durations - 存儲清單持續時間代碼。 >
• >使用phpMyAdmin之類的東西創建一個新數據庫，然後執行以下SQL語句以創建單個表：
• 設置

store_settings

>產品

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

>條件_types

<span><span><span><warninglevel>></warninglevel></span>High<span><span></span>></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> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></getitemrequest></span>
</span><span><span><span><itemid>></itemid></span>110072510158<span><span></span>></span>
</span><span><span><span><requestercredentials>></requestercredentials></span>
</span><span><span><span><ebayauthtoken>></ebayauthtoken></span>your-user-token<span><span></span>></span>
</span><span><span><span></span>></span>
</span><span><span><span><warninglevel>></warninglevel></span>High<span><span></span>></span>
</span><span><span><span></span>></span></span></span></span></span></span></span>

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

>

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

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

<span><span><span><itemid>></itemid></span>110072510158<span><span></span>></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以進行身份​​驗證。

>

>如何處理API調用中的響應？

> API調用的響應是XML消息其中包含呼叫的結果。您可以解析此XML消息以提取所需的信息。響應消息的結構取決於您製作的API調用。

>

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

如果遇到問題，我如何對eBay的交易API進行故障排除？借助eBay的交易API，您可以在響應消息中使用錯誤代碼和消息來識別問題。您還可以參考eBay的API文檔和開發人員論壇以尋求額外的幫助。

我可以將eBay的交易API與其他編程語言一起使用嗎？

是的，您可以將eBay的交易API與任何編程語言一起使用這支持HTTP和XML。這包括諸如Python，Java，C＃等語言。
>在使用eBay的API時，我如何確保我的應用程序安全？ ，在撥打API時，您應該始終使用https，並且切勿共享您的appid，certid，devid或用戶令牌。

>

>在哪裡可以找到有關eBay交易API的更多信息？您可以在eBay的API文檔中找到有關eBay交易API的更多信息，該文檔提供了有關每個API調用的詳細信息，包括其參數，響應結構和錯誤代碼。您還可以在eBay的開發人員計劃網站和開發人員論壇上找到有用的資源。

以上是介紹eBay的交易API-設置的詳細內容。更多資訊請關注PHP中文網其他相關文章！