# 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.

## Pierwsze zapytania

Każdy endpoint to zapytanie GET, które zwraca JSON. Skopiuj polecenie i uruchom je.

Lista krajów z kartami podarunkowymi

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

Karty podarunkowe na zakupy spożywcze w Kanadzie

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

Jedna marka: kwoty, realizacja i warunki

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

Dowolna strona w formacie Markdown

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

## Endpointy

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

## Wszystko, co może przeczytać agent

- 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

## 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.

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

Odpowiedzi są przechowywane w pamięci podręcznej do pięciu minut. Jedna strona zawiera najwyżej 100 marek: resztę pobierzesz przez pagination.next.

## 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.

- Przeczytaj dokumentację: https://docs.bidali.com
- Gift Card API: https://www.bidali.com/products/gift-card-api
- Porozmawiaj z działem sprzedaży: https://www.bidali.com/contact?intent=sales

Dostęp przez MCP pojawi się wkrótce.

## Other formats

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