オークション

マイ・オークション表示（ウォッチリスト・終了したオークション）

Version 1 ｜ Version 2

リクエストURL

XML

http://auctions.yahooapis.jp/AuctionWebService/V2/closeWatchList

ログインしているYahoo! JAPAN IDのマイ・オークションの「ウォッチリスト・終了したオークション」を参照します。

リクエストパラメータ

パラメータ	値	説明
start	integer	参照するページ番号を指定します。

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

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V2/openWatchList?start=<参照するページ番号> 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/V2/closeWatchList.xsd

フィールド	説明
ResultSet	クエリーレスポンスのすべてを含み、次の属性を持ちます。 totalResultsAvailable：該当件数の総個数です。 totalResultsReturned：返された値の個数です。 firstResultPosition：最初のデータが何個目に当たるかです。
Result	各個別レスポンスを含みます。
AuctionID	オークションIDです。
Title	商品のタイトルです。
SoldPrice	落札価格です。¥記号やカンマは含みません。小数点第二位までの精度です。
Bids	入札数です。
YPoint	Yahoo!ポイントのレートです。小数点第一までの精度です。
Id	出品者のYahoo! JAPAN IDです。
ItemListUrl	出品者の出品リストを取得するリクエストURLです。（appidは含まれていませんのでご注意ください）。
EndTime	終了日時です。RFC3339に準拠した表現を用います。(例：`2004-04-01T12:00:00+09:00`)
AuctionItemUrl	商品詳細のURLです。
Image	画像（サムネイル）の情報です。
Url	画像（サムネイル）のURLです。
Width	画像（サムネイル）の幅です。
Height	画像（サムネイル）の高さです。
Option	各オプションの設定状況です。
StoreIconUrl	ストア商品の場合ストアアイコンのURLが設定されます。
NewIconUrl	出品されてから間もない商品に付く「New」アイコンのURLです。
FeaturedIconUrl	注目のオークション設定アイコンのURLです。
CheckIconUrl	「鑑定済み」アイコンの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:closeWatchList" xsi:schemaLocation="urn:yahoo:jp:auc:closeWatchList http://auctions.yahooapis.jp/AuctionWebService/V2/closeWatchList.xsd" totalResultsAvailable="220" totalResultsReturned="50" firstResultPosition="101">
  <Result> 
    <AuctionID>x12345678</AuctionID> 
    <Title>商品名１</Title> 
    <SoldPrice>120.00</SoldPrice> 
    <Bids>12</Bids> 
    <YPoint>10.0</YPoint> 
    <Seller>
      <Id>hogeHoge</Id>
      <ItemListUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=hogeHoge</ItemListUrl>
    </Seller> 
    <EndTime>2004-04-08T12:00:00+09:00</EndTime> 
    <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> 
      <StoreIconUrl>http://image.auctions.yahoo.co.jp/images/premium.gif</StoreIconUrl> 
      <NewIconUrl /> 
      <EscrowIconUrl /> 
      <FeaturedIconUrl /> 
      <CheckIconUrl /> 
      <FreeShippingIconUrl>http://image.auctions.yahoo.co.jp/images/pstfree.gif</FreeShippingIconUrl> 
      <WrappingIconUrl>http://image.auctions.yahoo.co.jp/images/gift.gif</WrappingIconUrl> 
      <BuynowIconUrl>http://image.auctions.yahoo.co.jp/images/buynow.gif</BuynowIconUrl> 
      <EasyPaymentIconUrl>http://i.yimg.jp/images/pay/icon_s16.gif</EasyPaymentIconUrl> 
      <GiftIconUrl>http://a1017.lm.a.yimg.com/7/1017/1783/000/image.auctions.yahoo.co.jp/images/gift/c_attention_04.gif</GiftIconUrl> 
      <ItemStatusNewIconUrl />
      <YBankIconUrl>http://i.yimg.jp/images/sicons/bank16.gif</YBankIconUrl> 
      <EnglishIconUrl />
      <StarClubIconUrl />
      <PointIconUrl />
      <IsBold>true</IsBold> 
      <IsBackGroundColor>false</IsBackGroundColor> 
    </Option> 
  </Result> 
  <Result> 
    <AuctionID>x987654321</AuctionID> 
    <Title>商品名２</Title> 
    <SoldPrice>1120.00</SoldPrice> 
    <Bids>3</Bids> 
    <YPoint>0.0</YPoint> 
    <Seller>
      <Id>hogeHoge</Id>
      <ItemListUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=hogeHoge</ItemListUrl>
    </Seller> 
    <EndTime>2004-04-08T12:10:00+09:00</EndTime> 
    <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> 
      <StoreIconUrl>http://image.auctions.yahoo.co.jp/images/premium.gif</StoreIconUrl> 
      <NewIconUrl>http://image.auctions.yahoo.co.jp/i/auctions/new3.gif</NewIconUrl> 
      <EscrowIconUrl>http://image.auctions.yahoo.co.jp/images/uketorigo.gif</EscrowIconUrl> 
      <FeaturedIconUrl>http://image.auctions.yahoo.co.jp/images/featured.gif</FeaturedIconUrl> 
      <CheckIconUrl>http://i.yimg.jp/i/auctions/help/2-10-6.gif</CheckIconUrl> 
      <FreeShippingIconUrl /> 
      <WrappingIconUrl /> 
      <BuynowIconUrl /> 
      <EasyPaymentIconUrl /> 
      <GiftIconUrl /> 
      <ItemStatusNewIconUrl />
      <YBankIconUrl /> 
      <EnglishIconUrl />
      <StarClubIconUrl />
      <PointIconUrl /> 
      <IsBold>false</IsBold> 
      <IsBackGroundColor>true</IsBackGroundColor> 
    </Option> 
  </Result> 
</ResultSet>

エラー

マイ・オークション表示（ウォッチリスト・終了したオークション）Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

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

マイ・オークション表示（ウォッチリスト・終了したオークション）

リクエストURL

リクエストパラメータ

レスポンスフィールド

サンプルレスポンス

エラー

利用制限

マイ・オークション表示（ウォッチリスト・終了したオークション）を使用した開発に関するQ＆A

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

Web APIとその他のサービス

API

その他

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

関連ドキュメント

開発者ブログ

開発者コミュニティ

開発のヒント

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