Aan de slag¶
Vanaf een nieuwe organisatie tot een eerste API-aanroep duurt een paar minuten.
14 dagen gratis proberen¶
Elke organisatie kan een gratis proefperiode van 14 dagen van Data Bridge starten: geen betaalmethode nodig, één proefperiode per organisatie en app. Start ze via de knop Nu proberen van de app in het Exact App Center (u meldt zich aan met Exact Online en het portaal maakt uw account en organisatie aan), of in het portaal onder Organisatie → Abonnementen. Als de proefperiode afloopt, stopt de toegang; wie tijdens de proefperiode een abonnement neemt, behoudt alles en het abonnement start na de proefperiode.
Een plan kan op elk moment worden opgewaardeerd onder Organisatie → Abonnementen: het nieuwe plan wordt volledig aangerekend en de ongebruikte dagen van het oude plan worden terugbetaald via een creditnota.
Vereisten¶
- Een account in het Exact Gateway portaal (https://apps.mvdw-software.com/exact/portal/) en een organisatie met een actief Data Bridge-abonnement (ingeschreven in het portaal onder Organisatie → Abonnementen).
- Een Exact Online-verbinding voor deze app: in het portaal onder Organisatie → Exact Online-verbinding, kies de app Data Bridge en log in met het Exact-account dat de gegevens mag lezen. Dezelfde pagina toont de administraties (divisies) die voor deze app zijn ingeschakeld; de bridge kan alleen de ingeschakelde zien.
- Wijzigingen (sleutels, gekoppelde apps, de cache) worden gedaan door organisatiebeheerders, en beheeracties vereisen tweefactorauthenticatie in het portaal. Het dashboard en gebruik bekijken werkt voor elk lid.
Het dashboard toont de staat van alles dit, en blijft een snelle start totdat de organisatie een sleutel of een gekoppeld gereedschap heeft:
Maak uw eerste API-sleutel¶
Open Toegang → Nieuwe API-sleutel. De sleutel krijgt een naam, een toegangsvoorinstelling, de administraties en optioneel — een lijstje van toegestane IP-adressen:
| Veld | Betekenis |
|---|---|
| Naam | iets dat de consument herkent, bijv. ERP-integratie |
| Toegang | een voorinstelling, of Aangepast voor de volledige matrix van datatypes × LEZEN / SCHRIJVEN / WISSEN: Alleen lezen (alle gegevens lezen), Lezen & schrijven (lezen, aanmaken en wijzigen), Volledig (inclusief verwijderen), Aangepast (kiezen per datatype) |
| Administraties | Alle ingeschakelde administraties (standaard; later ingeschakelde administraties worden automatisch opgenomen) of een selectie |
| Toegestane IP-adressen (geavanceerd) | een toestemmingslijst, gewone adressen of CIDR-bereiken; leeg betekent elk adres |
Druk op API-sleutel aanmaken. De sleutel wordt één keer getoond:
Kopieer hem en bewaar hem waar de consument hem kan lezen (een secret store, geen repository). Hij wordt nooit meer getoond — alleen zijn eerste karakters staan in de lijst. Indien hij verloren gaat, trek hem dan in en maak er een nieuwe aan.
Doe de eerste aanroep¶
Het tabblad REST API op het dashboard toont de basis-URL en een eerste aanroep:
curl -H "Authorization: Bearer exg_live_…" \
https://apps.mvdw-software.com/exact/data-bridge/api/v1/resources
Het antwoord geeft de datatypes weer die de API aanbiedt, inclusief hun filters en sortsleutels. Probeer vervolgens de data:
# de administraties die deze sleutel mag gebruiken
curl -H "Authorization: Bearer exg_live_…" \
https://apps.mvdw-software.com/exact/data-bridge/api/v1/divisions
# een paar klanten van administratie 321654
curl -H "Authorization: Bearer exg_live_…" \
"https://apps.mvdw-software.com/exact/data-bridge/api/v1/divisions/321654/accounts?limit=5"
Alles wat de REST API biedt staat in Koppel uw gereedschap → REST API.
Of koppel een AI-gereedschap¶
Als de consument Claude, ChatGPT of een andere MCP-client is, sla dan de sleutel over: het tabblad MCP op het dashboard bevat de server-URL en de per-gereedschapsinstructies, en de toestemming die een beheerder goedkeurt staat in Koppel uw gereedschap → MCP.
U bent klaar¶
Met een sleutel (of een gekoppeld app) schakelt het dashboard van snelle start naar status en activiteit, en de Gebruikspagina vult binnen een minuut na de eerste aanroep. De rest staat in dagelijks gebruik.