Configurator en /_gp
Een website op giantpanda.site praat met Reuzenpanda via /_gp/v1 op zijn eigen adres. Er is geen extra script of
API-sleutel nodig, en er gaan geen cookies naar een ander domein. De volledige specificatie staat op
files.giantpanda.site/openapi/gp-v1.yaml (opens in a new tab).
Een configurator koppelen
- Maak de configurator in Hub (Formulieren).
- Koppel hem in de instellingen van de website (Configurators) aan een pad, bijvoorbeeld
veranda. - Je site gebruikt dat pad (de slug) in de aanroepen hieronder.
De aanroepen
| Aanroep | Wanneer |
|---|---|
POST /_gp/v1/boot | Elke pagina, bij het laden (bezoekers tellen). |
POST /_gp/v1/configurators/{slug}/boot | Een pagina met een configurator, bij het laden. Geeft een token. |
GET /_gp/v1/definitions/{slug} | De vragen en stappen van de configurator. |
PUT /_gp/v1/leads/{id} | Een aanvraag opslaan; met submit: true versturen. Stuur het token mee in X-GP-Token. Het id is een UUID die je zelf maakt. |
POST /_gp/v1/leads/{id}/attachments | Een bestand bij een vraag uploaden. |
POST /_gp/v1/events | "Bezoeker stelt samen" (fire-and-forget). |
GET / PUT /_gp/v1/consent | De cookiekeuze van de bezoeker lezen of opslaan. |
- Aanroepen die iets opslaan, werken alleen vanaf de site zelf (zelfde origin).
PUT /leads/{id}is idempotent: opnieuw versturen met hetzelfde id maakt geen tweede aanvraag.
Op een voorbeeldadres (…preview.giantpanda.site) en in het voorbeeld in Hub werkt de configurator gewoon, maar
een aanvraag wordt niet verstuurd en er wordt niets geteld. Het antwoord bevat dan "preview": true. Test een
echte aanvraag op de live site.