Bahasa IndonesiaIntegrasiRingkasan

Ringkasan

PsikologieHub menyediakan RESTful API yang memungkinkan sistem partner membuat session SSO widget untuk HR/rekruiter dan kandidat-kandidatnya. Setelah session berhasil dibuat, frontend partner meng-embed widgetUrl yang dikembalikan ke dalam <iframe>, dan widget menangani autentikasi, rendering dashboard, dan alur assessment secara internal.

Halaman ini berisi gambaran umum sistem, spesifikasi teknis, dan alur integrasi end-to-end.

Integrasi Sekilas

ItemNilai
AutentikasiHMAC-SHA256 signature di request body
EndpointPOST /api/v2/partner/{partnerId}/sessions
Content-Typeapplication/json
Output utamawidgetUrl (di-embed via iframe)
ProtokolHTTPS (wajib)

Spesifikasi Teknis

ParameterNilai
API TypeRESTful API
Base URL{BASE_URL}/api/v2/partner
Endpoint UtamaPOST /{partnerId}/sessions
AutentikasiHMAC-SHA256 Signature di request body
Content-Typeapplication/json
VersioningKontrak API Partner v2
ProtokolHTTPS (wajib)

Alur Integrasi End-to-End

Diagram alur integrasi

  1. HR/rekruiter login di sistem internal partner.
  2. Backend partner menyiapkan data: user, company, candidates.
  3. Backend partner membuat signature HMAC-SHA256 dari canonical string menggunakan secretKey partner.
  4. Backend partner memanggil POST /partner/{partnerId}/sessions dengan signature di body.
  5. PsikologieHub memvalidasi partnerId, signature, struktur request, dan domain partner.
  6. Response berisi sessionToken, widgetUrl, dan expiresIn.
  7. Backend partner meneruskan widgetUrl ke frontend.
  8. Frontend meng-embed widget via <iframe> dengan widgetUrl sebagai source.
  9. HR/rekruiter otomatis masuk ke dashboard.
  10. Kandidat mengerjakan assessment yang sudah disiapkan di dalam widget.
  11. Saat session expired, partner memanggil Create Session lagi.
BerandaPrasyarat