首頁 >後端開發 >php教程 >介紹eBay的交易API-設置

介紹eBay的交易API-設置

尊渡假赌尊渡假赌尊渡假赌
尊渡假赌尊渡假赌尊渡假赌原創
2025-02-18 10:38:09237瀏覽

介紹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的交易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後,出現了另一組字段。它提示您生成用戶令牌或手動輸入現有的代幣。由於我們已經在較早的沙箱帳戶中創建了一個,因此我們可以單擊“生成用戶令牌”按鈕。這將把您重定向到看起來像這樣的頁面:
  • >

介紹eBay的交易API-設置

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

>

介紹eBay的交易API-設置

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

介紹eBay的交易API-設置

>您在此頁面上要做的只是複制生成的令牌,然後單擊“保存令牌”按鈕。完成此操作後,您可以返回到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</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這樣的常規應用程序設置。
      store_settings - 存儲創建產品時要使用的eBay商店設置。 >
    • 產品 - 存儲產品詳細信息。
    • > 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以進行身份​​驗證。

    >

    >如何處理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中文網其他相關文章!

陳述:
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn