What is PsikologieHub?

PsikologieHub is a digital psychological and career assessment platform that partners can integrate into their HR/recruitment workflow. The platform provides the CareerMatch (RIASEC & DISC) assessment as an embeddable widget, so your HR/recruiter team can manage candidates and review assessment results without leaving your application.

This documentation guides partner developers through integrating the PsikologieHub session widget into their system. The integration is built around one core endpoint that creates an SSO session and returns a widgetUrl ready to embed in an <iframe>.

Core Capabilities

• Session-based SSO: HR/recruiters and candidates are automatically authenticated when accessing the widget. No additional manual login required.
• HMAC-SHA256 signed requests: Partners generate a signature on their backend using their secretKey to authenticate every Create Session call.
• Iframe-ready widget: After a successful session, the partner frontend simply embeds the returned widgetUrl to render the assessment dashboard.
• Domain whitelisting: Tokenized widget URLs are only accessible from partner domains registered with PsikologieHub.

Getting Started

Three steps to a working integration:

Documentation Sections

• Overview — System overview, technical specification, and the end-to-end integration flow.
• Prerequisites — What your system and team need to have ready before integrating.
• Quick Start — Three-step recipe to get a session created and the widget rendering.
• API Reference — Full POST /sessions endpoint contract with multi-language implementations.
• Authentication — HMAC-SHA256 signing rules, canonical string format, test vectors.
• Error Handling — Status codes, retry strategy, circuit breaker, debug guide.
• Testing Guide — Checklist before going to production.

Need Help?