Dla agentów AI i osób, które je tworzą
Karty podarunkowe dla agentów AI
Bidali sprzedaje karty podarunkowe 4700+ marek w 100+ krajach. Ta strona wyjaśnia, jak agent może czytać katalog w tym serwisie i jak może kupować przez API Bidali.
W tym serwisie
Co agent może tu zrobić już dziś
Katalog jest publiczny i można go czytać bez konta.
Przeglądaj katalog
Każdy kraj, kategoria, waluta i marka ma własną stronę pod stałym adresem URL. Strony są renderowane na serwerze, więc treść znajduje się w kodzie HTML.
Zacznij od plików serwisu
/llms.txt opisuje serwis prostym językiem. /sitemap.xml zawiera listę wszystkich stron przeznaczonych dla wyszukiwarek i agentów.
Czytaj dane strukturalne
Każda strona marki zawiera dane schema.org Product z kwotami kart podarunkowych i walutą, w której są wycenione.
Dopasuj kraj i walutę
Karta podarunkowa jest przypisana do kraju, dla którego jest przeznaczona, i wyceniona w jednej walucie. Sprawdź jedno i drugie, zanim ją polecisz lub kupisz.
Zakupy
Daj agentom budżet, a nie numer karty płatniczej
Agenci kupują przez Bidali Gift Card API w ramach budżetu ustalonego przez firmę. Karta podarunkowa działa u jednej marki i ma określoną kwotę, więc pomyłka albo przejęty prompt mogą wydać tylko tyle, na ile pozwolono.
1. Firma ustala budżet
Zasila saldo przedpłacone. Agent może wydać to saldo i nic więcej.
2. Agent prosi o wycenę
Wysyła markę, kwotę i walutę i dostaje cenę, zanim złoży zamówienie.
3. Agent składa zamówienie
Zamówienie powstaje na podstawie wyceny i jest opłacane z salda przedpłaconego.
4. Karta podarunkowa zostaje dostarczona
Kartę podarunkową otrzymuje agent albo osoba, dla której kupuje.
- Gift Card API jest w fazie wczesnego dostępu, więc szczegóły mogą się zmienić. Punktem odniesienia jest dokumentacja.
- Dostęp przez MCP pojawi się wkrótce.
- Kasa w tym serwisie jest przeznaczona dla ludzi. Do zakupów automatycznych używaj API.
Informacje techniczne
Wzorce adresów URL
Wszystkie ścieżki są względne wobec https://giftcards.bidali.com. Slugi są pisane małymi literami i z łącznikami.
| Wzorzec | Co otrzymujesz | Przykład |
|---|---|---|
/buy/{country} | Wszystkie karty podarunkowe dla jednego kraju. | /buy/germany |
/buy/{country}/{category} | Karty podarunkowe dla jednego kraju w jednej kategorii. | /buy/germany/groceries |
/brands/{country} | Popularne marki w jednym kraju. | /brands/germany |
/brands/{country}/{brand} | Jedna marka w jednym kraju: kwoty, waluta i sposób realizacji. | /brands/germany/123-blumenversand-de |
/shop/{category} | Jedna kategoria z markami dla kraju odwiedzającego. Gdy kraj ma znaczenie, użyj wzorca z krajem. | /shop/groceries |
/currency/{code} | Karty podarunkowe wycenione w jednej walucie. Kod to kod ISO 4217 pisany małymi literami. | /currency/eur |
/currency | Wszystkie waluty, w których wyceniane są karty podarunkowe. | /currency |
/countries | Wszystkie kraje, dla których dostępne są karty podarunkowe. | /countries |
Aby użyć innego języka, wstaw jego kod przed ścieżką: /es, /pt, /fr, /de, /it, /pl, /sv. Angielski nie ma prefiksu.
Pytania od twórców agentów
Czy agent AI może samodzielnie kupić kartę podarunkową?
Tak, przez Bidali Gift Card API, które jest w fazie wczesnego dostępu. Agent może poprosić o wycenę, złożyć zamówienie i otrzymać kartę podarunkową – wszystko w ramach budżetu ustalonego przez firmę.
Dlaczego dawać agentowi karty podarunkowe zamiast numeru karty płatniczej?
Karta podarunkowa działa u jednej marki i ma określoną kwotę. Jeśli agent popełni błąd albo da się zmanipulować promptem, może wydać tylko tyle, ile dostał.
Czy jest serwer MCP?
Dostęp przez MCP pojawi się wkrótce.
Gdzie jest dokumentacja API?
Pod adresem docs.bidali.com. Strona Gift Card API pod adresem bidali.com/products/gift-card-api zawiera listę endpointów i formularz wczesnego dostępu.
Jak agent znajdzie karty podarunkowe dla danego kraju lub waluty?
Użyj /buy/{country} dla kraju i /currency/{code} dla waluty. /countries i /currency zawierają listę wszystkich opcji.
Czy jakiś agent AI już to zrobił?
Tak. W marcu 2026 r. Beppe, autonomiczny agent stworzony przez Treasure, kupił kartę podarunkową Bidali, zamówił za nią jedzenie i zlecił jego dostawę do banku żywności.
Daj swojemu agentowi budżet, a nie numer karty płatniczej
Napisz, co budujesz, a pomożemy Ci to skonfigurować.