Sviluppatori
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.
Guida rapida
Le tue prime richieste
Ogni endpoint è una richiesta GET che restituisce JSON. Copia un comando ed eseguilo.
Elenca i paesi con gift card
curl -s https://giftcards.bidali.com/api/v1/countriesTrova gift card per la spesa in Canada
curl -s "https://giftcards.bidali.com/api/v1/countries/canada/brands?category=groceries&limit=5"Ottieni un marchio: importi, utilizzo e condizioni
curl -s https://giftcards.bidali.com/api/v1/countries/canada/brands/doordash-caLeggi qualsiasi pagina in Markdown
curl -s -H "Accept: text/markdown" https://giftcards.bidali.com/brands/canada/doordash-ca
Riferimento
Endpoint
Tutti i percorsi sono relativi a https://giftcards.bidali.com. Il documento OpenAPI descrive ogni parametro e ogni risposta.
| Percorso | Metodo | Cosa restituisce |
|---|---|---|
/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 |
Leggibile dalle macchine
Tutto ciò che un agente può leggere
OpenAPI 3.1
/openapi.json e /openapi.yaml descrivono ogni endpoint, parametro e risposta, per i generatori di SDK e le chiamate a strumenti.
Pagine in Markdown
Invia Accept: text/markdown a qualsiasi pagina, oppure aggiungi .md al suo percorso (/index.md per la home page), per riceverla in Markdown.
llms.txt
/llms.txt descrive il negozio in linguaggio semplice e spiega quando usarlo.
Mappa del sito
/sitemap.xml elenca tutte le pagine, con il loro indirizzo in ogni lingua.
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.
{
"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.
Acquistare via codice
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.
L'accesso tramite MCP è in arrivo.
Domande degli sviluppatori
Mi serve una chiave API?
Non per l'API del catalogo di questo sito: è pubblica e in sola lettura. La Gift Card API di Bidali, che effettua gli ordini, usa chiavi API.
Posso acquistare una gift card con questa API?
No, legge solo il catalogo. Indirizza la persona alla pagina del marchio su questo sito (links.page in ogni risposta) per acquistarla, oppure usa la Gift Card API di Bidali per acquistare via codice.
C'è un limite di richieste?
Non c'è un limite pubblicato. Le risposte restano in cache per alcuni minuti, quindi scarica un elenco una volta e riutilizzalo.
Esiste un server MCP?
L'accesso tramite MCP è in arrivo.