AG udostępnia publiczne REST API do programowego składania zamówień — przydatne, jeśli budujesz sklep internetowy, automatyzację lub integrację, która musi realizować zamówienia AG bez korzystania z formularza płatności online. Dostęp do API jest kontrolowany na poziomie konta.
Włączanie dostępu do API
Dostęp do API jest włączany przez administratorów AG dla każdego konta z osobna. Po włączeniu zobaczysz kartę API Keys w sekcji Settings.
Generowanie klucza API
- Otwórz Settings i znajdź kartę API Keys.
- Kliknij New key, wpisz Name (nazwę) i kliknij Create.
- Natychmiast skopiuj token
ag_live_...— jest wyświetlany tylko raz. - Przechowuj go bezpiecznie (w menedżerze haseł lub pliku
.env).
Co możesz zrobić za pomocą API
- Pobrać ofertę cenową i opcje dostaw przed złożeniem zamówienia.
- Złożyć zamówienia z pełną konfiguracją (papier, rozmiar, rama, montaż, adres dostawy).
- Zarządzać zapisaną kartą — wymagane do składania zamówień.
- Wyświetlać i pobierać zamówienia złożone za pośrednictwem API.
Uwierzytelnianie
Przekaż token jako nagłówek Bearer w każdym żądaniu:
Authorization: Bearer ag_live_...
Wymagana konfiguracja
- Zapisana karta na koncie (zobacz Jak zarządzać zapisanymi kartami) — zamówienia złożone przez API są obciążane automatycznie.
- Kraj zamieszkania ustawiony na koncie — określa walutę i routing oddziału Stripe.
Idempotencja
POST /v1/orders akceptuje nagłówek Idempotency-Key do bezpiecznego usuwania duplikatów przy ponowionych próbach. Zawsze wyślij go w przypadku integracji produkcyjnych.
Kody promocyjne za pośrednictwem API
POST /v1/orders akceptuje promo_code. Kody są weryfikowane — nieprawidłowy kod powoduje odrzucenie zamówienia zamiast cichego naliczenia pełnej ceny — a zamówienie w całości pokryte kodem promocyjnym nie wymaga zapisanej karty. Obsługiwane są duże zamówienia hurtowe (około 150 pozycji).