知恵袋
回答投稿・編集プレビュー
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 | モバイル端末判定フラグです。
|
| image | string | 回答に添付する画像です。 画像ファイルのバイナリデータにbase64_encode(外部サイト)をかけた文字列を指定してください。 回答投稿のみ。 |
| code | string | 属性コードです。(key:valueの'|'記号区切りで指定します) 詳細は属性コードの詳細仕様を参照してください。 回答投稿のみ。 |
| output | string: xml(デフォルト), json | 出力形式です。 利用可能な形式は下記の通り
|
・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=<シグネチャの内容>
属性コードの詳細仕様
属性コードはオプションの扱いで必須ではありません。
下記に記述されているもののみ許可します。
| 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 | 地図種別です。
|
緯度 : 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 | 回答内容本文です。 |
| 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に共通のエラーメッセージおよびコードを返します。