Bouwsoftware
Kun je Woub koppelen aan je bestaande bouwsoftware via een open API?
Een open API maakt gegevensuitwisseling mogelijk. Voor een bruikbare koppeling moet ook duidelijk zijn welke gegevens, rechten, verantwoordelijkheden en fouten erbij horen.
Door: Woub redactie
Direct antwoord
Woub documenteert een open API waarmee je eigen IT-afdeling of een technische partner een integratie kan ontwikkelen. Of een bepaalde koppeling werkt, hangt ook af van het andere systeem, de ondersteunde bewerkingen en de inrichting. Beschrijf eerst de gewenste datastroom en test die. Een open API is geen bewijs van een standaardkoppeling, tweerichtingsverkeer of autonome verwerking in externe administraties.
Wat biedt de open API van Woub?
De Woub-kennisbank beschrijft dat klanten of hun IT-partner integraties kunnen ontwikkelen met systemen die daarvoor geschikte mogelijkheden bieden. Woub ondersteunt de werking van zijn API; maatwerk vraagt een afzonderlijke afspraak.
Begin niet met alle gegevens tegelijk. Kies één overdracht, bijvoorbeeld een gecontroleerde projectreferentie. Definieer eerst wie het gegeven beheert en welke gebeurtenis een uitwisseling moet starten.
Welke Woub-datastromen worden aantoonbaar ondersteund?
Een concrete datastroom is pas aantoonbaar wanneer de relevante documentatie en test laten zien welke bewerking beschikbaar is. Noteer bron, bestemming, gegevensvelden en lees- of schrijfrichting. Controleer ook authenticatie en toegangsrechten.
In dit concept is geen endpointcontract of klantintegratie end-to-end getest. Daarom geven we geen volledige lijst van gegarandeerde lees- en schrijfmogelijkheden. De openbare documentatie is het startpunt; laat de gewenste route technisch bevestigen vóór je haar als beschikbare koppeling beschrijft.
Wat is het verschil tussen maatwerk en standaardintegratie?
Een standaardintegratie heeft een afgebakende ondersteunde werking en voorwaarden. Maatwerk wordt ontwikkeld voor een specifieke gegevensoverdracht en vraagt afspraken over beheer, wijzigingen en ondersteuning. Een bestandsimport is opnieuw een andere route.
Gebruik die woorden precies. Een eenmalige export is geen continue synchronisatie; éénrichtingsverkeer is geen tweerichtingskoppeling. Laat de leverancier voordoen wat er gebeurt bij een correctie, een dubbel bericht en een tijdelijke storing.
Welke technische partners kunnen helpen?
Volgens de Woub-kennisbank kan een eigen IT-afdeling of leverancier helpen; Woub kan op aanvraag meedenken of ontwikkeling aanbieden volgens een aparte afspraak. Er is hier geen specifieke partner als gecertificeerd of algemeen bevoegd aangemerkt.
Kies een partij die zowel het technische contract als het bedrijfsproces begrijpt. Spreek af wie wijzigingen monitort, wie gegevens herstelt en waar een gebruiker een fout meldt. Een werkende eerste demonstratie is nog geen onderhoudsafspraak.
Hoe voorkom je verkeerde koppelingclaims?
Noem het andere systeem en de concrete versie of inrichting.
Beschrijf precies welke gegevens worden uitgewisseld en in welke richting.
Leg vast wat nog handmatig moet gebeuren.
Test rechten, correcties, fouten en herstart na uitval.
Documenteer beschikbaarheid, beheer en beperkingen.
Gebruik daarna pas een concrete koppelingclaim. Woub blijft aanvullend op de gespecialiseerde bronsystemen en geeft AI niet automatisch bevoegdheid om hun administraties bij te werken.
Lees ook onze verdieping over de bijbehorende projectwerkwijze.
Probeer 14 dagen gratis en test de werkwijze met een eigen project.
Veelgestelde vragen
Is een open API hetzelfde als een standaardintegratie?
Nee. De API biedt een ontwikkelmogelijkheid. Een specifieke integratie moet beschikbaar zijn, passend ingericht worden en worden getest.
Welke gegevens kan mijn koppeling uitwisselen?
Dat moet blijken uit de actuele API-documentatie en een test van de gewenste route. Dit concept claimt geen volledig geverifieerde endpointlijst.
Deze site wordt beschermd door reCAPTCHA. Het privacybeleid en de servicevoorwaarden van Google zijn van toepassing.
