入札履歴

Version 1

リクエストURL

XML

http://auctions.yahooapis.jp/AuctionWebService/V1/BidHistory

Yahoo!オークションの入札履歴の表示機能を提供します。

リクエストパラメータ

「RESTリクエストの構築（GET）」および、「RESTリクエストの構築（POST）」をご参照ください。

パラメータ	値	説明
appid（必須）	string	アプリケーションID。詳細はこちらをご覧ください。
auctionID（必須）	string	入札履歴情報取得を実施する対象のオークションIDです。
page	integer:1（デフォルト）	入札履歴のページ番号です。デフォルトは1となり最初のページを返します。

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V1/BidHistory?appid=<あなたのアプリケーションID>&auctionID=<商品（オークション）のID>

レスポンスフィールド

入札履歴Web APIのスキーマの記述は、以下のURLをご覧ください。
http://auctions.yahooapis.jp/AuctionWebService/V1/BidHistory.xsd

フィールド	説明
ResultSet	クエリーレスポンスのすべてを含みます。 totalResultsAvailable: 履歴件数の総個数です。 totalResultsReturned: 履歴の返された個数です。 firstResultPosition: 最初のデータが何個目にあたるかです。
Result	各個別レスポンスを含みます。
Bidder	入札者のYahoo! JAPAN IDです。
Rating	評価を表現するフィールドです。
Point	評価ポイントです。新規の際には0を設定します。
IsSuspended	停止中の際、trueとなります。
IsDeleted	登録削除済みの際、trueとなります。
Price	現在の価格（入札価格）です。 isPriceMask：価格マスクされているか。あり(価格を提供しない)の際、trueとなります。
Quantity	入札した個数です。
Date	最後に手動で入札した時間です。RFC3339に準拠した表現を用います。（例：2004-04-01T12:00:00+09:00）
ItemListURL	入札者の出品リストへのリクエストURLです。
RatingURL	入札者の評価ページへのURLです。
IsHighestBidder	最高額入札者の際にはtrueとなります。

サンプルレスポンス

以下は、出品者から見た、auctionID=x12345678 の入札履歴です。

<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet totalResultsAvailable="3" totalResultsReturned="3" firstResultPosition="1">
    <Result>
        <Bidder>bidder_1</Bidder>
        <Rating>
             <Point>123</Point>
             <IsSuspended>false</IsSuspended>
             <IsDeleted>false</IsDeleted>
        </Rating>
        <Price isPriceMask="false">2300.00</Price>
        <Quantity>3</Quantity>
        <Date>2008-04-21T18:00:21+09:00</Date>
        <ItemListURL>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=bidder_1</ItemListURL>
        <RatingURL>http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?Id=bidder_1</RatingURL>
        <IsHighestBidder>true</IsHighestBidder>
    </Result>
    <Result>
        <Bidder>bidder_2</Bidder>
        <Rating>
             <Point>0</Point>
             <IsSuspended>false</IsSuspended>
             <IsDeleted>false</IsDeleted>
        </Rating>
        <Price isPriceMask="false">2200.00</Price>
        <Quantity>1</Quantity>
        <Date>2008-04-21T14:00:21+09:00</Date>
        <ItemListURL>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=bidder_2</ItemListURL>
        <RatingURL>http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?Id=bidder_2</RatingURL>
        <IsHighestBidder>false</IsHighestBidder>
    </Result>
    <Result>
        <Bidder>bidder_3</Bidder>
        <Rating>
             <IsSuspended>true</IsSuspended>
             <IsDeleted>false</IsDeleted>
        </Rating>
        <Price isPriceMask="false">1900.00</Price>
        <Quantity>5</Quantity>
        <Date>2008-04-21T12:00:21+09:00</Date>
        <ItemListURL>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=bidder_3</ItemListURL>
        <RatingURL>http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?Id=bidder_3</RatingURL>
        <IsHighestBidder>false</IsHighestBidder>
    </Result>
</ResultSet>