Встраивайте валидированные оценки в свой продукт.

Он предоставляет механизм оценки JobCannon как программируемый сервис, который может вызывать ваш продукт. Ваши пользователи проходят валидированную оценку — RIASEC, Big Five, EQ, Skills Audit или любой из 133+ инструментов — внутри вашего приложения, и вы получите оцененный результат. Полный цикл состоит из трех вызовов 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 — это ярлык: вы вызываете три эндпоинта, мы поддерживаем психометрику в актуальном состоянии. Это доступно на тарифе Scale ($199/mo), который включает ежемесячный лимит оценок, затем $2 за оценку сверх лимита. Партнеры с белой меткой, которые перепродают наши оценки, могут перейти на разделение дохода.