Trimoji Soft Skills API

Tämä API mahdollistaa Trimoji-persoonallisuudenarviointikyvykkyyksien integroimisen suoraan rekrytointialustaasi tai työnkulkuusi.

Trimoji on persoonallisuuden analysointiratkaisu rekrytoijille. Sen avulla voidaan lähettää kyselyitä ehdokkaille, jotka sitten tuottavat tuloksia (PDF ja verkko). Keskeinen ominaisuus on "Personi", joka edustaa ihanneprofiilia tehtävään. Voit verrata ehdokasprofiilia Personiin saadaksesi 0–100 pistettä vastaavuudesta.

Autentikointi

Pääsyavaimet

Kaikki API-pyynnöt on todennettava partner_token-tunnuksella Authorization-otsakkeessa.

Useimmat pyynnöt vaativat myös customer_token-tunnuksen pyynnön rungossa, joka tunnistaa tietyn Trimoji-asiakastilin.

Muuttuja	Tyyppi	Kuvaus
`base_url`	Merkkijono	`https://integration.trimoji.fr/api/v1/softskills`
`partner_token`	Merkkijono	Ainutlaatuinen kumppanitunnuksesi.
`customer_token`	Merkkijono	Asiakkaasi Trimoji API-avain.

API Viite

Päätepisteet (Endpoints)

1. Kampanjoiden hakeminen

Noutaa asiakkaan luomien kampanjoiden (työpaikkailmoitusten) luettelon.

Metodi: POST /campaigns

Pyynnön runko (JSON):

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

2. Personi-kampanjan luominen

Luo uusi Personi (ihanneprofiili) linkitettynä uuteen kampanjaan.

Metodi: POST /create/campaign

Pääparametrit:

campaign_infos: Testien konfigurointi (lyhyt, pitkä, tulosten näyttö).
job_offer: Tehtävän tiedot (otsikko, ala, kuvaus, tehtävät).
custom_id: Sisäinen yksilöllinen tunnuksesi tälle tarjoukselle.

3. Personin luominen (Itsenäinen)

Luo ihanneprofiili ilman välitöntä yhdistämistä kampanjaan.

Metodi: POST /create/personi

4. Arvioinnin lähettäminen ehdokkaalle

Aloittaa arviointiprosessin. Luo yksilöllisen linkin ehdokkaalle.

Metodi: POST /init

Parametri	Kuvaus
`candidate_email`	Vaadittu. Ehdokkaan sähköpostiosoite.
`callback_url`	Webhook-URL tulosten automaattiseen vastaanottamiseen.
`is_trimoji_sending`	Jos `true`, Trimoji lähettää sähköpostin. Muuten hallitset linkin lähettämistä.

Webhook & Tulokset

Kun testi on valmis, Trimoji lähettää POST-pyynnön callback_url-osoitteeseen, joka sisältää:

score : Vastaavuuspisteet (0-100).
grade : failed, passed, tai excelled.
web_report : Linkki täydelliseen verkkoanalyysiin.
file_urls : Linkit PDF-tiedostoihin (Yhteenveto, Haastattelu, Perehdytys jne.).

5. Prosessin tulosten hakeminen

Noutaa arvioinnin yksityiskohdat sen ID:n perusteella, kun se on valmis.

Metodi: GET /profile/:process_id

6. Personien hakeminen

Listaa kaikki asiakkaan luomat ihanneprofiilit (Personit).

Metodi: POST /personis

7. Prosessin ja Personin yhdistäminen

Vertaa jo testin läpäissyttä ehdokasta tiettyyn tehtäväprofiiliin saadaksesi uuden pistemäärän.

Metodi: POST /matching

{
  "process_id": "EHDOKASTESTIN_ID",
  "personi_id": "IHANNENPROFIILIN_ID"
}

Trimoji Softskills API -dokumentaatio - Päivitetty 2026