購入オファー API（Buy Offer API）

注: これは限定リリース API であり、ビジネスユニットによって承認された特定の開発者のみが利用できます。本番環境でこの API にアクセスする方法については、購入 API の要件を参照してください。

Buy Offer API を使用すると、パートナーは購入者に代わって代理入札を行い、購入者が入札しているオークションを取得できます。代理入札を行うことで、購入者はオークションに勝った場合にアイテムを購入することに同意します。

バージョン: v1_beta.0.1

ベースURL: https://api.ebay.com/buy/offer/v1_beta

認証（OAuth スコープ）

この API は 認可コード（Authorization Code） フローを使用します。ユーザーアクセストークンが必要です。

リソース一覧

Buy Offer API は以下の 1 リソース、合計 2 エンドポイント（1 GET + 1 POST）で構成されています。

bidding — オークション入札（2 エンドポイント）

GET /bidding/{item_id}

getBidding — 指定されたオークションの購入者に固有の入札詳細を取得します。購入者がすでに入札しているオークションである必要があります。

入札情報を取得するには、ユーザーアクセストークンを使用し、オークションのアイテム ID を渡します。Browse API の getItems メソッドを使用して、オークションに関する一般的な入札詳細（最低入札価格や一意の入札者数など）を取得することもできます。

制限事項: サポートされているサイトとその他の制限事項については、API 制限事項を参照してください。

レスポンス: 200 / 400 / 404 / 500

POST /bidding/{item_id}/place_proxy_bid

placeProxyBid — ユーザーアクセストークンを使用して、特定のオークションアイテムに対して購入者の代理入札を行います。アイテムは buyingOptions の 1 つとして AUCTION を提供する必要があります。

入札を行うには、オークションのアイテム ID を URI パラメータとして渡し、購入者の最大入札額（maxAmount）をペイロードに渡します。代理入札を行うことで、購入者はオークションに勝った場合にアイテムを購入することに同意します。

この入札が行われた後、他の誰かが購入者よりも高い入札を行った場合、eBay は自動的に購入者の最大入札額まで再度入札します。入札額が購入者の最高入札額を超えると、eBay は購入者に入札額が上回ったことを通知します。

制限事項: サポートされているサイトとその他の制限事項については、API 制限事項を参照してください。

レスポンス: 200 / 400 / 404 / 409 / 500

スキーマ定義（全 8 スキーマ）

Bidding

PlaceProxyBidRequest

PlaceProxyBidResponse

ProxyBid

UserConsent

Amount

Error / ErrorParameter

標準エラースキーマ（他の API と同一構造）。

エンドポイント一覧（全 2 エンドポイント）