Hoe een koppeling gebouwd wordt

Wat een koppeling in productie eruitziet

We zitten tussen twee leverancier-systemen. Jouw platform belt één stabiele endpoint. Een breaking change upstream is ons probleem om op te vangen, niet dat van jouw product.

De zes fasen

1. 01

   Scoping call

   1 week

   We brengen de systemen aan beide kanten in kaart, de data die moet bewegen en de faalmodi die u al kent.

   Wij doen

   • Doornemen van de API-documentatie van beide systemen
   • Identificeren van entiteiten, richting en volume
   • Vroeg signaleren van authenticatie- en rate-limitbeperkingen

   U doet

   • Een technisch contactpersoon aanwijzen
   • API-documentatie of een sandbox-account delen

   Resultaat: Scopenotitie met entiteiten, richting en openstaande vragen

2. 02

   Interfaceontwerp

   1–2 weken

   Een schriftelijk contract vóór er code is: veldmapping, foutafhandeling, retrybeleid en de exacte vorm van elke payload.

   Wij doen

   • Mapping op veldniveau tussen beide schema's
   • Vastleggen van idempotentiesleutels en retry/backoff-regels
   • Overeenstemming over foutentaxonomie en alertdrempels

   U doet

   • De mapping beoordelen en goedkeuren
   • Randgevallen uit uw domein bevestigen

   Resultaat: Ondertekende interfacespecificatie

3. 03

   Bouw & sandbox

   2–6 weken

   We bouwen de integratie tegen sandbox-credentials, met geautomatiseerde tests die de mapping en de faalpaden dekken.

   Wij doen

   • Implementeren van transformaties, queueing en retries
   • Contracttests tegen beide sandboxes
   • Gestructureerde logging en correlatie-ID's

   U doet

   • Sandbox-credentials aanleveren
   • Vragen beantwoorden binnen twee werkdagen

   Resultaat: Werkende integratie op onze staging-omgeving

4. 04

   Acceptatie

   1–2 weken

   U test tegen praktijkscenario's. Wij lossen op, u test opnieuw, en we leggen de go-live-criteria schriftelijk vast.

   Wij doen

   • Doorlopen van de afgesproken testscenario's
   • Defecten oplossen binnen de sprint

   U doet

   • Data in uw eigen systeem valideren
   • De acceptatiechecklist ondertekenen

   Resultaat: Acceptatieakkoord en go-live-datum

5. 05

   Go-live

   1 dag

   Productiecredentials, een gecontroleerde overgang en een gemonitorde eerste week met een vaste engineer beschikbaar.

   Wij doen

   • Uitrollen naar productie
   • Doorvoer en foutpercentages zeven dagen volgen

   U doet

   • Productiecredentials wisselen
   • Eerste succesvolle transacties bevestigen

   Resultaat: Integratie live, monitoringdashboards overgedragen

6. 06

   Beheer & onderhoud

   Doorlopend

   Wij hosten het, monitoren het en passen het aan wanneer een van beide partijen zijn API wijzigt. Geversioneerd, met een changelog per integratie.

   Wij doen

   • 24/7 alerting op foutpercentage en vertraging
   • Bijhouden van upstream API-deprecaties
   • Geversioneerde updates uitbrengen met releasenotes

   U doet

   • Afwijkingen melden via het supportkanaal

   Resultaat: Maandelijkse betrouwbaarheidsrapportage

Wie doet wat

Ondersteuning

Elke integratie wordt door ons gehost en gemonitord. Het serviceniveau bepaalt de reactietijd en de dekking, niet of we ernaar kijken.