Pour les agents IA et les personnes qui les conçoivent
Cartes-cadeaux pour les agents IA
Bidali vend des cartes-cadeaux de 4 700+ marques dans 100+ pays. Cette page explique comment un agent peut lire le catalogue de ce site et comment il peut acheter au moyen de l'API Bidali.
Sur ce site
Ce qu'un agent peut faire ici dès aujourd'hui
Le catalogue est public et lisible sans compte.
Parcourir le catalogue
Chaque pays, catégorie, devise et marque a sa propre page à une URL stable. Les pages sont rendues côté serveur : le contenu se trouve donc dans le HTML.
Commencer par les fichiers du site
/llms.txt décrit le site en langage clair. /sitemap.xml répertorie toutes les pages destinées aux moteurs de recherche et aux agents.
Lire les données structurées
Chaque page de marque contient des données schema.org Product indiquant les montants de la carte-cadeau et la devise dans laquelle ils sont exprimés.
Faire correspondre le pays et la devise
Une carte-cadeau est classée sous le pays auquel elle est destinée et son prix est dans une seule devise. Vérifiez les deux avant d'en recommander ou d'en acheter une.
Achats
Donnez un budget aux agents, pas un numéro de carte
Les agents achètent au moyen de l'API cartes-cadeaux de Bidali, avec un budget fixé par l'entreprise. Une carte-cadeau fonctionne auprès d'une seule marque, pour un montant défini : une erreur ou un prompt détourné ne peut donc dépenser que ce qui a été autorisé.
1. L'entreprise fixe le budget
Elle alimente un solde prépayé. L'agent peut dépenser ce solde, et rien de plus.
2. L'agent demande un prix
Il envoie la marque, le montant et la devise, puis reçoit un prix avant de s'engager.
3. L'agent passe la commande
La commande est créée à partir de ce prix et payée avec le solde prépayé.
4. La carte-cadeau est livrée
L'agent, ou la personne pour qui il achète, reçoit la carte-cadeau.
- L'API cartes-cadeaux est en accès anticipé : des détails peuvent changer. La documentation fait foi.
- L'accès MCP arrive bientôt.
- La caisse de ce site est conçue pour les personnes. Pour les achats automatisés, utilisez l'API.
Référence
Modèles d'URL
Tous les chemins sont relatifs à https://giftcards.bidali.com. Les slugs sont en minuscules et utilisent des traits d'union.
| Modèle | Ce que vous obtenez | Exemple |
|---|---|---|
/buy/{country} | Toutes les cartes-cadeaux pour un pays. | /buy/germany |
/buy/{country}/{category} | Les cartes-cadeaux d'une catégorie pour un pays. | /buy/germany/groceries |
/brands/{country} | Les marques populaires dans un pays. | /brands/germany |
/brands/{country}/{brand} | Une marque dans un pays : montants, devise et mode d'utilisation. | /brands/germany/123-blumenversand-de |
/shop/{category} | Une catégorie, avec les marques du pays du visiteur. Utilisez le modèle par pays lorsque le pays compte. | /shop/groceries |
/currency/{code} | Les cartes-cadeaux dont le prix est dans une devise donnée. Le code est un code ISO 4217 en minuscules. | /currency/eur |
/currency | Toutes les devises dans lesquelles des cartes-cadeaux sont proposées. | /currency |
/countries | Tous les pays pour lesquels des cartes-cadeaux sont disponibles. | /countries |
Pour une autre langue, placez son code devant le chemin : /es, /pt, /fr, /de, /it, /pl, /sv. L'anglais n'a pas de préfixe.
Questions des concepteurs d'agents
Un agent IA peut-il acheter une carte-cadeau de façon autonome ?
Oui, au moyen de l'API cartes-cadeaux de Bidali, qui est en accès anticipé. Un agent peut demander un prix, passer une commande et recevoir la carte-cadeau, le tout dans les limites du budget fixé par l'entreprise.
Pourquoi donner des cartes-cadeaux à un agent plutôt qu'un numéro de carte ?
Une carte-cadeau fonctionne auprès d'une seule marque, pour un montant défini. Si un agent commet une erreur ou se fait piéger par un prompt, il ne peut dépenser que ce qu'on lui a donné.
Existe-t-il un serveur MCP ?
L'accès MCP arrive bientôt.
Où se trouve la documentation de l'API ?
À l'adresse docs.bidali.com. La page de l'API cartes-cadeaux, à l'adresse bidali.com/products/gift-card-api, présente les points de terminaison et contient le formulaire d'accès anticipé.
Comment un agent trouve-t-il des cartes-cadeaux pour un pays ou une devise ?
Utilisez /buy/{country} pour un pays et /currency/{code} pour une devise. /countries et /currency répertorient toutes les options.
Un agent IA l'a-t-il déjà fait ?
Oui. En mars 2026, Beppe, un agent autonome conçu par Treasure, a acheté une carte-cadeau Bidali, s'en est servi pour commander de la nourriture et a fait livrer celle-ci à une banque alimentaire.
Donnez un budget à votre agent, pas un numéro de carte
Dites-nous ce que vous construisez et nous vous aiderons à le mettre en place.