eBay＆＃x27;の取引APIの紹介 - セットアップ

このチュートリアルシリーズでは、eBayの取引APIを説明します。取引APIを使用すると、eBayでの販売に使用できるアプリケーションを構築できます。 APIでできることの例は次のとおりです。

ストア情報を取得

• ストアの設定を更新
• 特定のeBayストアに製品を追加します
• 最終製品リスト
• 製品価格を更新
• 製品情報を取得
• このチュートリアルでは、APIを使用してユーザーがeBayで製品を作成できるようにするアプリを作成します。
キーテイクアウト

登録が必要：eBayの開発者Webサイトに開発者アカウントを登録して、サンドボックス環境と生産環境の両方のアプリケーションキーにアクセスすることから始めます。

アプリケーション設定の構成：eBayユーザー同意書をカスタマイズし、認証タイプやリターンURLなどの設定を管理し、すべてのURLがhttpsであることを確認します。

開発者ツールの利用：さまざまな環境でのAPI呼び出しをシミュレートするためのサンドボックスアカウントのようなeBayの開発者ツールをテスト用に探索し、APIテストツール。

データベースのセットアップ：MySQLデータベースを確立し、設定、保存設定、製品などのテーブルを作成して、アプリケーションデータを効果的に管理します。
• API呼び出しの理解：XMLリクエストフォーマットに焦点を当て、eBay取引オペレーションを成功させるためのXMLリクエストフォーマットと処理応答に焦点を当てて、API呼び出しを作成することを学びます。
• アプリを登録します
• 最初に行う必要があるのは、eBay開発者Webサイトで開発者アカウントを登録することです。
それを行い、メールを確認したら、次のような画面で迎えられます。
• そのページで、「アプリケーションキーを取得」リンクをクリックしてください。これにより、サンドボックスと生産キーを生成できるページに導かれます。次に、[サンドボックスキーの生成]ボタンをクリックして、構築するアプリのテストに使用できるキーを生成します。また、[生産キーを生成]ボタンをクリックして、アプリを展開するときに使用できるキーを生成します。これらのキーは、eBayが提供するAPIのいずれかで使用できるので、これを1回しか行わないことに注意してください。
キーが生成されたら、キー（サンドボックスまたは生産）の「設定の設定」リンクをクリックします。

>「eBayユーザー同意書のカスタマイズ」セクションの下で、「eBayユーザー同意書のカスタマイズフォーム」リンクをクリックします。これにより、アプリが使用するURLを構成できます。これは基本的に、アプリのホームページのURLです。そこに着いたら、「Runamesの管理」セクションの下で、「アプリケーションのランメを生成する」リンクをクリックします。ランームはアプリに相当します。異なるeBay APIと対話するさまざまなアプリを作成している場合は、各アプリに1つのランームを作成できます。ランナムが生成されると、次の情報があなたに尋ねられます：

表示タイトル - ユーザーが後でアプリに権限を与えたときに表示したいアプリのタイトル。 （例えば、製品作成者）
表示説明：表示の説明は、アプリが何をするかを説明するテキストです。 （たとえば、このアプリを使用すると、ユーザーはeBayストアに製品を簡単に追加できます）
トークンリターンメソッド - トークンリターンメソッドは、ユーザーがアプリに権限を与えた後にアプリが使用するメソッドです。このためには、提供される値は「フェッチトークン」でなければなりません。
承認タイプ - ユーザーがアプリに権限を与えた後にアプリが行うアクションの種類。これは、承認またはid.verificationのいずれかです。このフィールドに「承認」の価値を提供します。なぜなら、ユーザーがアプリにさまざまなアクションを実行するための権限を提供する必要があるからです。
アプリケーションタイプ - アプリのタイプ。これは「Webベース」である必要があります
• Redirect URL - アプリに権限を与えるときにユーザーがリダイレクトされるURL。 eBayはHTTPS URLのみを許可していることに注意してください。後でフォローしたい場合は、OpenShift.comでアカウントにサインアップすることをお勧めします。そこにホストするアプリには、デフォルトでHTTPSがあり、無料です。
拒否ユーザーがアプリを拒否したときにリダイレクトURLをリダイレクトします。
• プライバシーポリシーURL - プライバシーポリシーURL。このURLは、ユーザーがアプリに権限を与えるためにページにいるときにアプリの説明に含まれます。
• ツール
• eBayの開発者ダッシュボードは、私たちが遊ぶためのさまざまなツールを提供しています。
Sandboxアカウント

Sandboxユーザー登録ツールを見てみましょう。 Sandboxアカウントを登録したら、sandbox.ebay.comに移動してログインをテストします。動作していることを確認したら、eBay開発者アカウントページに戻ります。

APIテストツール

