オークション

マイ・オークション表示（落札者一覧）

Version 1

リクエストURL

XML

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

ログインしているYahoo! JAPAN IDのマイ・オークションの「落札者一覧」を参照します。

リクエストパラメータ

パラメータ	値	説明
auctionid（必須）	string	商品（オークション）のIDです。

※上記のパラメータ以外にOAuthのAuthorizationヘッダが必要になります。OAuthのAuthorizationヘッダについては、以下のサイトで詳細をご確認ください。
・OAuthのフロー
・OAuthを用いたAPIリクエスト
※Consumer Keyを取得する際に「マイ・オークション関連の機能」スコープを選択してください。スコープの詳細は、「スコープに関して」でご確認ください。

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V1/myWinnerList?auctionid=<オークションIDを指定> Authorization: OAuth realm="yahooapis.jp", oauth_consumer_key=<お客様のConsumer Key>, oauth_nonce=<ランダムな文字列>, oauth_signature_method="HMAC-SHA1", oauth_timestamp=<タイムスタンプ値>, oauth_token=<トークン値>, oauth_version="1.0", oauth_signature=<シグネチャの内容>

レスポンスフィールド

マイ・オークション表示（落札者一覧）Web APIのスキーマの記述は、以下のURLをご覧ください。
http://auctions.yahooapis.jp/AuctionWebService/V1/myWinnerList.xsd

フィールド	説明
ResultSet	クエリーレスポンスのすべてを含み、次の属性を持ちます。 totalResultsAvailable：該当件数の総個数です。 totalResultsReturned：返された値の個数です。 firstResultPosition：最初のデータが何個目に当たるかです。
Result	各個別レスポンスを含みます。
AuctionID	オークションIDです。
Title	商品のタイトルです。
EndTime	終了日時です。RFC3339に準拠した表現を用います。(例：`2004-04-01T12:00:00+09:00`)
AuctionItemUrl	商品詳細のURLです。
Image	画像（サムネイル）の情報です。
Url	画像（サムネイル）のURLです。
Width	画像（サムネイル）の幅です。
Height	画像（サムネイル）の高さです。
HighestBidders	現在の最高額入札者(複数含め)の情報です。 totalHighestBidders：BidderField件数の総個数です。
Bidder	1人の最高額入札者に関する情報です。
Id	落札者のYahoo! JAPAN IDです。
ItemListUrl	落札者の出品リストを取得するリクエストURLです。（appidは含まれていませんのでご注意ください）。
HighestPrice	落札価格です。¥記号やカンマは含みません。小数点第二位までの精度です。
Title	投稿タイトルです。「連絡先、支払い、発送などについて」「入金を確認しました」「商品を発送しました」「送付先住所、支払い、発送などについて」「支払いが完了しました」「商品を受け取りました」「その他」のいずれかになります。（取引メッセージがなければ空）
ContributeIconUrl	落札者からメッセージが投稿された場合に付く「落札者」アイコンのURLです。出品者の取引メッセージである、または取引メッセージがなければ空
SendTime	落札者のメッセージ送信日時です。RFC3339に準拠した表現を用います。(例：`2004-04-01T12:00:00+09:00`) 取引メッセージがなければ空が返却されます。
Option	各オプションの設定状況です。
FeaturedIconUrl	注目のオークション設定アイコンのURLです。設定されていない場合は空
FreeShippingIconUrl	「送料無料」のアイコンのURLです。設定されていない場合は空
WrappingIconUrl	「贈答品」アイコンのURLです。設定されていない場合は空
BuynowIconUrl	「即決」アイコンのURLです。設定されていない場合は空
EasyPaymentIconUrl	「Yahoo!かんたん決済」アイコンのURLです。設定されていない場合は空
GiftIconUrl	「目立ち」アイコンのURLです。設定されていない場合は空
ItemStatusNewIconUrl	「新品」アイコンのURLです。設定されていない場合は空
YBankIconUrl	Yahoo!ネットバンキング対応の場合にYahoo!ネットバンキングアイコンのURLが設定されます。設定されていない場合は空
EnglishIconUrl	「Yahoo!オークション英語版」アイコンのURLです。設定されていない場合は空
StarClubIconUrl	「スタークラブ限定セール」アイコンのURLです。設定されていない場合は空。
PointIconUrl	「Yahoo!ポイント」アイコンのURLです。設定されていない場合は空
IsBold	太字設定されている場合には`true` されていない場合には`false`となります。設定されていない場合は空
IsBackGroundColor	背景色設定されている場合には`true` されていない場合には`false`となります。設定されていない場合は空

