統合パスを選ぶ
Quravin を呼び出す 4 つの方法 — プレーンな Web ページ、React SPA、Node.js サーバー、SDK なしの生の API。自分のスタックに合うものを選んでください。
以下のどのパスも、最終的には同じ API を呼び出します。違うのはコードがどこで動くかと自分の スタックに何がすでにあるかです — どれが一番高度に聞こえるかではなく、それをもとに選んでください。
どれがあなたに当てはまるか
| あなたの状況 | ガイド |
|---|---|
プレーンな HTML ページ（サーバーレンダリング、静的、または任意のサイトに埋め込んだ <script> タグ）— ビルドステップもフレームワークも不要 | プレーンな Web ページでの直接統合 |
| React のシングルページアプリ — 生の script タグではなく、SDK をコンポーネントの state に組み込みたい | React SPA 統合 |
| Node.js の backend — ブラウザフロントエンド向けに session token を発行するか、サーバー専用コード（cron job、webhook ハンドラ、CLI）から直接 API を呼び出す | Node.js サーバー統合 |
| それ以外の言語、または依存関係を増やしたくない — 正確な HTTP リクエストだけが欲しい | Direct API integration |
これらに取り組む前に
まず資格情報が必要です — API キーを取得する を参照してください。
上記のどのパスも、client_id/client_secret のペア（session JWT を発行するため）か、静的な
x-api-key のどちらかが必要です。認証モードを選ぶ で、
コードがどこで動くかに応じてどちらが合うかを説明しています。
急いでいる場合の要約
- ブラウザのコード（Web ページまたは React） → 自分の backend が発行する session JWT を
使ってください。静的な
x-api-keyをブラウザに配布されるコードに絶対に含めないでください。 - サーバー専用のコード（Node.js backend、cron job、内部サービス） → どちらのモードでも
動作します。ユーザーごとの帰属が不要であれば、静的な
x-api-keyの方がシンプルです。 - SDK をまったく使わない場合 → Direct API integration
ガイドはどの言語からでも使え、両方の認証モードがプレーンな
curlの例として示されています。