次はAPIテストツールです。そのページに1つは、たくさんのオプションがあることがわかりますが、デフォルトではすでに事前に入力されているため、各フィールドが何をするかを知ることができます。このツールを使用する前に、各フィールドの簡単な説明を次に示します。

• 環境を選択します。これにより、サンドボックスと生産環境を切り替えることができます。多くの場合、APIテストツールからテストしているだけで、「サンドボックス」を使用したい場合があります。 2つの主な違いは、サンドボックスはサンドボックス/テストeBayアカウントでのみ使用できることであり、生産は実際のeBayアカウントでのみ使用できることです。
• キーセットを選択します。これにより、API呼び出しの作成に使用されるキーを変更できます。ほとんどの場合、環境の種類を選択すると、キーがすでに変更されているため、実際にこれに触れる必要はありません。
APIを選択します - これにより、呼び出しを行うAPIを選択できます。すでにご存知かもしれませんが、eBayにはさまざまなAPIのセットがあります。取引、発見、ショッピング、フィードバック、オープンAPIです。主にこのチュートリアルにトレーディングAPIを使用する予定ですので、先に進んでそれを選択してください。取引APIを選択した後、別のフィールドセットが表示されることに注意してください。ユーザートークンを生成するか、既存のトークンを手動で入力するように促します。以前にSandboxアカウントを既に作成したため、[ユーザートークンを生成]ボタンをクリックするだけです。それはあなたを次のようなページにリダイレクトします：

環境用にサンドボックスが選択されていることを確認し、[トークンの生成]ボタンをクリックします。これにより、Sandbox eBayのWebサイトログインページにリダイレクトされます。サンドボックスログイン資格情報で入力します。ログインが成功した場合、承認ページにリダイレクトされます：

アプリを承認することに同意します。これは、主にテストにeBayが使用する一般的なアプリであることに注意してください。これは、以前に作成したアプリではありません。その後、次のページにリダイレクトされます。

このページでしなければならないのは、生成されたトークンをコピーしてから、[トークンを保存]ボタンをクリックすることだけです。それが完了したら、APIテストツールページに戻り、ユーザートークンフィールドにコピーしたばかりのユーザートークンに貼り付けます。

API呼び出しを選択します - リクエストするAPIの実際のリソース。あなたがすることができるたくさんの電話があります。興味をそそるものは何でも選択できます

テンプレートを選択します。これには、「フル、ジェネリック」または「部分的な、事前に満たされた」の値を持つことができます。 「フル、ジェネリック」を選択すると、XMLリクエストボックスに空白のフィールドが得られます。「部分的な、事前に充填された」を選択すると、すでに存在している基本的な例フィールドが得られます。始めたばかりなので、「部分的で事前に充填された」を使用することが最良の選択です。なぜなら、それは私たちが選択したリソースで必要ないくつかのフィールドにすでに供給されるからです。たとえば、APIコールフィールドに「getItem」を選択した場合、これは既にサンプルItemIDと警告型を提供します。リクエストを開始します。 APIを使用することに慣れたら、XMLリクエストTextareaに値を直接追加して、APIに送信される実際のデータを変更できます。

呼び出しのバリエーションを選択します - APIの各リソースは異なるバリエーションを持つことができますが、ほとんどの場合、基本的な呼び出しのみを行いたいので、このフィールドのデフォルト値を実際に変更する必要はありません。

コールリクエストバージョンの選択 - eBay APIは多くの変更を行っています。つまり、古いシステムをサポートするために、APIの異なるバージョンがまだ浮かんでいます。 APIを利用し始めたばかりなので、最新バージョンを選択できます。この時点でバージョン885です。

サイトIDを選択します - ご存知のように、eBay Webサイトが異なることがあります。このフィールドは、電話をかけたい実際のeBay Webサイトを表しています。 APIテストツールを使用してテストしているだけなので、これについて米国に提供できるだけです。

Web Service URI - すべてのリクエストが行われるURL。このフィールドを変更する必要はありません

HTTPヘッダー - APIに行う各リクエストに対してヘッダーに提供される情報。デフォルトでは、次のヘッダーが使用されます：

不明確なものを説明する：

X-EBAY-API-SITEID - リクエストを行うeBay WebサイトのID。使用できるサイトIDのリストを次に示します。サイト名を見つけてから、対応するeBayサイトID。

x-ebay-api-call-name - 呼び出したいAPIのリソースまたはメソッド。これは、トレーディングAPIで行うことができる通話への参照です。

XMLリクエスト - リクエストの本文。取引APIは、XMLおよびSOAP形式のみをサポートします。しかし、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

それを分解すると、これは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のメソッドの名前であるが、リクエストを追加する必要があることに注意してください。 XMLNSは、呼び出しが属する名前空間を指定するために使用されます。ほとんどの場合、この値は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>

