知恵袋

質問投稿

リクエストURL
XML
https://chiebukuro.yahooapis.jp/Chiebukuro/V1/postQuestion
JSONP
https://chiebukuro.yahooapis.jp/Chiebukuro/V1/postQuestion

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

質問投稿は、Yahoo!知恵袋に質問を投稿する機能を提供します。質問には、画像や地図を添付することや、各ジャンルに詳しい人に回答をリクエストすることができます。

リクエストパラメータ

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

パラメータ説明
content
(必須)
string 投稿する質問文です。(UTF-8エンコード)
文字数制限 : 全角5文字以上かつ全角1000文字以下
mobile_uid string 質問者の携帯端末IDです。
モバイル端末から投稿する場合は必ず入れるようにしてください。
category_id string 知恵袋のカテゴリIDです。
中分類または小分類のカテゴリIDのみ指定可能です。
指定されていない場合は質問文から自動カテゴリ判定を行います。
coin integer: 0(デフォルト), 25, 50, 100, 250, 500(最大) ベストアンサーの回答者にお礼として与える知恵コインの枚数です。
質問した時点で質問者の知恵コインからマイナスされます。
is_mobile boolean: false(デフォルト), true モバイル端末判定フラグです。
  • false: モバイル端末以外
  • true: モバイル端末
モバイル端末からの利用時はtrueを設定してください。
image string 質問に添付する画像です。
画像ファイルのバイナリデータにbase64_encode(外部サイト)をかけた文字列を指定してください。
code string 属性コード(key:valueの'|'記号区切りで指定します)です。
詳細は属性コードの詳細仕様を参照してください。
request_flg integer: 0(デフォルト), 1 回答リクエスト種別です。
  • 0: 回答リクエストなし
  • 1: 投稿カテゴリに詳しい回答者に、回答をリクエストします(知恵コインを100枚消費します)
output string: xml(デフォルト), json 出力形式です。
利用可能な形式は下記の通り
  • xml: XML形式 (デフォルト)
  • json: JSON形式

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

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


サンプルリクエストURL

https://chiebukuro.yahooapis.jp/Chiebukuro/V1/postQuestion

サンプルリクエスト

POST /Chiebukuro/V1/postQuestion HTTP/1.1
Host: chiebukuro.yahooapis.jp
Content-Type: application/x-www-form-urlencoded
Content-Length: <メッセージボディのサイズ>
Authorization: Bearer <アクセストークン>

content=<投稿する質問文(UTF-8エンコード)>



レスポンスフィールド

質問投稿のスキーマの記述は、以下のURLをご覧ください。
http://chiebukuro.yahooapis.jp/Chiebukuro/V1/postQuestion.xsd

フィールド説明
ResultSet クエリーレスポンスのすべてを含みます。
Result 各個別レスポンスを含みます。
QuestionId integer 質問IDです。
QuestionUrl anyURI 質問詳細ページのURLです。
アクセスしたデバイスに応じてリダイレクトされます。



サンプルレスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet>
    <Result>
        <QuestionId>1212613047</QuestionId>
        <QuestionUrl>http://detail.chiebukuro.yahoo.co.jp/rd/q1212613047</QuestionUrl>
    </Result>
</ResultSet>



エラー

質問投稿はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。




利用制限

Yahoo!知恵袋Web APIは、24時間中1アプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。