Naar de inhoud

Diese Seite gibt es auch auf Deutsch. Auf Deutsch ansehen

This page is also available in English. Switch to English

Esta página también está disponible en español. Ver en español

Cette page existe aussi en français. Voir en français

Getoond in de taal die je koos. Auf Deutsch ansehenSwitch to EnglishVer en españolVoir en français

tapja

Voor ontwikkelaars

Koppel tapja aan je kassa, webshop en CRM

REST-API en webhooks voor ontwikkelaars van kassa’s, webshops en CRM’s die een zaak met het abonnement Favoriete keten koppelen.

Naar de API-referentie OpenAPI

Overzicht

Via de koppeling praat het systeem van een zaak rechtstreeks met tapja. De kassa scant de barcode op de kaart, vindt zo de gast, stempelt en wisselt beloningen in. Via webhooks laat tapja het weten zodra er iets gebeurt.

Wat kan

  • Een kaart vinden via het serienummer uit de QR-code of barcode: GET /passes/by-serial/{serial}
  • De stand van een kaart en minimale gastgegevens lezen: GET /passes/{id}, GET /customers/{id}, GET /customers
  • Stempels of punten boeken: POST /passes/{id}/stamp
  • Beloningen en aanbiedingen inwisselen, kaarten annuleren: POST /passes/{id}/redeem, POST /passes/{id}/redeem-offer, POST /passes/{id}/cancel
  • Een aanmeldlink voor nieuwe gasten ophalen: POST /passes
  • Kaartprogramma’s, locaties, medewerkers en cijfers lezen: GET /cards, GET /locations, GET /employees, GET /analytics
  • Een kaartmelding sturen naar gasten met marketingtoestemming: POST /notifications/push
  • Verwijderde gasten afstemmen: GET /customers/deleted
  • Webhooks ontvangen voor 13 gebeurtenissen, zoals „Kaart uitgegeven”, „Stempel toegevoegd”, „Beloning klaar” en „Gast verwijderd”

Wat bewust niet kan

  • Kaarten uitgeven zonder toestemming van de gast. POST /passes geeft een aanmeldlink; de kaart maakt de gast zelf aan.
  • Gasten aanmaken zonder dat ze zich via die link aanmelden.
  • Gasten in bulk exporteren. Afzonderlijke gasten haal je op via hun kenmerk of de e-mailzoekopdracht.
  • Pakket- en lidmaatschapskaarten boeken. De koppeling weigert dat met PACKAGE_USE_REQUIRED of MEMBERSHIP_ACTION_REQUIRED.

Voorwaarden

De zaak heeft het abonnement Favoriete keten. De API-sleutel maakt de eigenaar van de zaak zelf aan. Een kant-en-klare koppeling met een bepaald kassasysteem is er niet; de koppeling via de API is de weg ernaartoe.

Snelstart in 5 stappen

1. Laat een API-sleutel aanmaken

De eigenaar maakt de sleutel op het web aan onder Beheer › Integraties, in de app onder Meer › Inrichting & beheer › Integraties. tapja vraagt daarbij nog eens om het wachtwoord, en alle eigenaren van de zaak krijgen een beveiligingsmail. De sleutel wordt precies één keer getoond.

  • Scopes: alleen de scopes die je systeem nodig heeft (zie Scopes). pass:read, pass:write en setup:read zijn vooraf aangevinkt. Zonder setup:read kent je systeem employeeId en locationId niet.
  • Locatiebinding (optioneel): de sleutel boekt dan alleen op deze locaties. De scopes customer:read, pass:cancel en notification:send zijn voor zulke sleutels niet mogelijk.
  • Hoogste actorrol („Mag handelen als” in de interface): tot deze rol mag je systeem medewerkers noemen. Standaard is dat „Medewerker”.

2. Basisadres

text
https://api.tapja.de/api/v1/public

3. Authenticeren

Elke aanvraag draagt de sleutel als Bearer-token. De sleutel hoort alleen op de server of in de kassa, nooit in de browser, in een app of in logs.

