API Soft Skills Trimoji

Det här API:et låter dig integrera Trimojis personlighetsutvärderingskapacitet direkt i din rekryteringsplattform eller ditt arbetsflöde.

Trimoji är en lösning för personlighetsanalys för rekryterare. Den möjliggör utskick av frågeformulär till kandidater, som sedan genererar resultat (PDF och webb). En nyckelfunktion är "Personi", som representerar den ideala profilen för en tjänst. Du kan jämföra en kandidats profil med en Personi för att få en matchningspoäng från 0 till 100.

Autentisering

Åtkomstnycklar

Alla API-anrop måste autentiseras via en partner_token i Authorization-headern.

De flesta anrop kräver också en customer_token i anropets brödtext, som identifierar den specifika Trimoji-kundkontot.

Variabel	Typ	Beskrivning
`base_url`	Sträng	`https://integration.trimoji.fr/api/v1/softskills`
`partner_token`	Sträng	Din unika partner-token.
`customer_token`	Sträng	Din kunds Trimoji API-nyckel.

API Referens

Ändpunkter

1. Hämta kampanjer

Hämtar listan över kampanjer (jobbannonser) som skapats av kunden.

Metod: POST /campaigns

Anropsbrödtext (JSON):

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

2. Skapa en Personi-kampanj

Skapar en ny Personi (ideal profil) kopplad till en ny kampanj.

Metod: POST /create/campaign

Huvudparametrar:

campaign_infos: Konfiguration av tester (kort, lång, visning av resultat).
job_offer: Jobbdetaljer (titel, sektor, beskrivning, uppgifter).
custom_id: Din interna unika identifierare för detta erbjudande.

3. Skapa en Personi (fristående)

Skapar en ideal profil utan att direkt koppla den till en omedelbar kampanj.

Metod: POST /create/personi

4. Skicka utvärderingen till kandidaten

Initierar en utvärderingsprocess. Genererar en unik länk för kandidaten.

Metod: POST /init

Parameter	Beskrivning
`candidate_email`	Krävs. Kandidatens e-postadress.
`callback_url`	Webhook-URL för att automatiskt ta emot resultat.
`is_trimoji_sending`	Om `true`, skickar Trimoji e-postmeddelandet. Annars hanterar du utskicket av länken.

Webhook & Resultat

När testet är slutfört skickar Trimoji ett POST till callback_url med:

score : Matchningspoäng (0-100).
grade : failed, passed, eller excelled.
web_report : Länk till den fullständiga webbanalysen.
file_urls : Länkar till PDF-filer (Sammanfattning, Intervju, Onboarding, etc.).

5. Hämta resultat från en process

Hämtar detaljer för en slutförd utvärdering via dess ID.

Metod: GET /profile/:process_id

6. Hämta Personis

Listar alla ideala profiler (Personis) som skapats av kunden.

Metod: POST /personis

7. Matcha en process mot en Personi

Jämför en kandidat som redan har gjort testet med en specifik jobbprofil för att få en ny poäng.

Metod: POST /matching

{
  "process_id": "ID_FÖR_KANDIDATTESTET",
  "personi_id": "ID_FÖR_IDEALPROFILEN"
}

Dokumentation Trimoji Softskills API - Uppdaterad 2026

API Softskills