# 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.

## 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

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

Trouver des cartes-cadeaux d'épicerie au Canada

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

Obtenir une marque : montants, utilisation et conditions

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

Lire n'importe quelle page en Markdown

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

## Points de terminaison

- `GET /api/v1`: Describe the Catalogue API
- `GET /api/v1/countries`: List the countries with gift cards
- `GET /api/v1/categories`: List the gift card categories
- `GET /api/v1/currencies`: List the currencies gift cards are priced in
- `GET /api/v1/countries/{country}/brands`: List the brands on sale in a country
- `GET /api/v1/countries/{country}/brands/{brand}`: Get one brand: amounts, redemption and terms
- `GET /api/v1/openapi.json`: Get this OpenAPI document as JSON
- `GET /api/v1/openapi.yaml`: Get this OpenAPI document as YAML

## Tout ce qu'un agent peut lire

- OpenAPI 3.1: https://giftcards.bidali.com/openapi.json · https://giftcards.bidali.com/openapi.yaml
- Markdown: `Accept: text/markdown`, or https://giftcards.bidali.com/index.md
- llms.txt: https://giftcards.bidali.com/llms.txt
- Sitemap: https://giftcards.bidali.com/sitemap.xml

## 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.

```json
{ "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.

## 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é.

- Lire la documentation: https://docs.bidali.com
- API cartes-cadeaux: https://www.bidali.com/products/gift-card-api
- Parler aux ventes: https://www.bidali.com/contact?intent=sales

L'accès MCP arrive bientôt.

## Other formats

- HTML page: https://giftcards.bidali.com/fr/developers
- This page as Markdown: https://giftcards.bidali.com/fr/developers.md
- Same data as JSON (Catalogue API): https://giftcards.bidali.com/api/v1
- Guide to this store for AI agents: https://giftcards.bidali.com/llms.txt
- Catalogue API reference (OpenAPI 3.1): https://giftcards.bidali.com/openapi.json

## Languages

[English](https://giftcards.bidali.com/developers.md) · [Español](https://giftcards.bidali.com/es/developers.md) · [Português](https://giftcards.bidali.com/pt/developers.md) · [Français](https://giftcards.bidali.com/fr/developers.md) · [Deutsch](https://giftcards.bidali.com/de/developers.md) · [Italiano](https://giftcards.bidali.com/it/developers.md) · [Polski](https://giftcards.bidali.com/pl/developers.md) · [Svenska](https://giftcards.bidali.com/sv/developers.md)