http
Authorization: Bearer sk_live_…

4. Eerste aanroep: kaart lezen

Lees de kaart via het serienummer uit de barcode.

bash
curl https://api.tapja.de/api/v1/public/passes/by-serial/SN8F3K2 \
  -H "Authorization: Bearer sk_live_…"
Vorm van het antwoord
{
  "data": {
    "id": "string",
    "cardId": "string",
    "customerId": "string",
    "serialNumber": "string",
    "stampCount": 0,
    "pointsBalance": 0,
    "tier": "string",
    "lastStampAt": "2026-11-07T10:00:00.000Z",
    "createdAt": "2026-11-07T10:00:00.000Z"
  },
  "timestamp": "2026-11-07T10:00:00.000Z"
}

5. Eerste boeking: stempelen

Een boeking noemt altijd een medewerker en een locatie. GET /employees en GET /locations geven hun kenmerken.

bash
curl https://api.tapja.de/api/v1/public/employees -H "Authorization: Bearer sk_live_…"
curl https://api.tapja.de/api/v1/public/locations -H "Authorization: Bearer sk_live_…"

De Idempotency-Key is per transactie nieuw, bijvoorbeeld het bonnummer. Het kenmerk van de kaart is het veld id uit stap 4.

bash
curl -X POST https://api.tapja.de/api/v1/public/passes/pass_123/stamp \
  -H "Authorization: Bearer sk_live_…" \
  -H "Idempotency-Key: kasse-3-bon-4711" \
  -H "Content-Type: application/json" \
  -d '{ "employeeId": "emp_42", "locationId": "loc_mitte", "employeeRef": "Kasse 3" }'
Vorm van het antwoord
{
  "data": {
    "id": "string",
    "cardId": "string",
    "customerId": "string",
    "serialNumber": "string",
    "stampCount": 0,
    "pointsBalance": 0,
    "tier": "string",
    "lastStampAt": "2026-11-07T10:00:00.000Z",
    "createdAt": "2026-11-07T10:00:00.000Z",
    "lifetimeProgress": 0,
    "stampCycle": 0
  },
  "timestamp": "2026-11-07T10:00:00.000Z"
}

Elke sleutel boekt echt. Lees vóór je eerste test Geen testmodus.

Basisregels

Antwoorden en fouten

Geslaagde antwoorden staan in { data, timestamp }, fouten in { error: { code, message } }.

json
{ "data": { "…": "…" }, "timestamp": "2026-11-07T10:00:00.000Z" }
json
{ "error": { "code": "COOLDOWN_ACTIVE", "message": "Bereits kürzlich gestempelt." } }

Vertak alleen op code, nooit op message. De tekst is voor mensen, meestal Duits, en kan veranderen. Onbekende velden in de request-body weigert de koppeling met 400.

