AG proporciona una API REST pública para realizar pedidos mediante programación — útil si estás construyendo una tienda en línea, automatización o integración que necesita hacer pedidos en AG sin usar el checkout web. El acceso a la API está limitado por cuenta.
Habilitar el acceso a la API
El acceso a la API es habilitado por los administradores de AG según la cuenta. Una vez habilitado, verás la tarjeta API Keys en Settings.
Generar una clave API
- Abre Settings y busca la tarjeta API Keys.
- Haz clic en New key, asigna un Name y haz clic en Create.
- Copia el token
ag_live_...inmediatamente — se muestra solo una vez. - Guárdalo de forma segura (en un gestor de secretos o archivo
.env).
Qué puedes hacer con la API
- Consultar precios y opciones de entrega antes de hacer un pedido.
- Hacer pedidos con configuración completa (papel, tamaño, marco, montaje, dirección de entrega).
- Gestionar tu tarjeta guardada — obligatorio para hacer pedidos.
- Listar y recuperar pedidos realizados a través de la API.
Autenticación
Envía el token como encabezado Bearer en cada solicitud:
Authorization: Bearer ag_live_...
Configuración requerida
- Una tarjeta guardada en archivo (consulta How to manage saved cards) — los pedidos por API se cobran automáticamente.
- Un país de residencia establecido en la cuenta — determina la moneda y el enrutamiento de la rama de Stripe.
Idempotencia
POST /v1/orders acepta un encabezado Idempotency-Key para deduplicar reintentos de forma segura. Siempre envía uno para integraciones en producción.
Códigos promocionales a través de la API
POST /v1/orders acepta un promo_code. Los códigos se validan — un código inválido rechaza el pedido en lugar de cobrar el precio completo silenciosamente — y un pedido totalmente cubierto por una promoción no necesita tarjeta guardada. Se admiten pedidos en lote grandes (alrededor de 150 artículos).