オークション

マイオークション表示（値下げ交渉）

Version 1

リクエストURL

XML

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

ログインしているYahoo! JAPAN IDのマイ・オークションの「値下げ交渉」を参照します。

リクエストパラメータ

パラメータ	値	説明
start	integer	参照するページ番号を指定します。
list	offer（デフォルト）/dec_offer	一覧の種類を指定します。 offer ：交渉中の一覧を返却します。 dec_offer ：交渉未成立の一覧を返却します。
sort	item/bidorbuy/ ofpr/ofut （デフォルト：ofut）	リストの並べ替え項目を指定します。指定のない場合は交渉期限の短い順になります。 item ：タイトル bidorbuy ：即決価格 ofpr ：交渉価格 ofut ：交渉期限項目の前に以下の記号を付与することで、昇順降順を変更できます。+(昇順)/-(降順)　※UTF-8にエンコードされている必要あり。(※listにdec_offerを指定した場合、無効となります)

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

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V1/myOfferList?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/V1/myOfferList.xsd

フィールド	説明
ResultSet	クエリーレスポンスのすべてを含み、次の属性を持ちます。 totalResultsAvailable：該当件数の総個数です。 totalResultsReturned：返された値の個数です。 firstResultPosition：最初のデータが何個目に当たるかです。
Result	各個別レスポンスを含みます。
AuctionId	商品（オークション）のIDです。
Title	商品（オークション）のタイトルです。
BidorbuyPrice	即決価格です。¥記号やカンマは含みません。小数点第二位までの精度です。
OfferPrice	交渉価格です。¥記号やカンマは含みません。小数点第二位までの精度です。複数回交渉を行った場合、最新の交渉価格が表示されます。パラメータlistの値がdec_offerの場合も、最後に交渉した価格が表示されます。
OfferLeftTime	交渉期限日時です。RFC3339に準拠した表現を用います。 (例：`2004-04-01T12:00:00+09:00`) パラメータlistの値がdec_offerの場合は空データが返却されます。
AuctionItemUrl	商品（オークション）のURLです。
Image	画像（サムネイル）の設定です。
Url	画像（サムネイル）のURLです。
Width	サムネイルの横幅です。
Height	サムネイルの縦幅です。
Option	各オプションの設定状況です。
StoreIconUrl	ストア商品の場合ストアアイコンのURLが設定されます。設定されていない場合空データが返却されます。
CheckIconUrl	「鑑定済み」アイコンのURLです。設定されていない場合空データが返却されます。
FeaturedIconUrl	注目のオークション設定アイコンのURLです。設定されていない場合空データが返却されます。
FreeshippingIconUrl	「送料無料」のアイコンのURLです。設定されていない場合空データが返却されます。
NewItemIconUrl	「新品」アイコンのURLです。設定されていない場合空データが返却されます。
GiftIconUrl	「目立ち」アイコンのURLです。設定されていない場合空データが返却されます。
WrappingIconUrl	「贈答品」アイコンのURLです。設定されていない場合空データが返却されます。
BuynowIconUrl	「即買」アイコンのURLです。設定されていない場合空データが返却されます。
YBankIconUrl	Yahoo!ネットバンキング対応の場合にYahoo!ネットバンキングアイコンのURLが設定されます。設定されていない場合空データが返却されます。
EasyPaymentIconUrl	「Yahoo!かんたん決済」アイコンのURLです。設定されていない場合空データが返却されます。
EnglishIconUrl	「Yahoo!オークション英語版」アイコンの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" xsi:schemaLocation="urn:yahoo:jp:auc:myOfferList http://auctions.yahooapis.jp/AuctionWebService/V1/myOfferList.xsd" totalResultsAvailable="2" totalResultsReturned="2" firstResultPosition="1">
  <Result>
     <AuctionId>1445588</AuctionId>
     <Title>値下げあり</Title>
     <BidorbuyPrice>120.00</BidorbuyPrice>
     <OfferPrice>111.00</OfferPrice>
     <OfferLeftTime>2009-07-03T11:55:38+09:00</OfferLeftTime>
     <AuctionItemUrl>http://page.auctions.yahoo.co.jp/jp/auction/1445588</AuctionItemUrl>
     <Image>
        <Url>http://i.yimg.jp/images/auct/template/ui/search/na_134x100.gif</Url>
        <Width>134</Width>
         <Height>100</Height>
     </Image>
     <Option>
        <FeaturedIconUrl/>
        <FreeShippingIconUrl/>
        <EscrowIconUrl/>
        <NewItemIconUrl/>
        <GiftIconUrl/>
        <WrappingIconUrl/>
        <BuynowIconUrl>http://image.auctions.yahoo.co.jp/images/buynow.gif</BuynowIconUrl>
        <YBankIconUrl>http://i.yimg.jp/images/sicons/bank16.gif</YBankIcon>
        <EasyPaymentIconUrl>http://i.yimg.jp/images/pay/icon_s16.gif</EasyPaymentIconUrl>
        <PointIconUrl/>
        <EnglishIconUrl/>
        <IsBold>false</IsBold>
        <IsBackGroundColor>false</IsBackGroundColor>
     </Option>
  </Result>
  <Result>
     <AuctionId>1445592</AuctionId>
     <Title>値下げ交渉あり</Title>
     <BidorbuyPrice>1200.00</BidorbuyPrice>
     <OfferPrice>1000.00</OfferPrice>
     <OfferLeftTime>2009-07-03T11:59:52+09:00</OfferLeftTime>
     <AuctionItemUrl>http://page.auctions.yahoo.co.jp/jp/auction/1445592</AuctionItemUrl>
     <Image>
        <Url>http://i.yimg.jp/images/auct/template/ui/search/na_134x100.gif</Url>
        <Width>134</Width>
        <Height>100</Height>
     </Image>
     <Option>
        <FeaturedIconUrl/>
        <FreeShippingIconUrl/>
        <EscrowIconUrl/>
        <NewItemIconUrl>http://image.auctions.yahoo.co.jp/images/gift/c_attention_01.gif</NewItemIconUrl>
        <GiftIconUrl>http://a1017.lm.a.yimg.com/7/1017/1783/000/image.auctions.yahoo.co.jp/images/gift/c_attention_03.gif</GiftIconUrl>
        <WrappingIconUrl>http://image.auctions.yahoo.co.jp/images/wrapping.gif</WrappingIconUrl>
        <BuynowIconUrl>http://image.auctions.yahoo.co.jp/images/buynow.gif</BuynowIconUrl>
        <YBankIconUrl>http://i.yimg.jp/images/sicons/bank16.gif</YBankIconUrl>
        <EasyPaymentIconUrl>http://i.yimg.jp/images/pay/icon_s16.gif</EasyPaymentIconUrl>
        <PointIconUrl/>
        <EnglishIconUrl/>
        <IsBold>true</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

その他

関連ドキュメント

開発者ブログ

開発者コミュニティ

開発のヒント

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