Overzicht

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#