Fi àwọn ìdánwò tí a ti fìdí wọn múlẹ̀ sínú ọjà rẹ.

Ó ń ṣí ẹ̀rọ ìdánwò JobCannon sílẹ̀ gẹ́gẹ́ bí iṣẹ́ tí ọjà rẹ lè pè pẹ̀lú kóòdù. Àwọn olùlò rẹ ń ṣe ìdánwò tí a ti fìdí rẹ̀ múlẹ̀ — RIASEC, Big Five, EQ, Skills Audit, tàbí èyíkéyìí nínú ohun-èlò ìdánwò 205+ — nínú app tìrẹ, ìwọ sì ń gba àbájáde tí a ti ṣírò máàkì rẹ̀ padà. Gbogbo ìyíká náà jẹ́ ìpè REST mẹ́ta: POST /api/v1/assessments ń bẹ̀rẹ̀ ìgbà ìdánwò kan, ó sì ń dá àkójọ ìbéèrè padà; GET /api/v1/assessments/{session_id}/questions ń tún àwọn ìbéèrè náà mú wá bí o bá tún nílò wọn; POST /api/v1/assessments/{session_id}/complete ń fi àwọn ìdáhùn ránṣẹ́, ó ń ṣírò máàkì wọn lórí olupin, ó sì ń dá àbájáde padà. Ọ̀nà kóòdù ìṣirò kan náà tí ọjà fún àwọn olùlò àdáni ń lò (lib/scoring/compute.ts) ló ń ṣiṣẹ́ lẹ́yìn API náà, nítorí náà àbájáde API jẹ́ bákan náà pẹ̀lú èyí tí a ṣe lórí jobcannon.io.

Gbogbo ìbéèrè ló ní hédà X-API-Key. Kọ́kọ́rọ́ rẹ dà bí jck_live_…, a sì ń fi í fún àjọ kọ̀ọ̀kan pẹ̀lú ààlà-àṣẹ — assessments:send jẹ́ kí o bẹ̀rẹ̀ àti parí àwọn ìgbà ìdánwò, assessments:read jẹ́ kí o tún àwọn ìbéèrè mú wá. A ń fi SHA-256 yí àwọn kọ́kọ́rọ́ padà (hash) kí a tó pa wọ́n mọ́, a kì í sì pa wọ́n mọ́ ní ọ̀rọ̀ gbangba (plaintext) rárá. Kò sí ìlànà OAuth gígùn, kò sì sí pàṣípààrọ̀ client secret: hédà kan, pẹ̀lú ààlà-àṣẹ, tí a lè fagilé. Ìgbà ìdánwò jẹ́ tókìn tí a fọwọ́ sí, tí ó wà fún àkókò kúkúrú, tí ìpè ìbẹ̀rẹ̀ ń dá padà, nítorí náà kò sí tábìlì ìgbà ìdánwò tí o ní láti ṣàkóso ní ẹ̀gbẹ́ rẹ, kò sì sí ìbéèrè-àtúnbéèrè (polling).

POST /api/v1/assessments — body { test, locale?, external_user_id?, pool? }; ó ń dá { session_id, test, locale, question_pool, total_questions, questions[] } padà. GET /api/v1/assessments/{session_id}/questions — ó ń tún àwọn ìbéèrè pèsè fún ìgbà ìdánwò tí ó ń lọ lọ́wọ́ (ààlà-àṣẹ assessments:read). POST /api/v1/assessments/{session_id}/complete — body { answers: number[], external_user_id? }, níbi tí àwọn ìdáhùn jẹ́ atọ́ka (index) àṣàyàn ní ìtẹ̀léra tí a gbà pèsè àwọn ìbéèrè; ó ń dá { result_id, test, top_result, scores, question_pool } padà. Kí a tó ṣírò máàkì, a ń ṣàyẹ̀wò gígùn àwọn ìdáhùn àti bóyá wọ́n jẹ́ àkójọ asán tàbí èyí tí a kò fọwọ́ kàn. Fún àwọn ohun-èlò tí ó ní àkójọ ìbéèrè púpọ̀ (bí àpẹẹrẹ, àkójọ ìdánwò IQ), a ń gbé àkójọ ìbéèrè tí a pèsè dé kọ́kọ́rọ́ ìṣirò tí ó tọ́.

