質問投稿

リクエストパラメータ

「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形式

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

サンプルリクエストURL

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

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=<シグネチャの内容>

属性コードの詳細仕様
属性コードはオプションの扱いで必須ではありません。
下記に記述されているもののみ許可します。

key	型	valueの例	説明
mapflag	integer	1	質問に地図情報が添付される場合に指定します。 質問に地図情報が添付され質問詳細画面で地図が表示されます。 例 : 緯度、経度が指定されているときのみ有効 質問者の意思で質問に地図情報をつける場合のみ指定してください。
lat	float	35.99884642455815	緯度です。(世界測地系) mapflag:1かつ経度が指定されているときのみ有効
lng	float	138.52166956459763	経度です。(世界測地系) mapflag:1かつ緯度が指定されているときのみ有効
sc	integer	7	地図のスケールです。(Yahoo!地図に対応) mapflag:1のときのみ有効
mode	string	map,aero	地図種別です。 map : 地図 aero: 航空写真 mapflag:1のときのみ有効

code指定の例
緯度 : 35.632807049678
経度 : 139.88091465467
スケール : 4
地図種別 : 航空写真
↓
mapflag:1|lat:35.632807049678|lng:139.88091465467|sc:4|mode:aero

レスポンスフィールド

質問投稿Web APIのスキーマの記述は、以下の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>

エラー

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

利用制限

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