Fi àwọn ìmẹ̀wẹ̀ tó dìde rẹ̀ sínú ọjà rẹ.

O ṣe ìmọ̀ṣẹ́ ìjẹ́ ìmẹ̀wẹ̀ JobCannon ati onígbìmọ̀ iṣirò gẹ́gẹ́ ìṣẹ́ alẹ́kòòkan tó ìpèjúwe rẹ lè pe. Àwọn oníwọ̀ rẹ ṣe ìmẹ̀wẹ̀ tó dìde rẹ̀ — RIASEC, Big Five, EQ, Skills Audit, tàbí èyíkéyìí nínú àwọn ohun ìṣẹ́ 195+ — nínú app rẹ, ati o ní àbùkọ tó wà nípa iṣirò padà. Ìṣírò tòó búburú jẹ́ okòko REST mẹ́ta: POST /api/v1/assessments bẹ̀rẹ̀ àkójọpọ̀ kán ati padà sẹ́tì ìbéèrè; GET /api/v1/assessments/{session_id}/questions mú àwọn ìbéèrè wọ́n padà tún bí o nílò wọ́n nìkan; POST /api/v1/assessments/{session_id}/complete lò àwọn ìdáhun, ṣe iṣirò wọn ní agbègbe ìfúnilẹ̀rẹ̀, ati padà àbùkọ. Ọ̀nà ètò iṣirò kanna tó ìpèjúwe olùnà lo (lib/scoring/compute.ts) ṣiṣẹ́ nígbẹ API, nítorí náà àbùkọ API jẹ́ ọ̀títọ́ pẹ̀lú eni tó gba lórí jobcannon.io.

Gbogbo ìbéèrè ní ará iṣẹ̀ X-API-Key. Ọ̀ọ́dụ rẹ dáàbò bí jck_live_… ati jẹ́ ìṣédé nínú àkójọpọ̀ kó alákàn — assessments:send jẹ́ ọ́ o ní lílo bẹ̀rẹ̀ ati kúmàl àwọn àkójọpọ̀, assessments:read jẹ́ ọ́ o ní mú àwọn ìbéèrè padà. Àwọn ọ̀ọ́dụ jẹ́ SHA-256 tó rílú ní òpin ati kìi dá sínú ọ̀rọ̀ báre. Ko sí ìrìn ẹ̀kó OAuth ati ko sí ìbabagé ìbáṣe ohun ìbáṣe: ará iṣẹ̀ kan, tí wà nínú iyinpín, tó lè bà jẹ́. Àkójọpọ̀ jẹ́ èdè ìtẹ̀múisẹ́ pẹ́kìpẹ̀ẹ́kì tó padà nípasẹ̀ okòko bẹ̀rẹ̀, nítorí náà ko sí tábìlì àkójọpọ̀ tó ń ṣe irántí lára rẹ ati ko sí ìtẹ̀múisẹ́.

POST /api/v1/assessments — ara { test, locale?, external_user_id?, pool? }; padà { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — pèsè ọ̀rọ̀ ìbéèrè fún àkójọpọ̀ tó ń ṣiṣẹ́ (ikakaki assessments:read). POST /api/v1/assessments/{session_id}/complete — ara { answers: number[], external_user_id? } níbi tí àwọn ìdáhun jẹ́ àwọn àmóhùn àbùnrẹ́ nínú ìforílé ti àwọn ìbéèrè; padà { result_id, test, top_result, scores, question_pool }. Àwọn ìdáhun jẹ́ tó dìde rẹ̀ fún ẹ́ gùn ati fún àwọn ìgbéjáde tí kò ní ìtúkọ̀ ṣaájú iṣirò. Àwọn ohun ìṣẹ́ tó pọ (àpẹ ìgun IQ) yé àwọn ìbéèrè tó pèsè kan sínú ọ̀nà iṣirò tó dúró.

Gbogbo ìmẹ̀wẹ̀ tó pé jẹ́ àwọn tí wà sínú àkójọpọ̀ rẹ — ìlọ́ àbùkọ ń kọ pẹ̀lú api_org_id rẹ, nítorí náà ó múnukufu sí ọ, kì í múnukufu sí àkójọpọ̀ ìwọ̀ ẹlégẹ́ẹ́ tàbí àkáǹtì olùnà JobCannon. Okòko tí ó pé padà result_id, top_result (àtòmò ìkékeré/iru/ètò fún ohun ìṣẹ́ yẹn), ati àwọn àmórán iṣirò tó ṣísẹ̀. O típa result_id ati lo àbùkọ sínú ìpèjúwe rẹ báwo tó fẹ́. V1 àlábí júmo àbùkọ tó wà nípa iṣirò; ìsọ̀rọ̀ Guide ò̀fìn AI tó dùn (àwọn ìtúmọ̀ ìlkọ̀ọ̀kan, 2,521-ì-mápù ò̀fìn) jẹ́ ìwájú olùnà ẹ̀yà tí wà nínú iyinpín ní-ẹ̀gba, kì í jẹ́ ìdáhun v1 àkúfà.

Àwọn ìbéèrè ní iṣakojú nísanra nípa API ọ̀ọ́dụ (ọ̀rọ̀ ìtánná ọ̀ọ́dụ, kì í IP ẹni tó ní ìbéèrè), nítorí náà àpapọ̀ olóhùn kan kìi jẹ́ kí ẹní míràn ní ìsálẹ̀. Kó tó òpin rẹ ó ní HTTP 429 pẹ̀lú àkókò resetAt nínú ara — ko sí iṣakojú tó kò ní ohùn, ko sí àwọn ìbéèrè tó ṣubú. Gbogbo okòko bẹ̀rẹ̀ ati okòko tí ó pé jẹ́ àwọn tó ní ìfúnni, nítorí náà àdánáà ìmẹ̀wẹ̀ oṣù rẹ jẹ́ nípa òóṣù.

Àwọn ẹgbẹ́ tó kó ìmẹ̀wẹ̀ ò̀fìn nínú ìlé jẹ́ àwọn tó wọ́n àdánáà, ọ̀kúnrin rẹ àti ara náà kódì. (1) Àwọn ile ìtárahun tó dìde rẹ̀ ati iṣirò — àwọn ìkù RIASEC, Big Five ati EQ jẹ́ àwọn tó ní ìkósílẹ̀, ṣùgbọ́n àwọn àpọ́ ìtárahun tó dìde rẹ̀ ati àwọn ònà iṣirò itọ̀ kì í jẹ́ pé; kíkó ati ìdídí rẹ ara rẹ gba àwọn ọdún ati ẹgbẹ̀ẹ̀ẹ̀ àwọn ìṣètò. (2) Ìtúkọ̀ — àwọn ohun ìṣẹ́ ní ìyípada ati àwọn ile ìtárahun nílò ìtúnáìtún. API jẹ́ ìgbéga: o pe okòko mẹ́ta, á ń pa àwọn ìtárahun ojúrere. Ó wà láti nínú onígbìmọ̀ Scale ($199/mo), tí o níìyà àwọn ìmẹ̀wẹ̀ oṣù. Òpin ṣe àpilẹ̀ àwọn ìmẹ̀wẹ̀: gbogbo ohun ìṣẹ́ tí o ní láàrin lo ẹ̀yà kan. Àwọn aláàbò alawonaala tó tún lo àwọn ìmẹ̀wẹ̀ wa máa lè gba sí pínn-orí-owó láàrin.