Foutcodes (72)
CodeStatusEndpoints
AMOUNT_BELOW_MINIMUM400
POST /passes/{id}/stamp
AMOUNT_REQUIRED400
POST /passes/{id}/stamp
AMOUNT_TOO_SMALL400
POST /passes/{id}/stamp
BAD_REQUEST400
POST /passes
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
GET /customers
GET /customers/deleted
POST /notifications/push
CARD_HAS_NO_BALANCE400
POST /passes/{id}/stamp
COUPON_NOT_COMBINABLE400
POST /passes/{id}/redeem-offer
IDEMPOTENCY_KEY_INVALID400
POST /passes
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
POST /notifications/push
LOCATION_WRONG_COMPANY400
POST /passes
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
MEMBERSHIP_ACTION_REQUIRED400
POST /passes/{id}/stamp
POST /passes/{id}/redeem
OFFERS_NOT_ON_CARD400
POST /passes/{id}/redeem-offer
PACKAGE_USE_REQUIRED400
POST /passes/{id}/stamp
POST /passes/{id}/redeem
PLACEHOLDER_UNKNOWN400
POST /notifications/push
POINTS_BALANCE_LIMIT400
POST /passes/{id}/stamp
POINTS_REQUIRED400
POST /passes/{id}/stamp
QUIET_HOURS400
POST /notifications/push
REWARD_AUTO_ISSUED400
POST /passes/{id}/redeem
STAMP_CAP_EXCEEDED400
POST /passes/{id}/stamp
STAMP_MODE_AMOUNT400
POST /passes/{id}/stamp
STAMP_MODE_VISIT400
POST /passes/{id}/stamp
UNAUTHORIZED401alle endpoints
ACTOR_ROLE_NOT_ALLOWED403
POST /passes
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
CARD_FULL403
POST /passes/{id}/stamp
COMPANY_SUSPENDED403alle endpoints
COOLDOWN_ACTIVE403
POST /passes/{id}/stamp
EMPLOYEE_NOT_AT_LOCATION403
POST /passes
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
GUEST_EMAIL_UNVERIFIED403
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
LOCATION_NOT_ALLOWED403
POST /passes
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
POST /notifications/push
NOT_ENOUGH_POINTS403
POST /passes/{id}/redeem
OFFER_COOLDOWN403
POST /passes/{id}/redeem-offer
OFFER_EXHAUSTED403
POST /passes/{id}/redeem-offer
OFFER_EXPIRED403
POST /passes/{id}/redeem-offer
OFFER_NOT_ELIGIBLE403
POST /passes/{id}/redeem-offer
OFFER_NOT_STARTED403
POST /passes/{id}/redeem-offer
OFFER_WRONG_LOCATION403
POST /passes/{id}/redeem-offer
PIN_REQUIRED403
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
PLAN_FEATURE_REQUIRED403alle endpoints
REDEEM_NOT_AT_LOCATION403
POST /passes/{id}/redeem
REWARD_ALREADY_REDEEMED403
POST /passes/{id}/redeem
REWARD_EXPIRED403
POST /passes/{id}/redeem
REWARD_LIMIT_REACHED403
POST /passes/{id}/redeem
REWARD_MEMBERSHIP_REQUIRED403
POST /passes/{id}/redeem
REWARD_MIN_PURCHASE403
POST /passes/{id}/redeem
REWARD_NOT_COMBINABLE403
POST /passes/{id}/redeem
REWARD_NOT_YET_VALID403
POST /passes/{id}/redeem
REWARD_QUOTA_EXHAUSTED403
POST /passes/{id}/redeem
REWARD_THRESHOLD_NOT_REACHED403
POST /passes/{id}/redeem
REWARD_TIER_REQUIRED403
POST /passes/{id}/redeem
REWARD_WRONG_LOCATION403
POST /passes/{id}/redeem
ROLE_NOT_ALLOWED403
POST /passes/{id}/cancel
SCOPE_MISSING403alle endpoints
STAMP_LIMIT_REACHED403
POST /passes/{id}/stamp
CARD_NOT_FOUND404
POST /passes
POST /notifications/push
CUSTOMER_NOT_FOUND404
GET /customers
GET /customers/{id}
EMPLOYEE_NOT_FOUND404
POST /passes
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
NOT_FOUND404
GET /passes/{id}/offers
POST /passes/{id}/redeem-offer
OFFER_NOT_FOUND404
POST /passes/{id}/redeem-offer
PASS_NOT_FOUND404
GET /passes/by-serial/{serial}
GET /passes/{id}
POST /passes/{id}/stamp
POST /passes/{id}/redeem
GET /passes/{id}/offers
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
REWARD_NOT_FOUND404
POST /passes/{id}/redeem
CARD_ARCHIVED409
POST /passes
POST /passes/{id}/redeem-offer
CARD_NOT_AT_LOCATION409
POST /passes
IDEMPOTENCY_KEY_REUSED409
POST /passes
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
POST /notifications/push
LOCATION_DEACTIVATED409
POST /passes
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
OFFER_ALREADY_REDEEMED409
POST /passes/{id}/redeem-offer
OFFER_USED_UP409
POST /passes/{id}/redeem-offer
PASS_VOIDED409
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/redeem-offer
POST /passes/{id}/cancel
REQUEST_ABANDONED409
POST /passes/{id}/stamp
POST /passes/{id}/redeem-offer
POST /notifications/push
UNPROCESSABLE422
POST /notifications/push
RATE_LIMITED429alle endpoints
INTERNAL_ERROR500alle endpoints
REQUEST_IN_PROGRESS503alle endpoints
RETRY503
POST /passes/{id}/stamp
POST /passes/{id}/redeem
POST /passes/{id}/cancel
SERVICE_UNAVAILABLE503
GET /passes/by-serial/{serial}
GET /passes/{id}
GET /passes/{id}/offers
GET /customers
GET /customers/deleted
GET /customers/{id}
GET /analytics
GET /cards
GET /locations
GET /employees

