AG tarjoaa julkisen REST-sovellusliittymän ohjelmalliseen tilaamiseen — hyödyllinen, jos rakennat verkkokauppaa, automatisointi- tai integraatioratkaisua, joka joutuu tekemään AG-tilauksia ilman verkkokassaa. API-käyttö on sidottu tiliin.
API-käytön aktivointi
AG-ylläpitäjät aktivoivat API-käytön tiliin liittyen. Kun se on aktivoitu, näet API Keys -kortin Settings-osiossa.
API-avaimen luominen
- Avaa Settings ja etsi API Keys -kortti.
- Napsauta New key, anna sille Name ja napsauta Create.
- Kopioi
ag_live_...-tunnus heti — se näytetään vain kerran. - Tallenna se turvallisesti (secrets manager- tai
.env-tiedostoon).
Mitä voit tehdä API:n avulla
- Hintaa ja toimitusvaihtoehtoja — voit tarkistaa ne ennen tilauksen tekemistä.
- Tehdä tilauksia täydellä konfiguraatiolla (paperi, koko, kehys, kiinnitys, toimitusosoite).
- Hallita tallennettua korttia — vaaditaan tilausten tekemiseen.
- Listata ja hakea tilauksia, jotka on tehty API:n kautta.
Todennus
Lähetä tunnus Bearer-otsakkona jokaisella pyynnöllä:
Authorization: Bearer ag_live_...
Vaadittu asetus
- Tallennettu kortti tilillä (katso How to manage saved cards) — API-tilaukset veloitetaan automaattisesti.
- Asuinmaa asetettuna tilille — määrää valuutan ja Stripe-haaran reitityksen.
Idempotenssi
POST /v1/orders hyväksyy Idempotency-Key -otsakkeen uudelleenyritysyhtälöiden turvalliseen poistamiseen. Lähetä se aina tuotantointegraatioissa.
Promokoodit API:n kautta
POST /v1/orders hyväksyy promo_code-parametrin. Koodit vahvistetaan — virheellinen koodi hylkää tilauksen sen sijaan, että veloitettaisiin täysi hinta hiljaa — ja promo-koodilla täysin katettu tilaus ei vaadi tallennettua korttia. Tuetaan myös suurempia joukkotilauksia (noin 150 nimikettä).