Webhooks

Webhooks mahdollistavat Trimojin reaaliaikaisten ilmoitusten lähettämisen sovellukseesi heti tapahtuman sattuessa (testin päättyminen, kampanjan luominen jne.). Tämä on tehokkain tapa synkronoida tietosi ilman turhaa API-pyyntöjen kuormitusta.

Toimintatapa: Tapahtuman sattuessa Trimoji tekee HTTP POST -pyynnön määrittelemääsi URL-osoitteeseen ja liittää mukaan vastaavat tiedot.

Webhookin konfigurointi

Webhookien hallinta tapahtuu asiakasliittymässäsi: Oma Trimoji-tili.

Konfigurointivaiheet:

• Syötä palvelimesi kohde-URL (esim. https://oma-sivusto.com/api/webhook).
• Valitse kuunneltavat tapahtumat.
• Vahvista lisäys.
• Tärkeää: Kun webhook on luotu, Trimoji luo automaattisesti yksilöllisen Salaisuuden (Token). Sinun on noudettava tämä token päätepisteesi suojaamiseksi.

Turvallisuus ja todennus

Jokaista lähetystä varten Trimoji käyttää luotua salaisuutta pyynnön allekirjoittamiseen ja todentamiseen. Sinun on varmistettava tämä tieto palvelinpuolella varmistaaksesi, että kutsu tulee palveluistamme.

Token välitetään kahdella tavalla jokaisessa pyynnössä:

• HTTP-otsakkeessa: Authorization: SINUN_LUOTU_TOKEN
• JSON-rungossa: { "_token": "SINUN_LUOTU_TOKEN", ... }

Hyötykuorman (Payload) rakenne

Kaikki Trimojin lähettämät pyynnöt noudattavat standardoitua JSON-muotoa, joka mahdollistaa toiminnon nopean tunnistamisen.

{
  "_token": "trimojin_luoma_token",
  "_timestamp": "2026-02-11T16:00:00.000Z",
  "_event": "QUIZZ_COMPLETED",

  // Dynaamiset tiedot tapahtuman mukaan
  "id": 12345,
  "data": { ... }
}

Saatavilla olevien tapahtumien luettelo

Voit tilata erilaisia toimintoja automaatiotarpeidesi mukaan:

Tekniset tiedot

• User-Agent: Pyynnöt lähetetään tunnisteella trimoji/1.0.0.
• Odotettu vastaus: Palvelimesi on palautettava koodi 200 OK. Jos sivullasi tapahtuu virhe, Trimoji kirjaa epäonnistumisen tilisi lokiin.
• Muoto: Pyynnön runko on aina JSON-muodossa.