Offer API

Offer API 概要 (Offer API Overview)

バージョン：v1_beta.0.1

Offer API は、バイヤーに代わって代理入札（プロキシ入札）を行ったり、入札を取り消したりする機能、およびバイヤーが入札しているすべてのオークション情報を取得する機能を提供します。

注: これは限定リリース (Limited Release) APIであり、ビジネスユニットによって承認された一部の開発者のみが利用可能です。本番環境（Production）でのアクセス権取得方法については、Buy API Requirements を参照してください。

技術概要 (Technical overview)

Offer API には主に以下のオブジェクトが含まれています：

  • auction（オークション）
    バイヤー同士が競り合い、最高額をつけた人が商品を落札・購入できる購入オプションです。eBay には「オークション」と「固定価格（即決価格/Buy It Now）」の2つの購入オプションがあります。商品は片方、または両方のオプションを持つことができます。両方のオプションが提供されている場合、最初の入札が行われた時点で「即決価格」オプションは削除され、商品は最高入札者に販売されます。
  • proxyBid（代理入札）
    オークション形式の商品に対して、バイヤーに代わって行われる入札です。

ビジネスユースケース (Business use cases)

Offer API を使用した主なユースケースは以下の通りです：

代理入札を行う

オークション商品に対して、バイヤーに代わって入札（代理入札）を行うことができます。メソッド：placeProxyBid

オークション情報を取得する

バイヤーが入札したオークションについて、そのバイヤーに固有の入札詳細情報を取得できます。メソッド：getBidding

API制限 (API restrictions)

Offer API に関する以下の制約事項に注意してください。

商品識別子の非互換性

Buy API の商品識別子（Item ID）は、eBay サイトで使用されている識別子とは一致しません。そのため、Buy API の RESTful な商品識別子を Finding API などの eBay レガシー API で使用することはできません。ただし、レガシーな商品識別子をお持ちの場合は、Browse API の getItemByLegacyId メソッドを使用して、対応する RESTful な商品識別子を見つけることができます。

地域/サイトの制約

すべての Buy API がサポートされている eBay サイトのリストについては、Buy API Support by Marketplace を参照してください。

サイトを指定するには、X-EBAY-C-MARKETPLACE-ID リクエストヘッダーにサイト（マーケットプレイス ID）を設定します。例：
X-EBAY-C-MARKETPLACE-ID = EBAY_GB

eBay Buy API の要件

eBay Buy API は、eBay のサンドボックス環境では誰でも使用できますが、本番環境（Production）での使用は制限されています。本番環境で Buy API にアクセスするには、標準の適格性要件を満たし、eBay サポート組織からの承認を得て、eBay と契約を締結する必要があります。本番アクセスの詳細については、Production eligibility requirements を参照してください。

レート制限

Offer API は、アプリケーションに代わって 1 日に行える呼び出し回数を制限しています。現在のアプリケーションレート制限については、eBay API Call Limits ページを参照してください。

トップに戻る