質問一覧API

お客様から受けたお問い合わせの一覧を取得することができます。

変更履歴

リクエストURL

リクエストパラメータ

「Web APIの使い方#GETとは」をご参照ください。

リクエストURL

• 必須△："dateType"が指定されている場合は必須

サンプルリクエストURL

https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/externalTalkList?
sellerId=xxxx&start=1&result=20

サンプルリクエスト

GET https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/externalTalkList?
sellerId=xxxx&start=1&result=20 HTTP/1.1
Host: circus.shopping.yahooapis.jp
Authorization: Bearer <アクセストークン>

レスポンスフィールド

カテゴリ情報

※投稿時に選択可能か：質問投稿時に親カテゴリ子カテゴリの関係となっており、子カテゴリを選択しないと投稿できないため、トピックのレスポンスには当該カテゴリIDは基本的に含まれません、

サンプルレスポンス

レスポンス（JSON）

{
  "summary": {
    "filter": "all",
    "unansweredCount": 10,
    "topic" : {
        "start" : 1,
        "end"   : 20,
        "count" : 100
    }
  },
  "headlines" : [
    {
        "topicId" : "dbea226919fb786f9a67cced881e4f1e57f4636f18b2b4f154feb3019f533dde",
        "isUnread" : true,
        "isNoAnswer": true,
　　　　　　　　"isCompleted": false,
        "firstPostTime": "1513076177",
        "updateTime": "1513776685",
        "qaType": "item",
        "isPrivate" :true,
        "category": 2,
        "title": "おすすめ商品でよく出てきますが・・",
        "body": "この商品はいつになったら買えるようになるんですか？¥n詳細を教えてください。",
        "messageCount": 10,
        "userMaskedId" : "jUDidkaE",
        "itemCode" : "teststore_2147483647",
        "orderId": null

    },
    {
        "topicId" : "e510844686b22b11bb579c0ee09828cbce7302f045968320d419769697327c18",
        "isUnread" : true,
        "isNoAnswer": true,
　　　　　　　　"isCompleted": false,
        "firstPostTime": "1513076177",
        "updateTime": "1513776685",
        "qaType": "item",
        "isPrivate" :false,
        "category": 1,
        "title": "対応機種について",
        "body": "この商品は機種xxxxに対応していますか？",
        "messageCount": 8,
        "userMaskedId" : "8eIdgIqq",
        "itemCode" : "teststore_050",
        "orderId": null
    },
    {
        "topicId" : "42bc351b04925b8dd3448c4a6570b1183897701e00e724956e106b864af77890",
        "isUnread" : false,
        "isNoAnswer": false,
　　　　　　　　"isCompleted": true,
        "firstPostTime": "1513076177",
        "updateTime": "1513779842",
        "qaType": "order",
        "userMaskedId" : "iOdie31",
        "isPrivate" :true,
        "category": 11,
        "title": "住所変更を希望します。",
        "body": "12/19に注文させていただきました、矢風と言います。¥n注文先の変更をさせてください。¥n¥n変更前： 〒107-6211 東京都港区赤坂9-7-1 ミッドタウン・タワー¥n¥n変更後〒102-8282: 東京都千代田区紀尾井町1-3: 東京ガーデンテラス紀尾井町 紀尾井タワー¥n¥n宜しくお願いします。",
        "messageCount": 2,
        "userMaskedId" : "8eIdgIqq",
        "itemCode" : null,
        "orderId": "teststore-10015077"
    }
  ]
}

エラー

Yahoo!ショッピングで提供している全てのAPIには、共通で利用するエラーコードがあります。エラーの際には、まず始めに以下をご確認ください。

• Yahoo! ショッピングAPI共通エラーコード一覧

質問一覧APIで固有に返すエラーコードは以下をご覧ください。

各エラーにおいて、次の形式のJSONレスポンスを返します。

{
     error : {
        reason: "Bad Request"
     }
}

ご注意

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

• Yahoo! ID連携
• Yahoo! ID連携によるAPIアクセス実装方法

※こちらのAPIを利用する場合は、こちらからClient ID（アプリケーションID）を取得してください。

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）

利用約款

このAPIに関する利用約款はこちら。