Sisipaké asesmen sing wis divalidasi ing produk panjenengan.

API punika nyedhiyakaké mesin asesmen JobCannon minangka layanan sing bisa diprogram lan bisa dipanggil dening produk panjenengan. Panganggo panjenengan ngisi asesmen sing wis divalidasi — RIASEC, Big Five, EQ, Audit Kaprigelan, utawa salah siji saka 201+ instrumen — ing aplikasi panjenengan dhewé, lan panjenengan olèh asil sing wis ana skoré. Alur lengkapé dumadi saka telung panggilan REST: POST /api/v1/assessments miwiti sesi lan mbalèkaké set pitakon; GET /api/v1/assessments/{session_id}/questions njupuk maneh pitakon-pitakon kasebut yèn panjenengan mbutuhaké maneh; POST /api/v1/assessments/{session_id}/complete ngirim wangsulan, ngetung skor ing sisih server, lan mbalèkaké asil. Alur kode panghitungan skor sing padha karo sing dienggo produk konsumen (lib/scoring/compute.ts) mlaku ing mburi API, mula asil API padha persis karo asil sing dijupuk ing jobcannon.io.

Saben panyuwunan nggawa header X-API-Key. Kunci panjenengan katon kaya jck_live_… lan diterbitaké kanggo saben organisasi kanthi scope — assessments:send ngidinaké panjenengan miwiti lan ngrampungaké sesi, assessments:read ngidinaké panjenengan njupuk pitakon manèh. Kunci di-hash nganggo SHA-256 nalika disimpen lan ora tau disimpen minangka plaintext. Ora ana prosès OAuth sing ruwet lan ora ana pertukaran client-secret: siji header, nganggo scope, bisa dicabut. Sesi yaiku token sing wis ditandatangani lan umuré cendhak, sing diasilaké déning panggilan miwiti, mula panjenengan ora perlu ngurus tabel sesi lan ora ana polling.

POST /api/v1/assessments — body { test, locale?, external_user_id?, pool? }; ngasilaké { session_id, test, locale, question_pool, total_questions, questions[] }. GET /api/v1/assessments/{session_id}/questions — nyuguhaké manèh payload pitakon kanggo sesi sing isih mlaku (scope assessments:read). POST /api/v1/assessments/{session_id}/complete — body { answers: number[], external_user_id? } ing ngendi answers yaiku indeks pilihan miturut urutan pitakon nalika disuguhaké; ngasilaké { result_id, test, top_result, scores, question_pool }. Wangsulan divalidasi dawané lan vektor degeneratif/durung disentuh sadurungé diskor. Instrumen sing nganggo pool (contone paket tes IQ) nerusaké pool pitakon sing wis disuguhaké menyang kunci skoring sing trep.

Saben asesmen sing wis rampung disimpen ing organisasi panjenengan — baris asil ditulis nganggo api_org_id panjenengan, mula kacathet dadi duwèké panjenengan, dudu duwèké sesi browser anonim utawa akun konsumen JobCannon. Panggilan complete ngasilaké result_id, top_result (arketipe/tipe/kode utama kanggo instrumen kasebut), lan skor lengkap saben dimènsi. Panjenengan nyimpen result_id lan nampilaké asil ing produk panjenengan sakarepé panjenengan. v1 saiki ngasilaké asil sing wis diskor; narasi AI Career Guide sing luwih sugih (rekomendasi kursus, pemetaan 2.521 karir) minangka layanan konsumen sing kapisah lan diatur kanggo saben mitra, dudu respons v1 standar.

Panyuwunan dibatesi laju kanggo saben kunci API (identitas kunci, dudu IP panelpon), mula siji integrasi sing rame ora bakal nyuda jatah integrasi liyané. Yèn ngluwihi wates, panjenengan bakal nampa HTTP 429 kanthi timestamp resetAt ing body — ora ana pambatesan sing meneng-menengan, ora ana panyuwunan sing ilang. Saben panggilan miwiti lan ngrampungaké dicacah supaya cacahé asesmen saben sasi akurat kanggo tagihan.

Tim sing nggawé asesmen karir dhéwé biasané nyepelèkaké rong biaya. (1) Bank soal lan skoring sing wis divalidasi — nggawé lan ngevalidasi dhéwé mbutuhaké pirang-pirang taun lan tes sing kudu diwènèhaké puluhan èwu kaping. (2) Pangopènan — instrumen bisa mlenceng lan bank soal perlu dianyari. API minangka dalan cendhak: panjenengan nelpon telung endpoint, kita njaga psikometrik tetep anyar. Wis aktif ing tingkat Scale ($199/mo), sing nyakup jatah asesmen saben sasi. Watesé ngitung asesmen: saben instrumen sing panjenengan tugasaké nganggo siji unit. Mitra white-label sing ngedol manèh asesmen kita bisa pindhah menyang skema bagi hasil gantiné.