Developers

Embed & public API

Toon je GMS Pro-voorraad op je eigen website. Leads komen binnen in je dashboard.

Website-embed

Plaats de snippet op elke pagina waar je voorraad wilt tonen. Het script rendert in een Shadow DOM op het element uit data-target. Detailweergave opent wanneer de hostpagina ?auto=slug bevat.

<div id="voorraad"></div>
<script
  src="https://embed.gmspro.nl/v1/voorraad.js"
  data-key="pk_JOUW_SLEUTEL"
  data-target="#voorraad"
  data-api="https://api.gmspro.nl"
  data-primary-color="#1a6b8a"
  data-columns="3"
  async
></script>

data-key — publieke API-sleutel (Embed-instellingen in GMS Pro)
data-api — optioneel, default https://api.gmspro.nl
data-primary-color — accentkleur voor knoppen en prijzen
data-columns — gridkolommen (1–4)

Build & deploy: zie monorepo apps/embed — upload dist/voorraad.js naar R2 als v1/voorraad.js.

REST API

Alle endpoints vereisen een geldige key en een HTTP Origin die is toegestaan in je embed-instellingen. Financiële velden (inkoop, marge, kosten) worden nooit teruggegeven.

GET /public/v1/vehicles

Query: key, page, page_size (max 50). Response: vehicles[], total, page.

GET /public/v1/vehicles/:slug

Query: key. Response: vehicle object met foto's en vraagprijs.

POST /public/v1/leads

JSON body: key, name, email, optioneel stock_vehicle_id, type (contact|proefrit), phone, message.

Download OpenAPI JSON

CORS & beveiliging

Stel toegestane domeinen in onder Voorraad → Embed. Alleen actieve Voorraad-abonnementen met embed-recht mogen de API benaderen. Overweeg Cloudflare Turnstile op leads (server-side TURNSTILE_SECRET_KEY) — zie docs/voorraad-setup.md in de repo.