AG tilbyr et offentlig REST API for programmerte bestillinger — praktisk hvis du bygger en nettbutikk, automatisering eller integrasjon som trenger å legge inn AG-bestillinger uten å bruke nettkassen. API-tilgang styres per konto.
Aktivere API-tilgang
API-tilgang aktiveres av AG-administratorer på per-konto-basis. Når det er aktivert, vil du se API Keys-kortet i Settings.
Generere en API-nøkkel
- Åpne Settings og finn API Keys-kortet.
- Klikk New key, gi den et Name, og klikk Create.
- Kopier
ag_live_...-tokenet umiddelbart — det vises bare én gang. - Lagre det sikkert (en secrets manager eller
.env-fil).
Hva du kan gjøre med APIet
- Quote priser og leveringsalternativer før du legger inn en bestilling.
- Plasser bestillinger med full konfigurering (papir, størrelse, ramme, montering, leveringsadresse).
- Administrer ditt lagrede kort — påkrevd for å legge inn bestillinger.
- List og hent bestillinger som ble lagt inn via APIet.
Autentisering
Send tokenet som en Bearer-header på hver forespørsel:
Authorization: Bearer ag_live_...
Påkrevd oppsett
- Et lagret kort på fil (se How to manage saved cards) — API-bestillinger blir belastet automatisk.
- Et country of residence satt på kontoen — styrer valuta og Stripe-greinruting.
Idempotens
POST /v1/orders godtar en Idempotency-Key-header for å deduplisere nye forsøk på en sikker måte. Send alltid en for produksjonsintegrasjoner.
Kampanjekoder via APIet
POST /v1/orders godtar en promo_code. Koder blir validert — en ugyldig kode avviser bestillingen i stedet for å stille kostnaden automatisk — og en bestilling som er fullstendig dekket av en kampanjekode krever ikke et lagret kort. Store batchbestillinger (rundt 150 artikler) støttes.