तुमच्या प्रॉडक्टमध्ये प्रमाणित मूल्यांकने एम्बेड करा.

हे JobCannon चे मूल्यांकन इंजिन तुमचे प्रॉडक्ट कॉल करू शकेल अशी प्रोग्राम करता येणारी सेवा म्हणून उपलब्ध करून देते. तुमचे वापरकर्ते तुमच्याच अॅपमध्ये प्रमाणित मूल्यांकन — RIASEC, बिग फाइव्ह, 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 ची कोणतीही गुंतागुंत नाही आणि क्लायंट-सीक्रेटची देवाणघेवाणही नाही: एकच हेडर, स्कोपसह आणि रद्द करता येणारा. सेशन हे सुरू करण्याच्या कॉलमधून मिळणारे, कमी कालावधीसाठी वैध असलेले, स्वाक्षरी केलेले टोकन असते, त्यामुळे तुमच्या बाजूला सांभाळण्यासाठी सेशन टेबल नाही आणि पोलिंगचीही गरज नाही.

POST /api/v1/assessments — body { 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 — body { 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 करिअर मार्गदर्शक वर्णन (अभ्यासक्रमांच्या शिफारशी, २,५२१-करिअर मॅपिंग) हे वेगळे ग्राहक-स्तरावरील व्यासपीठ आहे आणि ते प्रत्येक भागीदारासाठी स्वतंत्रपणे निश्चित केले जाते, v1 चा डीफॉल्ट प्रतिसाद नाही.

विनंत्यांवर प्रत्येक API कीनुसार रेट लिमिट लावले जाते (कीची ओळख, कॉल करणाऱ्याचा IP नाही), त्यामुळे जास्त भार टाकणारे एखादे इंटिग्रेशन दुसऱ्या इंटिग्रेशनची क्षमता कधीही संपवत नाही. मर्यादा ओलांडल्यास तुम्हाला बॉडीमध्ये resetAt टाइमस्टॅम्पसह HTTP 429 मिळतो — शांतपणे वेग कमी केला जात नाही आणि कोणतीही विनंती वगळली जात नाही. प्रत्येक सुरू करण्याचा आणि पूर्ण करण्याचा कॉल मोजला जातो, जेणेकरून बिलिंगसाठी तुमची मासिक मूल्यांकन संख्या अचूक राहते.

करिअर मूल्यांकन स्वतःच्या टीममध्ये तयार करणाऱ्या टीम सहसा दोन खर्चांचा कमी अंदाज लावतात. (1) प्रमाणित प्रश्नसंच आणि स्कोअरिंग — स्वतःचे तयार करून ते प्रमाणित करण्यासाठी अनेक वर्षे आणि हजारो वेळा चाचणी घ्यावी लागते. (2) देखभाल — चाचण्या कालबाह्य होत जातात आणि प्रश्नसंच नव्याने अद्ययावत करावे लागतात. API हा शॉर्टकट आहे: तुम्ही तीन एंडपॉइंट कॉल करता, सायकोमेट्रिक्स अद्ययावत ठेवण्याचे काम आम्ही करतो. हे Scale स्तरावर ($199/mo) उपलब्ध आहे, ज्यामध्ये दरमहा ठराविक संख्येने मूल्यांकनांचा कोटा समाविष्ट आहे. मर्यादा मूल्यांकनांची मोजली जाते: तुम्ही नेमून दिलेली प्रत्येक चाचणी एक युनिट खर्च करते. आमची मूल्यांकने पुन्हा विकणारे व्हाइट-लेबल भागीदार त्याऐवजी रेव्हेन्यू-शेअरवर जाऊ शकतात.