AG fournit une API REST publique pour les commandes programmatiques — utile si vous construisez une vitrine, une automatisation ou une intégration qui doit passer des commandes AG sans utiliser le paiement web. L'accès à l'API est contrôlé par compte.
Activation de l'accès à l'API
L'accès à l'API est activé par les administrateurs d'AG selon les besoins du compte. Une fois activé, vous verrez la carte Clés API dans Paramètres.
Génération d'une clé API
- Ouvrez Paramètres et trouvez la carte Clés API.
- Cliquez sur Nouvelle clé, donnez-lui un Nom, puis cliquez sur Créer.
- Copiez le jeton
ag_live_...immédiatement — il ne s'affiche qu'une seule fois. - Stockez-le de manière sécurisée (gestionnaire de secrets ou fichier
.env).
Ce que vous pouvez faire avec l'API
- Obtenir des devis sur les tarifs et les options de livraison avant de passer une commande.
- Passer des commandes avec configuration complète (papier, format, encadrement, montage, adresse de livraison).
- Gérer votre carte enregistrée — requise pour passer des commandes.
- Lister et récupérer les commandes passées via l'API.
Authentification
Transmettez le jeton en tant qu'en-tête Bearer à chaque requête :
Authorization: Bearer ag_live_...
Configuration requise
- Une carte enregistrée au dossier (voir Comment gérer vos cartes enregistrées) — les commandes API sont facturées automatiquement.
- Un pays de résidence défini sur le compte — détermine la devise et le routage de la succursale Stripe.
Idempotence
POST /v1/orders accepte un en-tête Idempotency-Key pour dédupliquer les tentatives en toute sécurité. Envoyez-en toujours un pour les intégrations en production.
Codes promotionnels via l'API
POST /v1/orders accepte un promo_code. Les codes sont validés — un code invalide rejette la commande plutôt que de facturer silencieusement le tarif complet — et une commande entièrement couverte par une promotion n'a pas besoin de carte enregistrée. Les commandes en lot important (environ 150 articles) sont acceptées.