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

Version 1

リクエストURL

XML

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

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

リクエストパラメータ

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

パラメータ	値	説明
auction_id	string	削除を実施するオークションのオークションIDを指定します。指定するオークションIDはカンマ区切りで最大20まで指定可能です。

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

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V1/deleteMyOfferList?auction_id=x12345678,c87654321 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/deleteMyOfferList.xsd

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

サンプルレスポンス

以下は、auction_id=x12345678,c87654321 のクエリーの結果です。

<?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>

エラー

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

利用制限

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