Développeurs

API de la boutique de cartes-cadeaux Bidali

Une API JSON gratuite, en lecture seule, pour le catalogue de cartes-cadeaux de ce site : pays, catégories, devises et marques, avec les montants, les instructions d'utilisation et les conditions. Sans inscription ni clé d'API.

Démarrage rapide Spécification OpenAPI

Démarrage rapide

Vos premières requêtes

Chaque point de terminaison est une requête GET qui renvoie du JSON. Copiez une commande et exécutez-la.

Lister les pays où des cartes-cadeaux sont offertes

curl -s https://giftcards.bidali.com/api/v1/countries

Trouver des cartes-cadeaux d'épicerie au Canada

curl -s "https://giftcards.bidali.com/api/v1/countries/canada/brands?category=groceries&limit=5"

Obtenir une marque : montants, utilisation et conditions

curl -s https://giftcards.bidali.com/api/v1/countries/canada/brands/doordash-ca

Lire n'importe quelle page en Markdown

curl -s -H "Accept: text/markdown" https://giftcards.bidali.com/brands/canada/doordash-ca

Référence

Points de terminaison

Tous les chemins sont relatifs à https://giftcards.bidali.com. Le document OpenAPI décrit chaque paramètre et chaque réponse.

Points de terminaison
Chemin	Méthode	Ce qu'il renvoie
`/api/v1`	`GET`	Describe the Catalogue API
`/api/v1/countries`	`GET`	List the countries with gift cards
`/api/v1/categories`	`GET`	List the gift card categories
`/api/v1/currencies`	`GET`	List the currencies gift cards are priced in
`/api/v1/countries/{country}/brands`	`GET`	List the brands on sale in a country
`/api/v1/countries/{country}/brands/{brand}`	`GET`	Get one brand: amounts, redemption and terms
`/api/v1/openapi.json`	`GET`	Get this OpenAPI document as JSON
`/api/v1/openapi.yaml`	`GET`	Get this OpenAPI document as YAML

Lisible par machine

Tout ce qu'un agent peut lire

OpenAPI 3.1

/openapi.json et /openapi.yaml décrivent chaque point de terminaison, paramètre et réponse, pour les générateurs de SDK et les appels d'outils.

Pages en Markdown

Envoyez Accept: text/markdown à n'importe quelle page, ou ajoutez .md à son chemin (/index.md pour la page d'accueil), pour l'obtenir en Markdown.

llms.txt

/llms.txt présente la boutique en langage clair et indique quand l'utiliser.

Erreurs

Les erreurs sont en JSON, avec le statut HTTP qui convient : 400 pour un paramètre manquant ou invalide, 404 pour un pays, une marque ou un chemin inconnu, 405 pour toute méthode autre que GET, et 502 ou 504 quand le service du catalogue échoue. Le champ code ne change pas. Le champ hint indique quoi faire ensuite.

{
  "error": {
    "code": "country_not_found",
    "message": "No country matches \"atlantis\".",
    "hint": "Use a slug or an ISO 3166-1 alpha-2 code from GET /api/v1/countries.",
    "docs": "https://giftcards.bidali.com/developers#errors"
  }
}

Les réponses sont mises en cache jusqu'à cinq minutes. Une page contient au plus 100 marques : suivez pagination.next pour la suite.

Acheter par programmation

Achetez des cartes-cadeaux avec l'API cartes-cadeaux de Bidali

Cette API ne fait que lire le catalogue. Pour acheter des cartes-cadeaux depuis votre propre logiciel ou un agent IA, utilisez l'API cartes-cadeaux de Bidali. Elle fonctionne avec des clés d'API et est en accès anticipé.

L'accès MCP arrive bientôt.

Lire la documentation API cartes-cadeaux Parler aux ventes

Questions des développeurs

Ai-je besoin d'une clé d'API ?

Pas pour l'API du catalogue de ce site : elle est publique et en lecture seule. L'API cartes-cadeaux de Bidali, qui passe les commandes, utilise des clés d'API.

Puis-je acheter une carte-cadeau avec cette API ?

Non, elle ne fait que lire le catalogue. Envoyez la personne vers la page de la marque sur ce site (links.page dans chaque réponse) pour l'acheter, ou utilisez l'API cartes-cadeaux de Bidali pour acheter par programmation.

Y a-t-il une limite de requêtes ?

Aucune limite n'est publiée. Les réponses sont mises en cache quelques minutes : récupérez une liste une fois et réutilisez-la.

Y a-t-il un serveur MCP ?