Desarrolladores

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.

Inicio rápidoEspecificación OpenAPI

Inicio rápido

Tus primeras solicitudes

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

  1. Lista los países con tarjetas de regalo

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

  2. Busca tarjetas de regalo de supermercados en Canadá

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

  3. Consulta una marca: montos, canje y condiciones

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

  4. Lee cualquier página en Markdown

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

Referencia

Endpoints

Todas las rutas son relativas a https://giftcards.bidali.com. El documento OpenAPI describe cada parámetro y cada respuesta.

Endpoints
RutaMétodoQué devuelve
/api/v1GETDescribe the Catalogue API
/api/v1/countriesGETList the countries with gift cards
/api/v1/categoriesGETList the gift card categories
/api/v1/currenciesGETList the currencies gift cards are priced in
/api/v1/countries/{country}/brandsGETList the brands on sale in a country
/api/v1/countries/{country}/brands/{brand}GETGet one brand: amounts, redemption and terms
/api/v1/openapi.jsonGETGet this OpenAPI document as JSON
/api/v1/openapi.yamlGETGet this OpenAPI document as YAML

Legible por máquinas

Todo lo que un agente puede leer

OpenAPI 3.1

/openapi.json y /openapi.yaml describen cada endpoint, parámetro y respuesta, para generadores de SDK y llamadas a herramientas.

Páginas en Markdown

Envía Accept: text/markdown a cualquier página, o añade .md a su ruta (/index.md para la página de inicio), para obtenerla en Markdown.

llms.txt

/llms.txt explica la tienda en lenguaje sencillo y cuándo conviene usarla.

Mapa del sitio

/sitemap.xml enumera todas las páginas, con su dirección en cada idioma.

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.

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

Comprar desde código

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.

El acceso por MCP llegará pronto.

Leer la documentaciónGift Card APIHablar con ventas

Preguntas de desarrolladores

¿Necesito una clave de API?

No para la API del catálogo de este sitio: es pública y de solo lectura. La Bidali Gift Card API, que realiza pedidos, usa claves de API.

¿Puedo comprar una tarjeta de regalo con esta API?

No, solo lee el catálogo. Envía a la persona a la página de la marca en este sitio (links.page en cada respuesta) para que la compre, o usa la Bidali Gift Card API para comprar desde código.

¿Hay un límite de solicitudes?

No hay un límite publicado. Las respuestas se guardan en caché unos minutos, así que obtén una lista una vez y reutilízala.

¿Hay un servidor MCP?

El acceso por MCP llegará pronto.