Вбудовуйте перевірені оцінювання у свій продукт.

Він надає двигун оцінювання JobCannon як програмовний сервіс, який може викликати ваш продукт. Ваші користувачі проходять перевірене оцінювання — RIASEC, Big Five, EQ, Skills Audit або будь-які з 186+ інструментів — усередину вашого власного додатку, і ви отримуєте назад оцінений результат. Повний цикл становить три виклики 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 та обміну секретом клієнта: один заголовок, обмежений, можна відкликати. Сесія — це короткотривалий підписаний токен, повернений виклику start, тому немає таблиці сесій для керування на вашій стороні та немає опитування.

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. Виклик complete повертає result_id, top_result (заголовне архетип/тип/код для цього інструменту) та повні оцінки за розміром. Ви зберігаєте result_id та відображаєте результат всередину вашого продукту так, як вам подобається. Поточна v1 повертає оцінений результат; більш багата розповідь AI Career Guide (рекомендації курсів, відображення 2 521-кар'єри) — це окрема поверхня споживача та розраховується для кожного партнера, а не стандартна відповідь v1.

Запити обмежуються за ключем API (ідентифікація ключа, не IP-адреса абонента), тому одна шумна інтеграція ніколи не голодує іншу. Понад ліміт ви отримуєте HTTP 429 з міткою часу resetAt у тілі — немає мовчазного дроселювання, немає втрачених запитів. Кожен виклик start та complete вимірюється, тому ваша кількість місячних оцінювань точна для виставлення рахунків.

Команди, які розробляють оцінювання кар'єри на місці, зазвичай недооцінюють два витрати. (1) Перевірені пулі елементів та оцінювання — рамки RIASEC, Big Five та EQ є публічними, але перевірені пулі елементів та алгоритми направленого оцінювання ні; побудова та перевірка власної займає роки та десятки тисяч адміністрацій. (2) Обслуговування — інструменти дрейфують та пулі елементів потребують оновлення. API — це ярлик: ви викликаєте три кінцеві точки, ми тримаємо психометрику в актуальному стані. Він live на тарифі Scale ($199/mo), який включає місячний ліміт оцінювань. Ліміт рахує оцінювання: кожен призначений інструмент витрачає одну одиницю. Партнери з білою міткою, які перепродають наші оцінювання, можуть перейти на розподіл доходу.