知恵袋

質問投稿プレビュー

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

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

質問投稿プレビューは、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/postQuestionPreview

サンプルリクエスト

POST /Chiebukuro/V1/postQuestionPreview 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/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>



エラー

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




利用制限

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