# API des Bidali Geschenkkarten-Shops

> Eine kostenlose, schreibgeschützte JSON-API für den Geschenkkarten-Katalog dieser Website: Länder, Kategorien, Währungen und Marken, mit Beträgen, Einlösehinweisen und Bedingungen. Ohne Registrierung und ohne API-Schlüssel.

## Ihre ersten Anfragen

Jeder Endpunkt ist eine GET-Anfrage, die JSON zurückgibt. Befehl kopieren und ausführen.

Länder mit Geschenkkarten auflisten

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

Geschenkkarten für Lebensmittel in Kanada finden

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

Eine Marke abrufen: Beträge, Einlösung und Bedingungen

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

Jede Seite als Markdown lesen

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

## Endpunkte

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

## Alles, was ein Agent lesen kann

- 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

## Fehler

Fehler kommen als JSON, mit dem passenden HTTP-Status: 400 bei einem fehlenden oder ungültigen Parameter, 404 bei einem unbekannten Land, einer unbekannten Marke oder einem unbekannten Pfad, 405 bei jeder Methode außer GET, und 502 oder 504, wenn der Katalogdienst ausfällt. Das Feld code bleibt gleich; das Feld hint sagt, was als Nächstes zu tun ist.

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

Antworten werden bis zu fünf Minuten zwischengespeichert. Eine Seite enthält höchstens 100 Marken: Für den Rest pagination.next folgen.

## Geschenkkarten mit der Bidali Gift Card API kaufen

Diese API liest nur den Katalog. Um Geschenkkarten aus Ihrer eigenen Software oder mit einem KI-Agenten zu kaufen, nutzen Sie die Bidali Gift Card API. Sie arbeitet mit API-Schlüsseln und ist im Early Access.

- Zur Dokumentation: https://docs.bidali.com
- Gift Card API: https://www.bidali.com/products/gift-card-api
- Vertrieb kontaktieren: https://www.bidali.com/contact?intent=sales

Ein MCP-Zugang ist in Vorbereitung.

## Other formats

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