A ń pa gbogbo ìdánwò tí a parí mọ́ sínú àjọ rẹ — a ń kọ ìlà àbájáde náà pẹ̀lú api_org_id rẹ, nítorí náà a kà á sí tìrẹ, kì í ṣe ti ìgbà aṣàwákiri aláìlórúkọ tàbí ti àkọọ́lẹ̀ olùlò àdáni JobCannon. Ìpè ìparí ń dá result_id padà, top_result (irú-ìwà/irú/kóòdù pàtàkì jùlọ fún ohun-èlò ìdánwò náà), àti gbogbo máàkì fún ìwọ̀n kọ̀ọ̀kan. Ìwọ ni yóò pa result_id mọ́, tí yóò sì fi àbájáde hàn nínú ọjà rẹ bí o ṣe fẹ́. Ẹ̀dà v1 lọ́wọ́lọ́wọ́ ń dá àbájáde tí a ṣírò padà; àlàyé AI Career Guide tí ó jinlẹ̀ jù (àbá àwọn kọ́ọ̀sì, ìbámu pẹ̀lú iṣẹ́ 2,521) jẹ́ ojú-ìwé ọ̀tọ̀ fún àwọn olùlò àdáni, a sì ń ṣètò rẹ̀ fún alábàáṣiṣẹ́pọ̀ kọ̀ọ̀kan, kì í ṣe apá kan ìdáhùn v1 tí a ń dá padà déédé.

A ń díwọ̀n iye ìbéèrè fún kọ́kọ́rọ́ API kọ̀ọ̀kan (ìdánimọ̀ kọ́kọ́rọ́ náà, kì í ṣe IP ẹni tí ó ń pè), nítorí náà ìsopọ̀ kan tí ó ń pè jù kò lè dí òmíràn lọ́wọ́ láé. Bí o bá kọjá òdiwọ̀n, o máa gba HTTP 429 pẹ̀lú àkókò resetAt nínú body — kò sí ìdínkù ìyára ní ìkọ̀kọ̀, kò sí ìbéèrè tí ó sọnù. A ń ka gbogbo ìpè ìbẹ̀rẹ̀ àti ìparí, kí iye ìdánwò rẹ lóṣooṣù lè péye fún ìsanwó.

Àwọn ẹgbẹ́ tí ń kọ́ ìdánwò iṣẹ́ fúnra wọn nínú ilé sábà máa ń fojú kéré owó méjì. (1) Àkójọ ìbéèrè tí a ti fìdí wọn múlẹ̀ àti ìṣirò èsì — kíkọ́ tìrẹ àti fífi ìdí rẹ̀ múlẹ̀ máa ń gba ọ̀pọ̀ ọdún àti ọ̀pọ̀lọpọ̀ ẹgbàárùn-ún ìgbà tí a ṣe ìdánwò. (2) Ìtọ́jú — àwọn ohun-èlò ìdánwò máa ń yẹ̀ bí àkókò ti ń lọ, àkójọ ìbéèrè sì nílò àtúnṣe. API ni ọ̀nà ẹ̀bùrú: o ń pe endpoint mẹ́ta, àwa ń jẹ́ kí ìmọ̀ ìdíwọ̀n-ọkàn (psychometrics) wà ní ìbámu pẹ̀lú ìgbà. Ó wà lórí ètò Ìgbòòrò ($199/mo), tí ó ní iye ìdánwò tí a pín fúnni lóṣooṣù. Òdiwọ̀n náà ń ka àwọn ìdánwò: gbogbo ohun-èlò ìdánwò tí o bá yàn ń ná ẹyọ kan. Àwọn alábàáṣiṣẹ́pọ̀ tí ń tún àwọn ìdánwò wa tà lábẹ́ àmì-ọ̀tọ̀ tiwọn lè yí padà sí ètò pípín owó-wíwọlé dípò bẹ́ẹ̀.