JOIN Rest API: verschil tussen versies

Uit JOIN wiki
Ga naar: navigatie, zoeken
(Wat is nog meer belangrijk om te weten?)
(Wat is nog meer belangrijk om te weten?)
Regel 10: Regel 10:
 
=== Waar vind ik de JOIN API? ===
 
=== Waar vind ik de JOIN API? ===
 
de API wordt standaard meegeleverd met de installatie van JOIN, of je nu in de cloud zit of niet. Achter het adres van JOIN typ je "/aspx/api". Je wordt dan automatisch doorgeleid naar de index-pagina van de API. Wij maken gebruik van Swagger, waarmee je snel en eenvoudig door alle beschikbare operaties van de API kunt navigeren.
 
de API wordt standaard meegeleverd met de installatie van JOIN, of je nu in de cloud zit of niet. Achter het adres van JOIN typ je "/aspx/api". Je wordt dan automatisch doorgeleid naar de index-pagina van de API. Wij maken gebruik van Swagger, waarmee je snel en eenvoudig door alle beschikbare operaties van de API kunt navigeren.
 +
[[Bestand:Rest API autoriseren.png|miniatuur|300x300px]]
  
 
=== Hoe werkt de JOIN API? ===
 
=== Hoe werkt de JOIN API? ===
Regel 26: Regel 27:
 
=== Troubleshooting? ===
 
=== Troubleshooting? ===
 
Krijg je een foutmelding terug van de API: in de API staan de meestvoorkomende foutmeldingen (geen toegang bijvoorbeeld) gedocumenteerd.
 
Krijg je een foutmelding terug van de API: in de API staan de meestvoorkomende foutmeldingen (geen toegang bijvoorbeeld) gedocumenteerd.
 +
[[Bestand:RestAPI foutmeldingen.png|geen|miniatuur|441x441px|
 +
veelvoorkomende response messages
 +
]]

Versie van 22 mei 2019 om 05:47

JOIN Zaak & Document beschikt over een RestAPI. Deze API stelt andere softwaretoepassingen in staat om op een laagdrempelige, veilige en moderne manier gebruik te maken van de functionaliteiten van JOIN Zaak & Document. Denk dan bijvoorbeeld aan het ophalen van gegevens en taken, het uitvoeren van zoekopdrachten (op basis van JOIN Search) en het aanmaken van zaken en documenten.

Op deze pagina vind je meer informatie over de RestAPI: hoe kun je deze bereiken, waar vind je de uitgebreide documentatie en op welke manier kan er gebruik worden gemaakt van de API.

Wat is een API?

Een API is een afkorting die staat voor Application Programming Interface. Een API maakt het mogelijk om andere systemen en software een ‘ingang’ tot het systeem te bieden. Met deze ingang kunnen verschillende systemen met elkaar communiceren en gegevens uitwisselen. In dit geval JOIN Zaak & Document en andere systemen. Zo maakt bijvoorbeeld ook JOIN Mobile gebruik van de RestAPI om te communiceren met alle functionaliteit die in JOIN zit.

Om een api simpel uit te leggen, maakt men vaak de vergelijking met een stekker en een stekkerdoos. Een stekkerdoos kan je zien als het systeem of de software. De stekker kan je in dit geval zien als de API. Als de stekker in de stekkerdoos past, dan kunnen ze met elkaar communiceren. Wereldwijd zijn er echter verschillende soorten stekkerdozen, waardoor deze niet altijd in elkaar passen. De documentatie van de API vertelt op welke stekkerdozen de stekker daadwerkelijk past.

Waar vind ik de JOIN API?

de API wordt standaard meegeleverd met de installatie van JOIN, of je nu in de cloud zit of niet. Achter het adres van JOIN typ je "/aspx/api". Je wordt dan automatisch doorgeleid naar de index-pagina van de API. Wij maken gebruik van Swagger, waarmee je snel en eenvoudig door alle beschikbare operaties van de API kunt navigeren.

Rest API autoriseren.png

Hoe werkt de JOIN API?

De JOIN RestAPI werkt zoals je kunt verwachten van een RestAPI. Allerlei operaties zijn mogelijk, zoals het ophalen van documenten, het aanmaken van zaken en het afhandelen van taken. Maar ook zoekopdrachten en gebruikersinformatie kan worden opgehaald.

Wanneer je naar de API navigeert (zie "waar vind ik de API?") kom je in de indexpagina van de API terecht. Hier vind je alle beschikbare typen en operaties. Ook is er documentatie beschikbaar met duidelijke voorbeelden van hoe authenticatie werkt, hoe een zaak kan worden aangemaakt etc.

zaak aanmaken

Wat is nog meer belangrijk om te weten?

Om als klant gebruik te kunnen maken van de RestAPI heb je een geldige licentie nodig voor iedere aansluiting die op de RestAPI wordt gerealiseerd. Voor vragen hierover kun je terecht bij de accountmanager.

Daarnaast moet er in JOIN Mobile een zogenaamde systeemdefinitie worden aangemaakt. Hiermee zorgen we er tevens voor dat alleen toegestane systemen via de RestAPI JOIN mogen benaderen. Omdat de API onderdeel uitmaakt van JOIN Zaak & Document wordt uiteraard zorgvuldig aandacht besteed aan autorisatie & beveiliging.

Troubleshooting?

Krijg je een foutmelding terug van de API: in de API staan de meestvoorkomende foutmeldingen (geen toegang bijvoorbeeld) gedocumenteerd.

veelvoorkomende response messages