サンプルレスポンス

以下は、start=3 のクエリーの結果です。

<?xml version="1.0" encoding="UTF-8" ?> 
<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:jp:auc:myWinnerList" xsi:schemaLocation="urn:yahoo:jp:auc:myWinnerList http://auctions.yahooapis.jp/AuctionWebService/V1/myWinnerList.xsd" totalResultsAvailable="1" totalResultsReturned="1" firstResultPosition="1">
  <Result>
    <AuctionID>1442766</AuctionID> 
    <Title>hogehoge</Title> 
    <EndTime>2009-06-09T10:48:14+09:00</EndTime>
    <AuctionItemUrl>http://pageX.auctions.yahoo.co.jp/jp/auction/1442766</AuctionItemUrl>
    <Image>
      <Url>http://a1017.lm.a.yimg.com/7/1017/1783/000/f03batchimg.auctions.yahoo.co.jp/users/5/2/7/1/xxxxx-thumb-1208052000152677.jpg</Url>
      <Width>75</Width>
      <Height>75</Height>
    </Image>
    <Option>
      <EscrowIconUrl /> 
      <FeaturedIconUrl /> 
      <FreeShippingIconUrl /> 
      <WrappingIconUrl /> 
      <BuynowIconUrl>http://image.auctions.yahoo.co.jp/images/buynow.gif</BuynowIconUrl> 
      <EasyPaymentIconUrl>http://i.yimg.jp/images/pay/icon_s16.gi</EasyPaymentIconUrl> 
      <GiftIconUrl /> 
      <ItemStatusNewIconUrl>http://image.auctions.yahoo.co.jp/images/gift/c_attention_01.gif</ItemStatusNewIconUrl> 
      <YBankIconUrl>http://i.yimg.jp/images/sicons/bank16.gif</YBankIconUrl> 
      <EnglishIconUrl />
      <StarClubIconUrl />
      <PointIconUrl />
      <IsBold>false</IsBold> 
      <IsBackGroundColor>false</IsBackGroundColor> 
    </Option>
    <HighestBidders totalHighestBidders="2">
      <Bidder>
        <Id>chkyj_ex_zurcdmvc</Id> 
        <ItemListUrl>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=chkyj_ex_zurcdmvc</ItemListUrl> 
        <HighestPrice>100 円</HighestPrice> 
        <Message>
          <Title>その他</Title> 
          <ContributeIconUrl>http://i.yimg.jp/images/auct/template/ui/auc_mod/ic_6002.gif</ContributeIconUrl> 
          <SendTime>2009-06-09T11:01:47+09:00</SendTime> 
        </Message>
      </Bidder>
      <Bidder>
        <Id>chkyj_ex_urgtkzaj</Id> 
        <ItemListUrl>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=chkyj_ex_urgtkzaj</ItemListUrl> 
        <HighestPrice>100 円</HighestPrice> 
        <Message>
          <Title>その他</Title> 
          <ContributeIconUrl>http://i.yimg.jp/images/auct/template/ui/auc_mod/ic_6002.gif</ContributeIconUrl> 
          <SendTime>2009-06-09T11:00:16+09:00</SendTime> 
        </Message>
      </Bidder>
    </HighestBidders>
  </Result>
</ResultSet>

エラー

マイ・オークション表示（落札者一覧）Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

※このWeb APIは、24時間中1アプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。
※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を解除させていただきます。（無料）
まずはヘルプページのお問い合わせフォームからご相談ください。

マイ・オークション表示（落札者一覧）

リクエストURL

リクエストパラメータ

レスポンスフィールド

サンプルレスポンス

エラー

利用制限

マイ・オークション表示（落札者一覧）を使用した開発に関するQ＆A

お役立ち度の高い解決済みの質問

Web APIとその他のサービス

API

その他

このAPIを使ったサンプルコード

関連ドキュメント

開発者ブログ

開発者コミュニティ

開発のヒント

法人デベロッパー専用お問い合わせ