---
title: "Overzicht"
icon: "info"
visibility: "public"
---

Welkom bij de Vakgarage API, het platform waarmee externe partijen toegang krijgen tot de data en diensten van het Vakgarage netwerk.

Via deze API kun je onder andere:

- **Occasions** opvragen van individuele garages of het volledige Vakgarage netwerk
- **Planner-afspraken** inplannen en beschikbaarheid ophalen per vestiging
- **Reviews** ophalen van klanten per garage of reviewplatform
- **Vestigingsgegevens** opvragen, inclusief locatie en de dichtstbijzijnde garage

Daarnaast kun je je aanmelden voor **webhooks**: dan sturen wij een bericht zodra er bij ons een vestiging wijzigt, zodat je niet hoeft te blijven navragen of er iets veranderd is.

De API is ontworpen voor ontwikkelaars die integraties bouwen met websites, portals of applicaties die aansluiten op het Vakgarage netwerk. Denk aan autodealerwebsites, WordPress plugins of maatwerksoftware.

## Zo werkt het in het kort

1. **Een account.** Je krijgt van Problicity een `client_id`, `client_secret` en `apikey`.
2. **Een token.** Daarmee haal je via `POST /api/authenticate` een token op dat **2 uur** geldig is, en stuur je het mee als `Authorization: Bearer …`. Een paar endpoints, zoals die van de WordPress-plugin, gebruiken de `apikey` direct, in de header `X-API-KEY`.
3. **Welke vestigingen.** Een account van het type `establishment` hoort bij één vestiging; een `global` account mag het hele netwerk. Endpoints voor één vestiging herken je aan `{franchiseId}` in het pad.
4. **Welke endpoints.** Je account heeft permissies. Roep je een endpoint aan zonder de permissie, dan krijg je `403`.
5. **Op de hoogte blijven.** Met een webhook krijg je een bericht zodra er bij ons een vestiging wijzigt. Het bericht noemt alleen wat er gebeurde; de gegevens haal je daarna zelf op.

In de API-referentie ontgrendel je met je `apikey` de endpoints waarvoor je permissie hebt.

## Aan de slag

[cards]
- [Account aanvragen](/apiportaal/aan-de-slag/account-aanvragen) Wat je nodig hebt en hoe je een account krijgt.
- [API-referentie](/apiportaal/api/introductie) Alle endpoints, met voorbeelden en Try it out.
- [Authenticatie](/apiportaal/api/authentication) Meer over tokens en API keys.
- [Client types](/apiportaal/api/client-types) Hoe je één vestiging aanspreekt.
- [Permissies](/apiportaal/api/permissions) Welke endpoints je kunt aanroepen.
- [Errors](/apiportaal/api/errors) Hoe foutmeldingen eruitzien.
- [Endpoints](/apiportaal/api/endpoints/vestigingen) Vestigingen, occasions, planner en reviews.
- [Webhooks](/apiportaal/api/koppelingen/webhooks) Een bericht ontvangen zodra er iets wijzigt.
- [Hoe het werkt](/apiportaal/aan-de-slag/werking) Voor het team: waar de gegevens vandaan komen.
- [Beheer](/apiportaal/beheer/beheeromgeving) Voor het team: accounts, webhooks en jobs.
[/cards]