ارزیابی‌های معتبر را در محصول خود جاسازی کنید.

موتور ارزیابی JobCannon را به‌عنوان یک سرویس برنامه‌پذیر که محصول شما می‌تواند فراخوانی کند، در اختیار می‌گذارد. کاربران شما یک ارزیابی معتبر — RIASEC، Big Five، EQ، ممیزی مهارت‌ها، یا هر یک از 201+ ابزار — را درون اپلیکیشن خودتان انجام می‌دهند و شما یک نتیجه امتیازدهی‌شده دریافت می‌کنید. چرخه کامل سه فراخوانی 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 و هیچ تبادل راز کلاینت وجود ندارد: یک هدر، دامنه‌دار، قابل ابطال. نشست یک توکن امضاشده کوتاه‌مدت است که توسط فراخوانی شروع برگردانده می‌شود، بنابراین هیچ جدول نشستی برای مدیریت در سمت شما وجود ندارد و نیازی به polling نیست.

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? } که answers شاخص‌های گزینه‌ها به ترتیب ارائه سؤالات هستند؛ برمی‌گرداند { result_id, test, top_result, scores, question_pool }. پاسخ‌ها از نظر طول و بردارهای نامعتبر/دست‌نخورده قبل از امتیازدهی اعتبارسنجی می‌شوند. ابزارهای تجمیعی (مثل باتری IQ) مجموعه سؤالات ارائه‌شده را به کلید امتیازدهی صحیح هدایت می‌کنند.

هر ارزیابی تکمیل‌شده به سازمان شما ذخیره می‌شود — ردیف نتیجه با api_org_id شما نوشته می‌شود، بنابراین به شما منتسب است، نه به یک نشست مرورگر ناشناس یا حساب مصرف‌کننده JobCannon. فراخوانی تکمیل result_id، top_result (نوع/کد اصلی برای آن ابزار) و تمام امتیازات هر بُعد را برمی‌گرداند. شما result_id را ذخیره کرده و نتیجه را درون محصول خود به هر شکلی که می‌خواهید نمایش می‌دهید. نسخه v1 فعلی نتیجه امتیازدهی‌شده را برمی‌گرداند؛ روایت غنی‌تر AI Career Guide (توصیه‌های دوره، نقشه‌برداری ۲٬۵۲۱ شغل) یک سطح مصرف‌کننده جداگانه است و برای هر شریک محدود شده، نه یک پاسخ پیش‌فرض v1.

درخواست‌ها به ازای هر کلید API محدود می‌شوند (هویت کلید، نه IP فراخوان‌کننده)، بنابراین یک یکپارچه‌سازی پرترافیک هرگز دیگری را محروم نمی‌کند. فراتر از حد مجاز، HTTP 429 با timestamp resetAt در بدنه دریافت می‌کنید — بدون throttling خاموش، بدون درخواست‌های رهاشده. هر فراخوانی شروع و تکمیل شمارش می‌شود تا تعداد ارزیابی ماهانه شما برای صورت‌حساب دقیق باشد.

تیم‌هایی که ارزیابی شغلی را به‌صورت داخلی می‌سازند معمولاً دو هزینه را دست‌کم می‌گیرند. (۱) بانک‌های آیتم معتبر و امتیازدهی — ساخت و اعتبارسنجی خودتان سال‌ها و ده‌ها هزار اجرا می‌برد. (۲) نگهداری — ابزارها کهنه می‌شوند و بانک‌های آیتم نیاز به به‌روزرسانی دارند. API میان‌بر است: شما سه endpoint را فراخوانی می‌کنید، ما روان‌سنجی را به‌روز نگه می‌داریم. در سطح Scale ($199/mo) فعال است که شامل سهمیه ماهانه ارزیابی می‌شود. سقف بر اساس ارزیابی شمارش می‌شود: هر ابزاری که اختصاص می‌دهید یک واحد مصرف می‌کند. شرکای برچسب‌سفید که ارزیابی‌های ما را بازفروش می‌کنند می‌توانند به مدل تقسیم درآمد منتقل شوند.