Faka izinhlolo eziqinisekisiwe emkhiqizweni wakho.

Yenza injini yokuhlola ye-JobCannon ibe yinsiza elawulwa ngekhodi, engabizwa ngumkhiqizo wakho. Abasebenzisi bakho benza uhlolo oluqinisekisiwe — i-RIASEC, i-Big Five, i-EQ, ukuhlola amakhono, noma yiluphi kwezinhlolo ezingu-201+ — ngaphakathi kohlelo lwakho lokusebenza, bese wena uthola umphumela onamaphuzu abaliwe. Umjikelezo ophelele uyizicelo ezintathu ze-REST: i-POST /api/v1/assessments iqala iseshini futhi ibuyisa iqoqo lemibuzo; i-GET /api/v1/assessments/{session_id}/questions iphinde ilande leyo mibuzo uma uyidinga futhi; i-POST /api/v1/assessments/{session_id}/complete ithumela izimpendulo, ibala amaphuzu azo ohlangothini lweseva, bese ibuyisa umphumela. Ikhodi efanayo yokubala amaphuzu esetshenziswa ngumkhiqizo wabasebenzisi ngabanye (lib/scoring/compute.ts) yiyona esebenza ngemuva kwe-API, ngakho umphumela we-API ufana ncamashi nowohlolo olwenziwe ku-jobcannon.io.

Isicelo ngasinye siphethe i-header ethi X-API-Key. Ukhiye wakho ubukeka kanje: jck_live_…, futhi ukhishelwa inhlangano ngayinye unezimvume — i-assessments:send ikuvumela ukuthi uqale futhi uphothule amaseshini, i-assessments:read ikuvumela ukuthi uphinde ulande imibuzo. Okhiye bagcinwa behashiwe nge-SHA-256 futhi abagcinwa neze njengombhalo ongafihliwe. Ayikho inqubo ende ye-OAuth futhi akukho kushintshisana kwekhodi eyimfihlo yeklayenti: i-header eyodwa, enezimvume, engahoxiswa. Iseshini iyithokheni esayiniwe ephila isikhathi esifushane, ebuyiswa yisicelo sokuqala, ngakho awudingi ukuphatha ithebula lamaseshini ohlangothini lwakho futhi awudingi ukuhlala ubuza iseva.

POST /api/v1/assessments — okuqukethwe yisicelo { test, locale?, external_user_id?, pool? }; ibuyisa { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — iphinda iletha imibuzo yeseshini esaqhubeka (imvume: assessments:read). POST /api/v1/assessments/{session_id}/complete — okuqukethwe yisicelo { answers: number[], external_user_id? }, lapho izimpendulo ziyizinombolo zezinketho ngokulandelana kwemibuzo njengoba yethulwa; ibuyisa { result_id, test, top_result, scores, question_pool }. Ngaphambi kokubala amaphuzu, izimpendulo ziyahlolwa: ubude bazo, nokuthi azilona uhlu olungenamqondo noma olungathintwanga. Izinhlolo ezisebenzisa amaqoqo emibuzo (isb. uchungechunge lwezinhlolo ze-IQ) zidlulisela iqoqo lemibuzo elethulwe kukhiye ofanele wokubala amaphuzu.

Uhlolo ngalunye oluphothuliwe lugcinwa enhlanganweni yakho — umugqa womphumela ubhalwa ne-api_org_id yakho, ngakho umphumela ubhalwa egameni lakho, hhayi kuseshini yesiphequluli engaziwa noma ku-akhawunti ye-JobCannon yomuntu ngamunye. Isicelo sokuphothula sibuyisa i-result_id, i-top_result (okuyinhloko kulolu hlolo — isigaba, uhlobo noma ikhodi), kanye namaphuzu aphelele esici ngasinye. Wena ugcina i-result_id bese ubonisa umphumela ngaphakathi komkhiqizo wakho ngendlela othanda ngayo. Inguqulo yamanje, i-v1, ibuyisa umphumela onamaphuzu abaliwe; incazelo enemininingwane eminingi ye-AI Career Guide (izincomo zezifundo, ukuxhumanisa nemisebenzi engu-2,521) iyingxenye ehlukile yomkhiqizo wabasebenzisi ngabanye futhi inqunywa ngokwesivumelwano nomlingani ngamunye; ayiyona impendulo ejwayelekile ye-v1.

Izicelo zinomkhawulo ngokhiye we-API ngamunye (kubhekwa ukhiye uqobo, hhayi ikheli le-IP lothumela isicelo), ngakho ukuxhumanisa okukodwa okuthumela izicelo eziningi akusoze kwavimba okunye. Uma weqa umkhawulo, uthola i-HTTP 429 enesikhathi esithi resetAt emzimbeni wempendulo — akukho kwehliswa kwesivinini ngasese, azikho izicelo ezilahlwayo. Isicelo ngasinye sokuqala nesokuphothula siyabalwa, ngakho inani lakho lokuhlola lenyanga linembile ekukhokhisweni.

Amathimba azakhela ukuhlola kwemisebenzi ngokwawo ngokuvamile abukela phansi izindleko ezimbili. (1) Amaqoqo emibuzo aqinisekisiwe nokubala amaphuzu — ukuzakhela okwakho nokukuqinisekisa kuthatha iminyaka nokuhlolwa kwabantu abangamashumi ezinkulungwane. (2) Ukunakekela — izinhlolo ziyaguquka ngokuhamba kwesikhathi futhi amaqoqo emibuzo adinga ukuvuselelwa. I-API iyindlela emfushane: wena uthumela izicelo kuma-endpoint amathathu, thina sigcina ukuhlola kwengqondo kuhambisana nesikhathi. Isebenza bukhoma ezingeni elithi Ukwanda ($199/mo), elifaka inani lokuhlola ngenyanga. Umkhawulo ubala ukuhlola: uhlolo ngalunye olwabelwa umuntu lusebenzisa iyunithi eyodwa. Abalingani be-white-label abathengisa kabusha izinhlolo zethu bangashintshela ekwabelaneni ngemali engenayo esikhundleni salokho.