ログイン
IDでもっと便利に[ 新規取得 ]

知恵袋

回答投稿・編集プレビュー

Version 1

リクエストURL

XML

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

JSONP

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

回答投稿・編集プレビューは、Yahoo!知恵袋に回答を投稿する前に、回答内容を確認する機能を提供します。 回答文や回答に添付した画像・地図情報などを確認できます。

リクエストパラメータ

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

パラメータ説明
content
(必須)
string 投稿する回答文です。(UTF-8エンコード)
文字数制限 : 全角10文字以上かつ全角2000文字以下
question_id
(必須)
integer 質問IDです。
answer_id integer 回答IDです。
回答編集時のみ必須です。
mobile_uid string 回答者のモバイル端末IDです。
モバイル端末から投稿する場合は必ず入れるようにしてください。
is_mobile boolean: false(デフォルト), true モバイル端末判定フラグです。
  • false: モバイル端末以外
  • true: モバイル端末
モバイル端末からの利用時はtrueを設定してください。
image string 回答に添付する画像です。
画像ファイルのバイナリデータにbase64_encode(外部サイト)をかけた文字列を指定してください。
回答投稿のみ。
code string 属性コードです。(key:valueの'|'記号区切りで指定します)
詳細は属性コードの詳細仕様を参照してください。
回答投稿のみ。
output string: xml(デフォルト), json 出力形式です。
利用可能な形式は下記の通り
  • xml: XML形式 (デフォルト)
  • json: JSON形式
※上記のパラメータ以外にOAuthのAuthorizationヘッダが必要になります。OAuthのAuthorizationヘッダについては、以下のサイトで詳細をご確認ください。
OAuthのフロー
OAuthを用いたAPIリクエスト
※Consumer Keyを取得する際に「回答投稿関連の機能」スコープを選択してください。スコープの詳細は、「スコープに関して」でご確認ください。

サンプルリクエストURL

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


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

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

keyvalueの例説明
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/postAnswerPreview.xsd

フィールド説明
ResultSet

クエリーレスポンスのすべてを含みます。

Result

各個別レスポンスを含みます。

Content CDATA

回答内容本文です。
CDATAで括られています。

QuestionId integer

質問IDです。

QuestionUrl anyURI

質問詳細ページのURLです。
アクセスしたデバイスに応じてリダイレクトされます。

AnswerId integer 回答IDです。
回答編集時のみタグが生成されます。
IsMobile boolean モバイル端末判定フラグです。
Image 画像データです。
画像がないときは子要素が空となります。
Width integer 画像の幅です。
画像がないときはタグ自体生成しません。
Height integer 画像の高さです。
画像がないときはタグ自体生成しません。
Url anyURI 画像のURLです。
画像がないときはタグ自体生成しません。
一定期間のみアクセス可能なURLです。
AttributeCode CDATA 属性コードです。(key:valueの'|'記号区切りで取得されます)
詳細は属性コードの詳細仕様を参照してください。
CDATAで括られています。

サンプルレスポンス

エラー

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

利用制限

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

このAPIを使ったサンプルコード

開発者ブログ

Yahoo! JAPANのスタッフや著名なデベロッパーのブログを紹介しています。新しいサービスのアイデアにお役立てください。

開発者コミュニティ

Yahoo!グループに開発者のためのグループを用意しています。ほかのデベロッパーと交流し、質問やアイデアの共有にお役立てください。

法人デベロッパー専用お問い合わせ