| Wanneer we het hebben over API's en koppelingen met diverse systemen, dan worden daar al snel technische termen gebruikt. In dit document vind je een eenvoudige uitleg over de gebruikte terminologie. |
| Term: | Verklaring: |
| API | Application Programming Interface Communicatie tussen programma’s (zonder tussenkomst van gebruiker) |
| Authenticatie | Dit is het proces waarbij je nagaat of een gebruiker, een andere computer of applicatie daadwerkelijk is wie hij beweert te zijn. Zie wikipedia voor meer uitleg. |
| Controller | Verzameling van o.a. endpoints. |
| Endpoint | Aanspreekpunt voor een request, bijvoorbeeld GET /Opleidingen/{id} > GetById |
| Request | Verzoek voor ophalen, toevoegen, wijzigen, verwijderen van data. |
| Response | Antwoord dat bestaat uit o.a. een Header en een Body (vaak JSON of XML) |
HTTP Methods: |
| GET | Data ophalen |
| POST | Data toevoegen |
| PUT | Data wijzigen (volledig) |
| PATCH | Data wijzigen (deels) |
| DELETE | Data verwijderen |
| Voor extra informatie klik hier. |
HTTP Status codes: |
| 200 | OK |
| 201 | Created |
| 204 | No Con |
Client error: |
| 400 | Bad Request |
| 401 | Unathorized
Meer weten? Klik hier. |
| 403 | Forbidden
Meer weten? Klik hier. |
| 404 | Not Found |
| 409 | Conflict |
| 429 | Limiet bereikt
Meer weten? Klik hier. |
Serverk error: |
| 500 | Internal Server Error |
| Tip: meer weten? Klik dan hier. |
Grant types: |
| Client Credentials: |
- Flow: clientId + secret > valideren > token
- Gebruik: server-to-server
- clientId + secret
- Access Token URL: https://training.coachview.net/auth/connect/token
Meer weten? Klik hier. |
| Authorization Code |
- Flow: Inloggen > authenticeren > valideren > token
- Gebruik: app / website
- Handeling van user nodig
- Veiliger/beter dan Implicit
Meer weten? Klik hier. |
| Implicit (legacy): |
- Flow: Inloggen > authenticeren > token
- Gebruik: app / website
- Handeling van user nodig
- Bij voorkeur niet gebruiken; verouderde methode (legacy)
Meer weten? Klik hier. |
Bijgewerkt tot en met versie 90
