AG stiller et offentligt REST API til rådighed for programmatisk bestilling — praktisk hvis du bygger en webshop, automatisering eller integration, der skal placere AG-ordrer uden at bruge webcheckout. API-adgang styres pr. konto.
Aktivering af API-adgang
API-adgang aktiveres af AG-administratorer pr. konto. Når adgangen er aktiveret, vil du se kortet API Keys i Settings.
Generering af en API-nøgle
- Åbn Settings og find kortet API Keys.
- Klik på New key, giv den et Name, og klik Create.
- Kopier
ag_live_...-tokenet med det samme — det vises kun én gang. - Gem det sikkert (i en secrets manager eller
.env-fil).
Hvad du kan gøre med API'et
- Få prisoverslag og leveringsmuligheder inden du placerer en ordre.
- Placere ordrer med fuld konfiguration (papir, størrelse, ramme, montering, leveringsadresse).
- Administrere dit gemte kort — krævet for at placere ordrer.
- Liste og hent ordrer placeret via API'et.
Godkendelse
Send tokenet som en Bearer-header på hver forespørgsel:
Authorization: Bearer ag_live_...
Påkrævet opsætning
- Et gemtort kort på filen (se How to manage saved cards) — API-ordrer debiteres automatisk.
- Et country of residence sat på kontoen — bestemmer valuta og Stripe-rutning.
Idempotens
POST /v1/orders accepterer en Idempotency-Key-header til sikker deduplicering af nye forsøg. Send altid en til produktionsintegrationer.
Promokoder via API'et
POST /v1/orders accepterer en promo_code. Koder valideres — en ugyldig kode forkaster ordren i stedet for at debitere stiltiende fuld pris — og en ordre fuldt dækket af en promo kræver intet gemtort kort. Større batchordrer (omkring 150 varer) understøttes.