requester資格情報ラッパーには、ユーザートークンを含める必要があります。サンドボックスアカウントのために、以前にユーザートークンを取得する方法をすでに見てきました。アプリのユーザートークンを取得することは基本的に同じですが、後でそれを利用できるように、データベースにトークンを保存することを処理する必要があります。

次は警告レベルです。これは、高いまたは低い値の値を持つことができます。これは、認識されていない非推奨の要素または無効な値に対する警告を返すようにeBayに伝えるために、常に高く設定する必要があります。これにより、リクエストに何か問題が発生した場合に応答を確認できます。

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

呼び出し応答 - APIによって返される実際の応答。応答を表示するために単に使用されるため、これを変更する必要はありません。

api呼び出し使用レポート

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

私たちが歩く最後のツールは、API呼び出しの使用レポートです。これにより、特定の時間範囲でAPI使用のレポートを生成できます。これは、アプリを後で展開する場合に備えるのに最適なツールです。これにより、アプリに使用している特定のAPIのAPIコール制限を超えるかどうかを判断できるためです。その場合、APIの制限を増やすためにeBayに申請書を送信するだけです。

データベース

このアプリにはMySQLを使用します。次のテーブルが使用されます：

設定 - ユーザートークンやアプリIDなどの一般的なアプリ設定を保存します。

Store_Settings - 製品を作成するときに使用するeBayストアの設定を保存します。

製品 - 製品の詳細を保存します。

condition_types - アイテム条件IDと対応する名前を保存します。

listing_types - リスティングコードを保存します
• listing_durations - リスティング期間コードを保存します。
phpMyAdminのようなものを使用して新しいデータベースを作成し、次のSQLステートメントを実行して個々のテーブルを作成します。
• 設定
store_settings
• 製品

condition_types

listing_types

<span><span><span><eBayAuthToken</span>></span>your-user-token<span><span></eBayAuthToken</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のサーバー間の通信のための一連のプロトコルを提供することで機能します。これらのプロトコルにより、アプリケーションは、販売のリストのリスト、アクティブなリストの管理、ユーザー情報の取得、販売トランザクションの完了などのタスクを実行できます。取引APIはXMLベースのメッセージを使用して通信し、安全なアクセスのために認証トークンが必要です。 、最初にeBayの開発者プログラムWebサイトで開発者として登録する必要があります。登録されたら、AppID、certID、およびdevidを含むアプリケーションキーズセットを作成できます。これらのキーは、API呼び出しを行うときにアプリケーションを認証するために使用されます。また、ユーザートークンを生成する必要があります。これは、アプリケーションが代表して動作しているeBayユーザーを表しています。実行できる操作の範囲。これらには、販売のためのリストアイテム、アクティブなリストの管理、ユーザー情報の取得、販売取引の完了などが含まれます。各操作は特定のAPI呼び出しで表され、各呼び出しの詳細はeBayのAPIドキュメントに文書化されています。

eBayの取引APIでAPI呼び出しを行うにはどうすればよいですか？

eBayの取引APIでAPI呼び出し、APIエンドポイントにHTTP POSTリクエストを送信する必要があります。リクエストの本文には、作成するAPI呼び出しと必要なパラメーターを指定するXMLメッセージを含める必要があります。リクエストのヘッダーには、認証のためにAppID、certID、およびDevidを含める必要があります。コールの結果が含まれています。このXMLメッセージを解析して、必要な情報を抽出できます。応答メッセージの構造は、作成したAPI呼び出しに依存します。

eBayの取引APIを使用する際に遭遇する可能性のあるいくつかの一般的なエラーは何ですか？

eBayの取引APIを使用する際に遭遇する可能性のあるいくつかの一般的なエラーには、認証エラー、無効な要求エラー、サーバーエラーが含まれます。各エラーは、エラーが発生したときに応答メッセージに含まれる特定のエラーコードとメッセージで表されます。 eBayの取引APIを使用すると、応答メッセージでエラーコードとメッセージを使用して問題を識別できます。追加のヘルプについては、eBayのAPIドキュメントと開発者フォーラムを参照してください。これはHTTPとXMLをサポートします。これには、Python、Java、C＃などの言語が含まれます。 、API呼び出しを行うときは常にHTTPSを使用する必要があります。APPID、CERTID、DEVID、またはユーザートークンを共有しないでください。 eBayのAPIドキュメントでeBayの取引APIに関する詳細情報を見つけることができます。これは、パラメーター、応答構造、エラーコードなど、各API呼び出しに関する詳細な情報を提供します。また、eBayの開発者プログラムWebサイトおよび開発者フォーラムで有用なリソースを見つけることができます。

以上がeBay＆＃x27;の取引APIの紹介 - セットアップの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。