オークション

マイオークション(値下げ交渉・交渉未成立削除)

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

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

ログインしているYahoo! JAPAN IDのマイ・オークションの「値下げ交渉・交渉未成立削除」を行います。

リクエストパラメータ

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

パラメータ 説明
output string XML、PHPserialize、JSONPでレスポンスの出し別けを行います。
  • xml :xmlレスポンス(デフォルト)
  • php :PHPserializeレスポンス
  • json :JSONPレスポンス
callback string JSONPとして出力する際のコールバック関数名を入力するためのパラメータです。UTF-8でエンコードした文字列を入力します。
auction_id string 削除を実施するオークションのオークションIDを指定します。
指定するオークションIDはカンマ区切りで最大20まで指定可能です。

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

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


サンプルリクエストURL

https://auctions.yahooapis.jp/AuctionWebService/V1/deleteMyOfferList?auction_id=x12345678,c87654321

サンプルリクエスト

GET /AuctionWebService/V1/deleteMyOfferList?auction_id=x12345678,c87654321 HTTP/1.1
Host: auctions.yahooapis.jp
Authorization: Bearer <アクセストークン> 



レスポンスフィールド

マイオークション(値下げ交渉・交渉未成立削除)APIのスキーマの記述は、以下になります。

フィールド 説明
/ResultSet クエリーレスポンスのすべてを含み、次の属性を持ちます。
  • totalResultsAvailable:該当件数の総個数です。
  • totalResultsReturned:返された値の個数です。
  • firstResultPosition:最初のデータが何個目に当たるかです。
/ResultSet/Result 各個別レスポンスを含みます。
/ResultSet/Result/AuctionId オークションIDです。
/ResultSet/Result/IsSuccess 値下げ交渉を成功した場合はtrue 失敗した場合にはfalseとなります。
/ResultSet/MyOfferListUrl マイオークション値下げ交渉タブのリクエストURLです。



サンプルレスポンス

<?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/deleteMyOfferList.xsd" totalResultsAvailable="2" totalResultsReturned="2" firstResultPosition="1">
  <Result>
    <AuctionId>x12345678</AuctionId>
    <IsSuccess>true</IsSuccess>
  </Result>
  <Result>
    <AuctionId>c87654321</AuctionId>
    <IsSuccess>true</IsSuccess>
  </Result>
  <MyOfferListUrl>http://auctions.yahooapis.jp/AuctionWebService/V1/myOfferList</MyOfferListUrl>
</ResultSet>



エラー

マイオークション(値下げ交渉・交渉未成立削除)はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。




利用制限

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