AG biedt een openbare REST API voor programmatische bestellingen — handig als je een winkel, automatisering of integratie bouwt die AG-bestellingen moet plaatsen zonder de webkassa te gebruiken. API-toegang wordt per account ingeschakeld.
API-toegang inschakelen
API-toegang wordt door AG-beheerders per account ingeschakeld. Zodra dit is ingeschakeld, zie je de API Keys-kaart in Instellingen.
Een API-sleutel genereren
- Open Instellingen en zoek de API Keys-kaart.
- Klik op Nieuwe sleutel, geef deze een naam en klik op Aanmaken.
- Kopieer het
ag_live_...-token onmiddellijk — het wordt slechts eenmaal weergegeven. - Sla het veilig op (in een secrets manager of
.env-bestand).
Wat je met de API kunt doen
- Prijzen en bezorgopties aanvragen voordat je een bestelling plaatst.
- Bestellingen plaatsen met volledige configuratie (papier, formaat, lijst, montage, bezorgadres).
- Je opgeslagen kaart beheren — vereist voor het plaatsen van bestellingen.
- Bestellingen weergeven en ophalen die via de API zijn geplaatst.
Authenticatie
Geef het token door als een Bearer-header bij elk verzoek:
Authorization: Bearer ag_live_...
Vereiste instellingen
- Een opgeslagen kaart (zie Opgeslagen kaarten beheren) — API-bestellingen worden automatisch in rekening gebracht.
- Een land van woonplaats ingesteld op het account — bepaalt de valuta en Stripe-routering.
Idempotentie
POST /v1/orders accepteert een Idempotency-Key-header om herhaalde pogingen veilig te dedupliceren. Stuur er altijd een voor productie-integraties.
Promotioncodes via de API
POST /v1/orders accepteert een promo_code. Codes worden gevalideerd — een ongeldige code weigert de bestelling in plaats van stilzwijgend de volledige prijs in rekening te brengen — en een bestelling die volledig door een promotie wordt gedekt, heeft geen opgeslagen kaart nodig. Grote batchbestellingen (rond de 150 items) worden ondersteund.