Toewijzing

  • Elke boeking noemt employeeId (een actieve medewerker van de zaak, toegewezen aan de locatie) en locationId.
  • Je systeem kan ook employeeRef meesturen, het kenmerk van de kassamedewerker. Gebruik kassa- of personeelsnummers, geen echte namen.
  • Noemt je systeem een medewerker met een hogere rol dan de sleutel toestaat, dan antwoordt de koppeling met 403 ACTOR_ROLE_NOT_ALLOWED.
  • Annuleren vraagt een medewerker met de rol MANAGER of OWNER en een sleutel waarvan de actorrol minstens MANAGER is.

Scopes

Standaard geweigerd: een sleutel mag alleen wat zijn scopes toestaan. Ontbreekt er een, dan krijg je 403 SCOPE_MISSING.

ScopeWat de eigenaar zietEndpoints
pass:writeKaarten uitgeven en stempelen
POST /passes
POST /passes/{id}/stamp
pass:readKaarten bekijken
GET /passes/by-serial/{serial}
GET /passes/{id}
pass:redeemBeloningen inwisselen
POST /passes/{id}/redeem
offer:readAanbiedingen bekijken
GET /passes/{id}/offers
offer:redeemAanbiedingen inwisselen
POST /passes/{id}/redeem-offer
pass:cancelKaarten annuleren
POST /passes/{id}/cancel
customer:readGasten bekijken
GET /customers
GET /customers/deleted
GET /customers/{id}
notification:sendBerichten naar gasten sturen
POST /notifications/push
analytics:readCijfers opvragen
GET /analytics
setup:readKaarten, locaties en team opvragen
GET /cards
GET /locations
GET /employees

Idempotentie

  • Alle POST-endpoints accepteren de header Idempotency-Key. Die geldt per API-sleutel, is gebonden aan methode, pad en inhoud en heeft maximaal 255 zichtbare ASCII-tekens, bijvoorbeeld het bonnummer.
  • Dezelfde herhaling geeft hetzelfde antwoord, bij de aanmeldlink een verse link. Andere inhoud met dezelfde sleutel geeft 409 IDEMPOTENCY_KEY_REUSED. Loopt de eerste aanvraag nog, dan krijg je 503 REQUEST_IN_PROGRESS.
  • Alleen een geslaagd antwoord wordt bewaard, 7 dagen lang. Na die 7 dagen blijven alleen stempelen en beloningen inwisselen beschermd: dezelfde kaart met dezelfde sleutel wordt niet dubbel geboekt, een andere kaart geeft 409 IDEMPOTENCY_KEY_REUSED.

Bijzonder geval: voordeelkaart. Op een voordeelkaart boekt de aanroep een bezoek. Net als een aanbieding inwisselen is dat maar 7 dagen beschermd via de Idempotency-Key. Breekt de eerste aanvraag halverwege af, dan wordt die nooit opnieuw uitgevoerd (eerst 503 REQUEST_IN_PROGRESS, daarna 409 REQUEST_ABANDONED). Controleer de stand met GET /passes/{id} en boek zo nodig opnieuw met een nieuwe Idempotency-Key.

Kenmerken

Kenmerken in paden hebben maximaal 64 tekens; langere geven 400.

