在您的產品中嵌入經過驗證的評估。

它將 JobCannon 評估引擎作為可程式設計服務公開供您的產品呼叫。您的使用者在自己的應用內進行經過驗證的評估 — RIASEC、Big Five、EQ、Skills Audit 或任何 205+ 項工具 — 您會獲得經過評分的結果。完整循環是三個 REST 呼叫：POST /api/v1/assessments 啟動會話並返回問題集；GET /api/v1/assessments/{session_id}/questions 如果需要再次取得這些問題；POST /api/v1/assessments/{session_id}/complete 提交答案、進行伺服器端評分，並返回結果。與消費者產品使用的相同評分程式碼路徑（lib/scoring/compute.ts）在 API 後面執行，因此 API 結果與在 jobcannon.io 上進行的結果相同。

每個請求都帶有 X-API-Key 標頭。您的金鑰看起來像 jck_live_…，按組織頒發，帶有作用域 — assessments:send 允許您啟動和完成會話，assessments:read 允許您重新取得問題。金鑰在靜態下進行 SHA-256 雜湊，永遠不會以明文儲存。沒有 OAuth 舞蹈，沒有客戶端金鑰交換：一個標頭、範圍化、可撤銷。會話是啟動呼叫返回的短期有效簽名令牌，因此您一方不需要會話表來管理，也無需輪詢。

POST /api/v1/assessments — 正文 { test, locale?, external_user_id?, pool? }；返回 { session_id, test, locale, question_pool, total_questions, questions[] }。GET /api/v1/assessments/{session_id}/questions — 為進行中的會話重新提供問題有效負載（作用域 assessments:read）。POST /api/v1/assessments/{session_id}/complete — 正文 { answers: number[], external_user_id? }，其中答案是提供問題順序中的選項索引；返回 { result_id, test, top_result, scores, question_pool }。答案在評分前經過長度和退化/未觸及向量驗證。池化工具（例如 IQ 電池）透過提供的問題池傳遞到正確的評分金鑰。

每項完成的評估都持久化到您的組織 — 結果行使用您的 api_org_id 編寫，因此歸屬於您，而不是匿名瀏覽器會話或 JobCannon 消費者帳戶。完成呼叫返回 result_id、top_result（該工具的標題原型類型/代碼）和完整的按維度分數。您儲存 result_id 並按您喜歡的方式在您的產品內呈現結果。當前 v1 返回評分結果；更豐富的 AI Career Guide 敘述（課程建議、2,521 職業對映）是單獨的消費者表面，按合作方範圍確定，不是預設 v1 響應。

請求按 API 金鑰（金鑰標識，而不是呼叫者 IP）進行速率限制，因此一個麻煩的整合永遠不會餓死另一個。超過限制時，您會獲得 HTTP 429，正文中帶有 resetAt 時間戳 — 無無聲限制、無丟棄請求。每個啟動和完成呼叫都計入，因此您的月度評估計數對於計費是準確的。

在內部構建職業評估的團隊通常低估了兩個成本。(1) 經過驗證的項庫和評分 — 構建和驗證您自己的需要數年和數萬次施用。(2) 維護 — 工具會漂移，項庫需要重新整理。API 是捷徑：您呼叫三個端點，我們保持心理測驗最新。它在 Scale 層級（$199/mo）上線，包含每月評估配額。配額按評估計算：您分配的每一項評估都會消耗一個名額。重新銷售我們評估的白標合作方可以改用收入分享。