インスタントアンサー
インスタントアンサーを計算します — 計算機、単位・通貨換算、世界時計、辞書定義、ハッシュ、QRコード など二十数ファミリー — すべて Suede 上で:外部呼び出しはゼロ、質問が第三者に届くことはありません。
GET /v1/answers?q=100+usd+to+eur
Authorization: Bearer suede_live_…既定ではメンバーシップに含まれます:呼び出しは /v1/usage の requests
に billable_units 0 で記録され、クレジットを消費しません。(プラットフォームは従量課金 — 検索
と同じく1呼び出し1ユニット — に切り替えることがあり、その場合は X-Credits-* ヘッダーと
insufficient_credits の意味論が適用されます。)
パラメーター
| パラメーター | 必須 | 意味 |
|---|---|---|
q |
はい | 質問。最大512文字。 |
hl |
いいえ | 解析言語:en、ar、de、es、fr、ja。未知の値は en にフォールバック。「12フィートをメートルに」は hl=ja で解析されます。 |
gl |
いいえ | 地域依存の答えに対する地域バイアス。 |
レスポンス
answered: false(HTTP 200)が通常の正常な結果です — ほとんどのクエリはウェブ検索です。
answered が true のとき、answer には次が含まれます:
kind— ファミリー(calculator、currency、time_zone、definitionsなど)。バージョンを 上げずに新種が追加されることがあります:未知の種類は汎用カードとして扱ってください。primary、expression、secondary、items[]— カードの内容(不変フォーマット)。- 安定した識別子 —
primary_label、items[].label、disclosure.key(およびprimary_is_keyが true のときのprimary)は安定した機械可読のanswers.*識別子です:改名 されることはなく、新しいものが追加されることはあります。 copy_text— 機械形式(生の数値、ISO時刻、ダイジェスト)。null ならprimaryを使用。svg— 視覚系ファミリー(QR、色見本)のインラインSVG。信頼できない画像として隔離してください。is_error— エラーカード(ゼロ除算):診断つきで答えたことを意味します(primary_labelにanswers.err.*)。timezone—kind: time_zoneの世界時計モデル:場所ごとの行(ゾーン、現地時刻・日付、UTC オフセット、夏時間、昼/夜、日付のずれ、次の切替)と、行ごとの24文字meeting_strip(n夜、d昼、b営業時間)。definitions—kind: definitionsの辞書モデル:見出し語、IPA、品詞ごとの語義、source_url+license(CC BY-SA 4.0 — この内容を表示する際は出典を表示またはリンクしてください)。 アラビア語の項目は現在英語の定義です(gloss_lang: "en")。
補足:
client_infoは API 呼び出し元を示します — あなたのサーバーであり、エンドユーザーでは ありません。- 通貨は ECB の日次参考レートを使用し、
disclosureにレート日付が入ります。参考情報です。 - タイマーはウェブ専用ウィジェットで、API では決して答えません。
通常のレート制限が適用されます。完全なスキーマは OpenAPI ドキュメントにあります。