Rate-limits

  • 300 aanvragen per minuut per sleutel over alle endpoints. Headers: X-RateLimit-Limit-api, X-RateLimit-Remaining-api, X-RateLimit-Reset-api.
  • E-mailzoekopdracht (GET /customers) daarnaast 60 per minuut per sleutel en 120 per minuut per zaak. Headers: X-RateLimit-Limit-customerLookup, X-RateLimit-Remaining-customerLookup.
  • Daarboven krijg je 429 RATE_LIMITED met de standaardheader Retry-After (seconden) en Retry-After-api of Retry-After-customerLookup.
  • Veel foute sleutels vanaf één adres leiden tot een tijdelijke blokkade van dat adres, ook 429 met Retry-After.

Geen testmodus

Er is geen sandbox en er zijn geen testsleutels. Elke sleutel boekt echt: boekingen verschijnen in de analyses en het activiteitenlogboek, ingewisselde beloningen ook in het belastingoverzicht.

  • Test met een eigen testkaart en een eigen sleutel met weinig scopes, en trek die daarna in.
  • Gebruik POST /notifications/push niet om te testen; de berichten gaan naar echte gasten.
  • Webhooks kun je veilig testen, zie Webhooks testen.

Versies

De versie staat in het pad (/api/v1). Nieuwe velden in antwoorden en nieuwe gebeurtenissen kunnen altijd bijkomen, dus sla onbekende velden over. Brekende wijzigingen komen alleen met een nieuwe versie en vooraankondiging.

Webhooks

Aanmaken

De eigenaar maakt de webhook aan onder Integraties: een openbaar bereikbaar HTTPS-adres en de gekozen gebeurtenissen. Het webhookgeheim wordt één keer getoond. Het is niet de API-sleutel: de sleutel geeft toegang tot tapja, het geheim controleert alleen de berichten die bij jou binnenkomen.

Gebeurtenissen

GebeurtenisNaamVelden in data
pass.createdKaart uitgegevenpassId cardId customerId employeeId locationId channel
pass.stampedStempel toegevoegdpassId cardId stampCount pointsBalance employeeId locationId channel
pass.redeemedBeloning ingewisseldpassId rewardId (optioneel) locationId (optioneel)
pass.cancelledKaart geannuleerdpassId cardId
pass.reactivatedKaart weer actiefpassId customerId
pass.correctedBoeking gecorrigeerdpassId field value employeeId (optioneel) locationId (optioneel)
reward.readyBeloning klaarpassId cardId rewardIds
offer.redeemedAanbieding ingewisseldpassId offerId locationId (optioneel)
package.usedPakketeenheid gebruiktpassId quantity units employeeId locationId (optioneel)
customer.createdGast toegevoegdcustomerId
customer.deletedGast verwijderdcustomerId passIds
customer.consent_changedMarketingtoestemming gewijzigdcustomerId marketingConsent
campaign.sentBericht verstuurdcampaignId recipients

Daarnaast is er de testgebeurtenis ping met het veld message, waarop je niet kunt abonneren. Alle beschrijvingen staan in de referentie.

Envelop en headers

Elk bericht heeft de velden id, event, data en timestamp. X-tapja-Delivery is gelijk aan de id.

json
{
  "id": "evt_3f2a…",
  "event": "pass.redeemed",
  "data": { "passId": "pass_123", "rewardId": "rw_1" },
  "timestamp": "2026-11-07T10:00:00.000Z"
}
http
X-tapja-Event: pass.redeemed
X-tapja-Delivery: evt_3f2a…
X-tapja-Timestamp: 1794045600
X-tapja-Signature: sha256=<hex>
User-Agent: tapja-webhooks/2

Handtekening controleren

HMAC-SHA256 met het webhookgeheim over ${X-tapja-Timestamp}.${ruwe body}, tolerantie 300 seconden, vergelijking in constante tijd. Het gaat om de ruwe body, vóór elke JSON-verwerking.

