Hoe koppel ik Incontrol aan mijn eigen systemen (API)

Wil je Incontrol integreren met jouw eigen systemen? Volg deze stappen om direct aan de slag te gaan met onze publieke API via Swagger:

1. Navigeer naar Incontrol --> organisatie --> Service accounts

2. Maak een service account aan door op het plusje te drukken. 

3. Geef je service account een naam en kopieer de token die je krijgt.

4. Ga naar de Swagger-documentatie:
Bezoek de Swagger-pagina van de Incontrol API, door rechts boven op "API-Documentatie" te drukken. Hier vindt u een volledig overzicht van de beschikbare mogelijkheden, inclusief technische details en voorbeeldaanvragen.

4. Authenticatie instellen: 
Klik op de knop ‘Authorize’ in de Swagger-interface en vul je token in. Dit autoriseert je organisatie om veilig verbinding te maken en beschermt je data volgens actuele beveiligingsstandaarden.

5. Kies de juiste functiegroep:  
   De API is opgebouwd uit herkenbare hoofdgroepen zoals:
   - Case: Dossierbeheer – voor het ophalen, aanmaken of wijzigen van cases.
   - Document: Voor het centraal beheren, delen en downloaden van documenten.
   - User: Gebruikersbeheer, zoals het aanmaken van nieuwe gebruikers of wijzigen van rechten.
   - Task, Form, Notification, Organization, File: Voor het automatiseren van taken, beheren van formulieren, meldingen, organisatiestructuren en bestanden.

6. Voer een testaanroep uit:  
In Swagger kan je direct per endpoint een voorbeeldaanroep doen. Vul de gevraagde parameters in, klik op ‘Try it out’ en bekijk het resultaat. Zo test je eenvoudig hoe data uit Incontrol in je eigen systeem kan worden opgenomen, bijvoorbeeld om inspectiegegevens te integreren met jouw compliance-dashboard.

7. Integreer met je processen:  
Gebruik de technische specificaties in de Swagger-documentatie als blauwdruk voor je ontwikkelwerkzaamheden. Koppel bijvoorbeeld:
   - Inspectieresultaten of dossiers rechtstreeks aan jouw ERP- of complianceplatform;
   - Nieuwe documenten of taaknotificaties automatisch aan teams;
   - Gebruikersbeheer centraal voor identity management en toegangscontrole.

Met deze aanpak automatiseer en centraliseer je eind-tot-eind compliance en inspecties binnen jouw organisatie, terwijl je altijd werkt met actuele en beveiligde gegevens. Raadpleeg de Swagger-documentatie van Incontrol voor de meest recente endpoints, autorisatie-eisen en best practices rond integratie.

Vragen over een specifieke koppeling? Ons supportteam denkt graag mee over de beste aanpak voor jouw situatie.