選擇您的整合路徑
四種呼叫 Quravin 的方式 — 純網頁、React SPA、Node.js 伺服器，或不使用 SDK 的原生 API。選擇符合您技術棧的那一種。
以下每一條路徑最終都會呼叫同一個 API。差別在於您的程式碼跑在哪裡，以及您的技術棧裡已經有 什麼 — 請依此判斷，而不是哪一種聽起來比較進階。
哪一種是您的情況？
| 您的情況 | 指南 |
|---|---|
純 HTML 頁面（伺服器端渲染、靜態頁面，或隨手加進任何網站的 <script> 標籤）— 無需建置步驟，無需框架 | 純網頁直接整合 |
| React 單頁應用 — 您希望把 SDK 接進元件狀態，而不是用原生的 script 標籤 | React SPA 整合 |
| Node.js backend — 為瀏覽器前端發行 session token，或直接從純伺服器端程式碼呼叫 API（cron job、webhook 處理器、CLI） | Node.js 伺服器整合 |
| 其他任何語言，或您不想額外加入依賴套件 — 只想要確切的 HTTP 請求 | Direct API 整合 |
在此之前
您需要先準備憑證 — 見 取得您的 API 金鑰。上面每一條路徑都需要
client_id/client_secret 組合（用來發行 session JWT）或靜態的 x-api-key；
選擇您的認證模式 說明了在您程式碼實際執行的位置，哪一種
比較合適。
如果您趕時間，簡短版本在這裡
- 瀏覽器程式碼（純網頁或 React） → session JWT，由您自己的 backend 發行。絕對不要把靜態的
x-api-key放進會送到瀏覽器的程式碼中。 - 純伺服器端程式碼（Node.js backend、cron job、內部服務） → 兩種模式都可以；如果您不需要
每位使用者的歸屬，靜態的
x-api-key較為簡單。 - 完全不使用 SDK → Direct API 整合 指南適用於任何
語言，並以純
curl範例展示兩種認證模式。