Node.js
import { createHmac, timingSafeEqual } from 'node:crypto';
function verify(rawBody, headers, secret) {
  const ts = headers['x-tapja-timestamp'];
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
  const expected = 'sha256=' + createHmac('sha256', secret).update(`${ts}.${rawBody}`).digest('hex');
  const given = String(headers['x-tapja-signature'] ?? '');
  return given.length === expected.length && timingSafeEqual(Buffer.from(given), Buffer.from(expected));
}
Python
import hmac, hashlib, time
def verify(raw_body: bytes, headers, secret: str) -> bool:
    ts = headers['X-tapja-Timestamp']
    if abs(time.time() - int(ts)) > 300:
        return False
    expected = 'sha256=' + hmac.new(secret.encode(), f'{ts}.'.encode() + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(headers.get('X-tapja-Signature', ''), expected)

Levering

  • Antwoord snel met een 2xx en doe het werk asynchroon. Na 10 seconden geldt de poging als mislukt.
  • Bij een niet-2xx volgen maximaal 5 herhalingen na ongeveer 1, 2, 4, 8 en 16 minuten, samen zo’n half uur.
  • De id blijft bij herhalingen gelijk. Ontdubbel daarop.
  • Na 30 mislukte pogingen op rij pauzeert de webhook, en de eigenaar activeert hem weer. Gebeurtenissen uit de pauze worden niet nageleverd.

Volgorde

De volgorde is niet gegarandeerd. pass.created kan vóór customer.created aankomen, reward.ready vóór pass.stamped. Orden standen via timestamp of GET /passes/{id}.

customer.deleted is een definitieve verwijdermarkering: negeer later binnenkomende gebeurtenissen over deze gast en maak hem niet opnieuw aan.

Webhooks zijn geen sluitend logboek. Stem kritieke standen waar nodig af met GET.

Geheim vernieuwen

Het nieuwe webhookgeheim geldt meteen, zonder overgangstijd. Vernieuw het op een rustig moment en zet het nieuwe geheim er direct in.

Webhooks testen

  • „Test versturen” stuurt ping, „Voorbeeldgebeurtenis sturen” een voorbeeld van een geabonneerd type.
  • Tests dragen het veld "test": true en de header X-tapja-Test: 1. Echte gebeurtenissen dragen geen van beide. Alle kenmerken zijn verzonnen en beginnen met test_.
  • Tests worden niet herhaald, gaan ook naar gepauzeerde webhooks en tellen nooit mee voor de pauze. Maximaal 20 tests per uur per webhook.
  • Herken tests aan het veld test en boek ze niet.

Verwijderingen en privacy

  • customer.deleted noemt de kenmerken van de gast en zijn kaarten.
  • Gemiste verwijderingen haal je op met GET /customers/deleted?since=…: de laatste 30 dagen, alleen kenmerken, cursorgebaseerd. Stem het liefst dagelijks af en verwijder ook in je eigen systeem.
  • Wordt de hele zaak verwijderd, dan komt er geen customer.deleted per gast.
  • Webhooks bevatten alleen kenmerken en tellers, geen namen of adressen.
  • Het e-mailadres van een gast geven alleen GET /customers/{id} en de e-mailzoekopdracht GET /customers. Elke opvraging wordt gelogd.
  • Marketing vanuit je eigen systeem gaat alleen naar gasten met marketingConsent: true en een ingevuld emailVerifiedAt.
  • GET /employees geeft de namen en rollen van het team. Geef setup:read alleen aan systemen die het nodig hebben.
bash
curl "https://api.tapja.de/api/v1/public/customers/deleted?since=2026-11-01T00:00:00.000Z" \
  -H "Authorization: Bearer sk_live_…"

Verantwoordelijkheid voor gegevens

De zaak is verantwoordelijk voor de gegevens in haar eigen systeem. Afhankelijk van de opzet heeft ze een verwerkersovereenkomst nodig met de aanbieder van dat systeem en noemt ze het systeem in haar privacyverklaring.

Contact

Vragen over de koppeling en beveiligingsbevindingen stuur je naar hallo@tapja.de. Noem het endpoint, de tijd (UTC) en de foutcode. Stuur nooit de API-sleutel of het webhookgeheim mee.