De Melding-API en ondertekende webhooks gebruiken

Integreer meldingsdossiers met toegangsgegevens met beperkte rechten, ondertekende levering en inzicht in nieuwe pogingen.

Verbind vertrouwde systemen met API-inloggegevens met beperkte rechten en ondertekende webhooklevering.

Voordat je begint

  • Identificeer de vertrouwde integratie en HTTPS-ontvanger.
  • Bereid een veilige opslag voor geheimen en een procedure voor nieuwe pogingen voor.
Instellingen voor Issue-connectiviteit met beheer van API-tokens, endpointvelden en velden voor ondertekende webhooks.
Connectiviteit beperkt inloggegevens tot één instantie en toont de bezorgstatus van webhooks voor foutanalyse.

Bescherm API-inloggegevens

Schakel de API in en genereer alleen een token voor een vertrouwde integratie. Het token wordt één keer getoond; door het te vernieuwen wordt de vorige inloggegeven ongeldig.

Gebruik gelijktijdigheidscontrole en beperkte rechten

De API kan alleen binnen de instantie met de openbare slug lijsten ophalen, records aanmaken, lezen, bijwerken en statussen wijzigen. Stuur bij het bijwerken de huidige lockversie mee om verouderde wijzigingen te detecteren.

Controleer de webhooklevering

Configureer een HTTPS-ontvanger en geheim. Leveringen worden ondertekend en pogingen blijven zichtbaar voor foutanalyse. Een webhook is een melding en geen bewijs dat het externe systeem de gebeurtenis heeft verwerkt.

Stap voor stap

  1. Open Connectiviteit in Instellingen.
  2. Schakel de API alleen in voor een vertrouwde afnemer.
  3. Genereer het eenmalige token en bewaar het veilig.
  4. Configureer de HTTPS-webhook-URL en het geheim.
  5. Controleer handtekeningen, nieuwe pogingen en de leveringsgeschiedenis.

Laatste controle

  • Het token staat niet in logs of schermafbeeldingen.
  • Bijwerkingen wordt de huidige lockversie meegestuurd.
  • De ontvanger controleert elke handtekening.
Tip: Een geleverde webhook bewijst dat het transport is geslaagd, maar niet dat het externe systeem de verwerking heeft voltooid.