# API de la tienda de tarjetas de regalo de Bidali

> Una API JSON gratuita y de solo lectura para el catálogo de tarjetas de regalo de este sitio: países, categorías, divisas y marcas, con montos, instrucciones de canje y condiciones. Sin registro y sin clave de API.

## Tus primeras solicitudes

Cada endpoint es una solicitud GET que devuelve JSON. Copia un comando y ejecútalo.

Lista los países con tarjetas de regalo

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

Busca tarjetas de regalo de supermercados en Canadá

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

Consulta una marca: montos, canje y condiciones

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

Lee cualquier página en Markdown

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

## Endpoints

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

## Todo lo que un agente puede leer

- 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

## Errores

Los errores son JSON, con el estado HTTP que corresponde: 400 si falta un parámetro o no es válido, 404 si el país, la marca o la ruta no existen, 405 para cualquier método que no sea GET, y 502 o 504 cuando falla el servicio del catálogo. El campo code no cambia; el campo hint indica qué hacer a continuación.

```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" } }
```

Las respuestas se guardan en caché hasta cinco minutos. Una página contiene como máximo 100 marcas: sigue pagination.next para ver el resto.

## Compra tarjetas de regalo con la Bidali Gift Card API

Esta API solo lee el catálogo. Para comprar tarjetas de regalo desde tu propio software o un agente de IA, usa la Bidali Gift Card API. Funciona con claves de API y está en acceso anticipado.

- Leer la documentación: https://docs.bidali.com
- Gift Card API: https://www.bidali.com/products/gift-card-api
- Hablar con ventas: https://www.bidali.com/contact?intent=sales

El acceso por MCP llegará pronto.

## Other formats

- HTML page: https://giftcards.bidali.com/es/developers
- This page as Markdown: https://giftcards.bidali.com/es/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)