質問投稿プレビュー

リクエストパラメータ

「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/postQuestionPreview

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/postQuestionPreview.xsd

フィールド	値	説明
ResultSet		クエリーレスポンスのすべてを含みます。
Result		各個別レスポンスを含みます。
CategoryId	integer	質問を投稿するカテゴリのIDです。
Title	CDATA	質問タイトルです。 （質問文の前方文字列を質問タイトルとして質問リストなどで表示します） CDATAで括られています。
Content	CDATA	質問内容本文です。 CDATAで括られています。
IsMobile	boolean	モバイル端末判定フラグです。
Image		画像データです。 画像がないときは子要素が空となります。
Width	integer	画像の幅です。 画像がないときはタグ自体生成しません。
Height	integer	画像の高さです。 画像がないときはタグ自体生成しません。
Url	anyURI	画像のURLです。 画像がないときはタグ自体生成しません。 一定期間のみアクセス可能なURLです。
AttributeCode	CDATA	属性コードです。 （key:valueの'|'記号区切りで取得されます） 詳細は属性コードの詳細仕様を参照してください。 CDATAで括られています。
CategoryIdPath	string	カテゴリIDパスです。 （ '|' 記号区切り ）
Category	CDATA	カテゴリ名です。 CDATAで括られています。
CategoryPath	CDATA	カテゴリ名パスです。 （ '|' 記号区切り ） CDATAで括られています。
Coin	integer	ベストアンサーの回答者にお礼として与える知恵コインの枚数です。
RequestFlg	integer	回答リクエストフラグです。 0 : リクエストなし 1 : 投稿カテゴリに詳しい回答者に、回答をリクエストします。

サンプルレスポンス

<?xml version="1.0" encoding="UTF-8"?> <ResultSet xmlns="urn:yahoo:jp:chiebukuro" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:yahoo:jp:chiebukuro"> <Result> <Title><![CDATA[破れたお金は交換してもらえますか？お金を子どもがびりびりに破いてしまいました。]]></Title> <Content><![CDATA[破れたお金は交換してもらえますか？お金を子どもがびりびりに破いてしまいました。破れたお金でもどこかで交換してくれると聞いたことがありますが、本当ですか？ ]]></Content> <IsMobile>false</IsMobile> <Image></Image> <AttributeCode><![CDATA[]]></AttributeCode> <CategoryId>2079240100</CategoryId> <CategoryIdPath>2078297513|2078297514|2079240100</CategoryIdPath> <Category><![CDATA[ニンテンドーDS]]></Category> <CategoryPath><![CDATA[エンターテインメントと趣味|ゲーム|ニンテンドーDS]]></CategoryPath> <Coin>0</Coin> <RequestFlg>0</RequestFlg> </Result> </ResultSet>

エラー

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

利用制限

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