Dla programistów
API sklepu z kartami podarunkowymi Bidali
Bezpłatne API JSON tylko do odczytu dla katalogu kart podarunkowych w tym serwisie: kraje, kategorie, waluty i marki, z kwotami, instrukcjami realizacji i warunkami. Bez rejestracji i bez klucza API.
Szybki start
Pierwsze zapytania
Każdy endpoint to zapytanie GET, które zwraca JSON. Skopiuj polecenie i uruchom je.
Lista krajów z kartami podarunkowymi
curl -s https://giftcards.bidali.com/api/v1/countriesKarty podarunkowe na zakupy spożywcze w Kanadzie
curl -s "https://giftcards.bidali.com/api/v1/countries/canada/brands?category=groceries&limit=5"Jedna marka: kwoty, realizacja i warunki
curl -s https://giftcards.bidali.com/api/v1/countries/canada/brands/doordash-caDowolna strona w formacie Markdown
curl -s -H "Accept: text/markdown" https://giftcards.bidali.com/brands/canada/doordash-ca
Dokumentacja
Endpointy
Wszystkie ścieżki są względne wobec https://giftcards.bidali.com. Dokument OpenAPI opisuje każdy parametr i każdą odpowiedź.
| Ścieżka | Metoda | Co zwraca |
|---|---|---|
/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 |
Do odczytu maszynowego
Wszystko, co może przeczytać agent
OpenAPI 3.1
/openapi.json i /openapi.yaml opisują każdy endpoint, parametr i odpowiedź, na potrzeby generatorów SDK i wywołań narzędzi.
Strony w Markdown
Wyślij Accept: text/markdown do dowolnej strony albo dodaj .md do jej ścieżki (/index.md dla strony głównej), aby otrzymać ją w Markdown.
llms.txt
/llms.txt opisuje sklep prostym językiem i wyjaśnia, kiedy z niego korzystać.
Mapa witryny
/sitemap.xml zawiera listę wszystkich stron z ich adresami w każdym języku.
Błędy
Błędy są zwracane jako JSON z odpowiednim statusem HTTP: 400 przy brakującym lub nieprawidłowym parametrze, 404 przy nieznanym kraju, marce lub ścieżce, 405 przy każdej metodzie innej niż GET oraz 502 lub 504, gdy zawiedzie usługa katalogu. Pole code się nie zmienia; pole hint mówi, co zrobić dalej.
{
"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"
}
}Odpowiedzi są przechowywane w pamięci podręcznej do pięciu minut. Jedna strona zawiera najwyżej 100 marek: resztę pobierzesz przez pagination.next.
Zakupy z poziomu kodu
Kupuj karty podarunkowe przez Bidali Gift Card API
To API tylko odczytuje katalog. Aby kupować karty podarunkowe z własnego oprogramowania lub przez agenta AI, użyj Bidali Gift Card API. Działa z kluczami API i jest dostępne we wczesnym dostępie.
Dostęp przez MCP pojawi się wkrótce.
Pytania od programistów
Czy potrzebuję klucza API?
Nie do API katalogu w tym serwisie: jest publiczne i tylko do odczytu. Bidali Gift Card API, które składa zamówienia, korzysta z kluczy API.
Czy mogę kupić kartę podarunkową przez to API?
Nie, ono tylko odczytuje katalog. Odeślij osobę na stronę marki w tym serwisie (links.page w każdej odpowiedzi), aby ją kupiła, albo kupuj z poziomu kodu przez Bidali Gift Card API.
Czy jest limit zapytań?
Nie ma opublikowanego limitu. Odpowiedzi są przechowywane w pamięci podręcznej przez kilka minut, więc pobierz listę raz i używaj jej ponownie.
Czy jest serwer MCP?
Dostęp przez MCP pojawi się wkrótce.