# API del negozio di gift card Bidali

> Un'API JSON gratuita e in sola lettura per il catalogo di gift card di questo sito: paesi, categorie, valute e marchi, con importi, istruzioni di utilizzo e condizioni. Senza registrazione e senza chiave API.

## Le tue prime richieste

Ogni endpoint è una richiesta GET che restituisce JSON. Copia un comando ed eseguilo.

Elenca i paesi con gift card

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

Trova gift card per la spesa in Canada

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

Ottieni un marchio: importi, utilizzo e condizioni

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

Leggi qualsiasi pagina in Markdown

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

## Endpoint

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

## Tutto ciò che un agente può leggere

- 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

## Errori

Gli errori sono in JSON, con lo stato HTTP appropriato: 400 per un parametro mancante o non valido, 404 per un paese, un marchio o un percorso sconosciuto, 405 per qualsiasi metodo diverso da GET, e 502 o 504 quando il servizio del catalogo non risponde. Il campo code non cambia; il campo hint indica cosa fare dopo.

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

Le risposte restano in cache fino a cinque minuti. Una pagina contiene al massimo 100 marchi: segui pagination.next per il resto.

## Acquista gift card con la Gift Card API di Bidali

Questa API legge solo il catalogo. Per acquistare gift card dal tuo software o da un agente AI, usa la Gift Card API di Bidali. Funziona con chiavi API ed è in accesso anticipato.

- Leggi la documentazione: https://docs.bidali.com
- Gift Card API: https://www.bidali.com/products/gift-card-api
- Contatta il team commerciale: https://www.bidali.com/contact?intent=sales

L'accesso tramite MCP è in arrivo.

## Other formats

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