オークション

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

リクエストURL
XML
https://auctions.yahooapis.jp/AuctionWebService/V1/closeWatchList

※2012/11/7以前に取得されたOAuth1.0のConsumer Keyをご利用頂く場合のリクエストURLは
http://auctions.yahooapis.jp/AuctionWebService/V1/closeWatchList となります

こちらのAPIは、2015年4月15日に終了させていただきました。最新バージョンのAPIをご利用ください。

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

リクエストパラメータ

RESTリクエストの構築(GET)」をご参照ください。

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

※こちらのAPIはYahoo! ID連携に対応したAPIです。
Yahoo! ID連携によるAPIアクセス方法の詳細は、以下のページをご確認ください。
Yahoo! ID連携
Yahoo! ID連携によるAPIアクセス実装方法

※アプリケーションIDを取得する際に「マイ・オークション関連の機能」スコープを選択してください。
スコープの詳細は、「スコープに関して」でご確認ください。


サンプルリクエストURL

https://auctions.yahooapis.jp/AuctionWebService/V1/closeWatchList?page=<参照するページ番号>

サンプルリクエスト

GET /AuctionWebService/V1/closeWatchList?page=<参照するページ番号> HTTP/1.1
Host: auctions.yahooapis.jp
Authorization: Bearer <アクセストークン> 



レスポンスフィールド

マイ・オークション表示(ウォッチリスト・終了したオークション)のスキーマの記述は、以下のURLをご覧ください。
http://auctions.yahooapis.jp/AuctionWebService/V1/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
Image 画像(サムネイル)のURLです。
Option 各オプションの設定状況です。
StoreIcon ストア商品の場合、「ストア」アイコンのURLです。
NewIcon 「new」アイコンのURLです。
FeaturedIcon 「注目のオークション」アイコンのURLです。
CheckIcon 「鑑定済み」アイコンのURLです。
FreeShippingIcon 「送料無料」アイコンのURLです。
WrappingIcon 「贈答品」アイコンのURLです。
BuynowIcon 「即決価格あり」アイコンのURLです。
EasyPaymentIcon 「Yahoo!かんたん決済」アイコンのURLです。
GiftIcon 「目立ち」アイコンのURLです。
YBankIcon Yahoo!ネットバンキング対応の場合、「Yahoo!ネットバンキング」アイコンのURLが設定されます。
isBold 太字の設定です。(ある:true ない:false
isBackGroundColor 背景色の設定です。(ある:true ない:false



サンプルレスポンス

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

<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet totalResultsAvailable="220" totalResultsReturned="50" firstResultPosition="101">
    <Result>
        <AuctionID>x12345678</AuctionID>
        <Title>商品名1</Title>
        <SoldPrice>120.00</SoldPrice>
        <Bids>12</Bids>
        <YPoint>10.0</YPoint>
        <Seller>
            <Id>test_user</Id>
            <ItemListUrl>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=test_user</ItemListUrl>
        </Seller>
        <EndTime>2004-04-08T12:00:00+09:00</EndTime>
        <Image>http://a1017.lm.a.yimg.com/7/1017/1783/000/f03batchimg.auctions.yahoo.co.jp/users/5/2/7/1/xxxxx-thumb-1208052000152677.jpg</Image>
        <Option>
            <StoreIcon>http://image.auctions.yahoo.co.jp/images/premium.gif</StoreIcon>
            <NewIcon />
            <EscrowIcon />
            <FeaturedIcon />
            <CheckIcon />
            <FreeShippingIcon>http://image.auctions.yahoo.co.jp/images/pstfree.gif</FreeShippingIcon>
            <WrappingIcon>http://image.auctions.yahoo.co.jp/images/gift.gif</WrappingIcon>
            <BuynowIcon>http://image.auctions.yahoo.co.jp/images/buynow.gif</BuynowIcon>
            <EasyPaymentIcon>http://i.yimg.jp/images/pay/icon_s16.gif</EasyPaymentIcon>
            <GiftIcon>http://a1017.lm.a.yimg.com/7/1017/1783/000/image.auctions.yahoo.co.jp/images/gift/c_attention_04.gif</GiftIcon>
            <YBankIcon>http://i.yimg.jp/images/sicons/bank16.gif</YBankIcon>
            <isBold>true</isBold>
            <isBackGroundColor>false</isBackGroundColor>
        </Option>
    </Result>

    (以下 <Result>要素繰り返し)

</ResultSet>



エラー

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

このWeb APIはOAuth対応のWeb APIに共通の エラーメッセージおよびコード を返します。




利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。(1クエリー/秒)
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を解除させていただきます。(無料)
まずはヘルプページのお問い合わせフォームからご相談ください。