Wat hier niet staat, en waarom
Dit is een handleiding om de koppeling te bedienen, geen specificatie om er een te bouwen. De binnenkant blijft er met opzet uit: de volgorde waarin de connector EAIWS aanroept, hoe het webhook-token wordt opgebouwd en gecontroleerd, de veld-voor-veld-vorm van de catalogus-endpoints, en het berichtcontract dat de ERP-bridge spreekt. Dat bestaat allemaal en het is vastgelegd, het is alleen niet gepubliceerd.
Bouw je een adapter voor een platform dat we nog niet dekken, dan is dat materiaal precies wat je onder afspraak krijgt, en dat is een echt gesprek en geen afwimpeling. De drie contracten zijn versioneerd, hun vormen liggen vast in tests, en elk antwoord draagt de versie waartegen het gebouwd is, zodat een adapter kan zien dat de grond onder hem verschoven is.
Wat je hier wel vindt is alles wat je nodig hebt om een verbinding te bedienen, te onderzoeken en te onderhouden zonder ons erbij, en dat is het deel dat bepaalt of dit prettig is om te hebben.
De huidige contractversies. Catalogus catalog/1, bridge bridge/1, updates updates/1. Elk antwoord van de gate draagt zijn versie in een header. Velden toevoegen mag binnen een versie, hernoemen of weghalen betekent een nieuwe. Deze nummers worden bij het bouwen van deze pagina rechtstreeks uit de draaiende configuratie gelezen, dus ze kunnen niet stilletjes achterlopen.