AG bietet eine öffentliche REST-API für programmgesteuerte Bestellungen — ideal, wenn du einen Shop, eine Automatisierung oder Integration aufbaust, die AG-Bestellungen ohne Webkasse aufgeben muss. Der API-Zugang wird pro Konto gesteuert.
API-Zugang aktivieren
Der API-Zugang wird von AG-Administratoren pro Konto aktiviert. Sobald aktiviert, siehst du die Karte API Keys in Settings.
API-Schlüssel generieren
- Öffne Settings und suche die Karte API Keys.
- Klicke auf New key, gib einen Namen ein und klicke auf Create.
- Kopiere das Token
ag_live_...sofort — es wird nur einmal angezeigt. - Speichere es sicher (in einem Secrets Manager oder einer
.env-Datei).
Was du mit der API machen kannst
- Preise und Lieferoptionen abfragen, bevor du eine Bestellung aufgibst.
- Bestellungen aufgeben mit vollständiger Konfiguration (Papier, Größe, Rahmung, Montage, Lieferadresse).
- Deine gespeicherte Karte verwalten — erforderlich für API-Bestellungen.
- Bestellungen auflisten und abrufen, die über die API aufgegeben wurden.
Authentifizierung
Übergib das Token als Bearer-Header bei jeder Anfrage:
Authorization: Bearer ag_live_...
Erforderliches Setup
- Eine gespeicherte Karte auf dem Konto (siehe How to manage saved cards) — API-Bestellungen werden automatisch belastet.
- Ein Land des Wohnsitzes, das auf dem Konto eingestellt ist — bestimmt Währung und Stripe-Weiterleitungsrouting.
Idempotenz
POST /v1/orders akzeptiert einen Idempotency-Key-Header, um Wiederholungen sicher zu deduplizieren. Sende diesen immer für Produktionsintegrationen.
Promocodes über die API
POST /v1/orders akzeptiert einen promo_code. Codes werden validiert — ein ungültiger Code lehnt die Bestellung ab, statt stillschweigend den vollen Preis zu berechnen — und eine Bestellung, die vollständig durch einen Promo abgedeckt ist, benötigt keine gespeicherte Karte. Große Sammelbestellungen (etwa 150 Artikel) werden unterstützt.