API Kompetencji Miękkich Trimoji

To API umożliwia integrację funkcji oceny osobowości Trimoji bezpośrednio z Twoją platformą rekrutacyjną lub procesem pracy.

Trimoji to rozwiązanie do analizy osobowości dla rekruterów. Umożliwia wysyłanie kwestionariuszy do kandydatów, które generują wyniki (PDF i web). Kluczową funkcją jest "Personi", czyli idealny profil dla danego stanowiska. Możesz porównać profil kandydata z Personi, aby uzyskać wynik dopasowania od 0 do 100.

Uwierzytelnianie

Klucze Dostępu

Wszystkie zapytania API muszą być uwierzytelnione za pomocą partner_token w nagłówku Authorization.

Większość zapytań wymaga również customer_token w treści zapytania, identyfikującego konkretne konto klienta Trimoji.

Zmienna	Typ	Opis
`base_url`	Ciąg znaków	`https://integration.trimoji.fr/api/v1/softskills`
`partner_token`	Ciąg znaków	Twój unikalny token partnerski.
`customer_token`	Ciąg znaków	Klucz API Trimoji Twojego klienta.

Referencje API

Punkty Końcowe (Endpoints)

1. Pobierz Kampanie

Pobiera listę kampanii (ofert pracy) stworzonych przez klienta.

Metoda: POST /campaigns

Treść zapytania (JSON):

{
  "customer_token": "{{customer_token}}",
  "query": "test" (opcjonalnie)
}

2. Utwórz Kampanię Personi

Tworzy nowy Personi (profil idealny) powiązany z nową kampanią.

Metoda: POST /create/campaign

Główne parametry:

campaign_infos: Konfiguracja testów (krótki, długi, wyświetlanie wyników).
job_offer: Szczegóły stanowiska (tytuł, sektor, opis, misje).
custom_id: Twój wewnętrzny unikalny identyfikator oferty.

3. Utwórz Personi (Samodzielnie)

Tworzy idealny profil bez bezpośredniego powiązania z bieżącą kampanią.

Metoda: POST /create/personi

4. Wyślij ocenę do kandydata

Inicjuje proces oceny. Generuje unikalny link dla kandydata.

Metoda: POST /init

Parametr	Opis
`candidate_email`	Wymagane. Email kandydata.
`callback_url`	Adres URL Webhook do automatycznego odbierania wyników.
`is_trimoji_sending`	Jeśli `true`, Trimoji wysyła e-mail. W przeciwnym razie zarządzasz wysyłką linku.

Webhook i Wyniki

Po zakończeniu testu Trimoji wysyła żądanie POST na adres callback_url zawierające:

score: Wynik dopasowania (0-100).
grade: failed, passed lub excelled.
web_report: Link do pełnej analizy webowej.
file_urls: Linki do plików PDF (Synteza, Rozmowa kwalifikacyjna, Onboarding itp.).

5. Pobierz wyniki procesu

Pobiera szczegóły zakończonej oceny za pomocą jej identyfikatora.

Metoda: GET /profile/:process_id

6. Pobierz Personi

Wyświetla listę wszystkich profili idealnych (Personi) stworzonych przez klienta.

Metoda: POST /personis

7. Dopasuj proces do Personi

Porównuje kandydata, który już przeszedł test, ze specyficznym profilem stanowiska, aby uzyskać nowy wynik.

Metoda: POST /matching

{
  "process_id": "ID_TESTU_KANDYDATA",
  "personi_id": "ID_PROFILU_IDEALNEGO"
}

Dokumentacja API Trimoji Softskills - Aktualizacja 2026