Per gli agenti AI e per chi li sviluppa
Gift card per agenti AI
Bidali vende gift card di 4700+ marchi in 100+ paesi. Questa pagina spiega come un agente può leggere il catalogo di questo sito e come può acquistare tramite l'API di Bidali.
Su questo sito
Cosa può fare un agente qui, oggi
Il catalogo è pubblico e si può leggere senza un account.
Sfogliare il catalogo
Ogni paese, categoria, valuta e marchio ha la propria pagina a un URL stabile. Le pagine sono generate sul server, quindi il contenuto è nell'HTML.
Partire dai file del sito
/llms.txt descrive il sito in linguaggio semplice. /sitemap.xml elenca tutte le pagine destinate ai motori di ricerca e agli agenti.
Leggere i dati strutturati
Ogni pagina di marchio contiene dati Product di schema.org con gli importi della gift card e la valuta in cui sono espressi.
Verificare paese e valuta
Una gift card è elencata sotto il paese a cui è destinata e ha un prezzo in una sola valuta. Controlla entrambi prima di consigliarne o acquistarne una.
Acquisti
Dai agli agenti un budget, non un numero di carta
Gli agenti acquistano tramite la Gift Card API di Bidali con un budget definito dall'azienda. Una gift card vale presso un solo marchio e per un importo prestabilito, quindi un errore o un prompt manomesso può spendere solo quanto consentito.
1. L'azienda definisce il budget
Carica un saldo prepagato. L'agente può spendere quel saldo e nient'altro.
2. L'agente chiede un preventivo
Invia marchio, importo e valuta e riceve un prezzo prima di impegnarsi.
3. L'agente effettua l'ordine
L'ordine viene creato a partire dal preventivo e pagato con il saldo prepagato.
4. La gift card viene consegnata
La gift card arriva all'agente o alla persona per cui sta acquistando.
- La Gift Card API è in accesso anticipato, quindi i dettagli possono cambiare. Fa fede la documentazione.
- L'accesso tramite MCP è in arrivo.
- Il checkout di questo sito è pensato per le persone. Per gli acquisti automatizzati, usa l'API.
Riferimento
Schemi di URL
Tutti i percorsi sono relativi a https://giftcards.bidali.com. Gli slug sono in minuscolo e usano i trattini.
| Schema | Cosa ottieni | Esempio |
|---|---|---|
/buy/{country} | Tutte le gift card di un paese. | /buy/germany |
/buy/{country}/{category} | Le gift card di un paese in una categoria. | /buy/germany/groceries |
/brands/{country} | I marchi popolari in un paese. | /brands/germany |
/brands/{country}/{brand} | Un marchio in un paese: importi, valuta e modalità di riscatto. | /brands/germany/123-blumenversand-de |
/shop/{category} | Una categoria, con i marchi del paese del visitatore. Usa lo schema con il paese quando il paese è rilevante. | /shop/groceries |
/currency/{code} | Gift card con prezzo in una valuta. Il codice è un codice ISO 4217 in minuscolo. | /currency/eur |
/currency | Tutte le valute in cui sono espresse le gift card. | /currency |
/countries | Tutti i paesi per cui sono disponibili gift card. | /countries |
Per un'altra lingua, metti il suo codice davanti al percorso: /es, /pt, /fr, /de, /it, /pl, /sv. L'inglese non ha prefisso.
Domande di chi sviluppa agenti
Un agente AI può acquistare una gift card da solo?
Sì, tramite la Gift Card API di Bidali, che è in accesso anticipato. Un agente può chiedere un preventivo, effettuare un ordine e ricevere la gift card, sempre entro il budget definito dall'azienda.
Perché dare a un agente delle gift card invece di un numero di carta?
Una gift card vale presso un solo marchio e per un importo prestabilito. Se un agente sbaglia o viene ingannato da un prompt, può spendere solo quello che gli è stato dato.
Esiste un server MCP?
L'accesso tramite MCP è in arrivo.
Dove si trova la documentazione dell'API?
All'indirizzo docs.bidali.com. La pagina della Gift Card API, bidali.com/products/gift-card-api, elenca gli endpoint e contiene il modulo per l'accesso anticipato.
Come fa un agente a trovare le gift card per un paese o una valuta?
Usa /buy/{country} per un paese e /currency/{code} per una valuta. /countries e /currency elencano tutte le opzioni.
Un agente AI l'ha già fatto?
Sì. A marzo 2026 Beppe, un agente autonomo sviluppato da Treasure, ha acquistato una gift card Bidali, l'ha usata per ordinare del cibo e lo ha fatto consegnare a un banco alimentare.
Dai al tuo agente un budget, non un numero di carta
Raccontaci cosa stai sviluppando e ti aiuteremo a configurarlo.