AG tillhandahåller ett offentligt REST API för programmatisk beställning — praktiskt om du bygger en webbutik, automatisering eller integration som behöver göra AG-beställningar utan att använda webbutiken. API-åtkomst styrs per konto.
Aktivera API-åtkomst
API-åtkomst aktiveras av AG-administratörer på per-konto-basis. När det är aktiverat visas API Keys-kortet i Inställningar.
Generera en API-nyckel
- Öppna Inställningar och hitta API Keys-kortet.
- Klicka på New key, ge den ett Name och klicka på Create.
- Kopiera
ag_live_...-token omedelbar — den visas bara en gång. - Lagra den säkert (i en hemlighetshantare eller
.env-fil).
Vad du kan göra med API:et
- Hämta prisuppgifter och leveransalternativ före beställning.
- Placera beställningar med full konfiguration (papper, storlek, ramlista, montering, leveransadress).
- Hantera ditt sparade kort — krävs för att göra beställningar.
- Lista och hämta beställningar som placerats via API:et.
Autentisering
Skicka token som en Bearer-header på varje begäran:
Authorization: Bearer ag_live_...
Nödvändig konfiguration
- Ett sparad kort på fil (se How to manage saved cards) — API-beställningar debiteras automatiskt.
- Ett land för hemvist inställt på kontot — styr valuta och Stripe-filialstyrning.
Idempotens
POST /v1/orders accepterar en Idempotency-Key-header för att säkert deduplicera omförsök. Skicka alltid en för produktionsintegrationer.
Kampanjkoder via API:et
POST /v1/orders accepterar en promo_code. Koder valideras — en ogiltig kod avvisar beställningen istället för att tyst debitera fullt pris — och en beställning som helt täcks av en kampanj kräver inget sparad kort. Stora batchbeställningar (omkring 150 artiklar) stöds.