Apa itu PsikologieHub?

PsikologieHub adalah platform penilaian psikologi dan karir digital yang dapat diintegrasikan partner ke dalam alur kerja HR/rekrutmen. Platform ini menyediakan assessment CareerMatch (RIASEC & DISC) sebagai widget yang dapat di-embed, sehingga tim HR/rekruiter bisa mengelola kandidat dan melihat hasil assessment tanpa keluar dari aplikasi Anda.

Dokumentasi ini memandu tim developer partner untuk mengintegrasikan widget session PsikologieHub ke dalam sistem mereka. Integrasi dibangun di sekitar satu endpoint inti yang membuat session SSO dan mengembalikan widgetUrl yang siap di-embed ke dalam <iframe>.

Kemampuan Utama

• SSO berbasis session: HR/rekruiter dan kandidat otomatis ter-autentikasi saat mengakses widget. Tidak perlu login manual tambahan.
• Request dengan signature HMAC-SHA256: Partner membuat signature di backend menggunakan secretKey untuk mengautentikasi setiap pemanggilan Create Session.
• Widget siap iframe: Setelah session berhasil, frontend partner cukup meng-embed widgetUrl untuk merender dashboard assessment.
• Whitelist domain: URL widget bertoken hanya bisa diakses dari domain partner yang sudah terdaftar di PsikologieHub.

Memulai

Tiga langkah menuju integrasi yang berjalan:

Bagian Dokumentasi

• Ringkasan — Gambaran umum sistem, spesifikasi teknis, dan alur integrasi end-to-end.
• Prasyarat — Apa yang perlu disiapkan sistem dan tim Anda sebelum integrasi.
• Memulai Cepat — Tiga langkah cepat untuk membuat session dan widget tampil.
• Referensi API — Kontrak lengkap endpoint POST /sessions dengan implementasi multi-bahasa.
• Autentikasi — Aturan signing HMAC-SHA256, format canonical string, dan test vectors.
• Penanganan Error — Status code, strategi retry, circuit breaker, panduan debug.
• Panduan Pengujian — Checklist sebelum go-live ke production.

Butuh Bantuan?