Entwickler
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.
Schnellstart
Ihre ersten Anfragen
Jeder Endpunkt ist eine GET-Anfrage, die JSON zurückgibt. Befehl kopieren und ausführen.
Länder mit Geschenkkarten auflisten
curl -s https://giftcards.bidali.com/api/v1/countriesGeschenkkarten für Lebensmittel in Kanada finden
curl -s "https://giftcards.bidali.com/api/v1/countries/canada/brands?category=groceries&limit=5"Eine Marke abrufen: Beträge, Einlösung und Bedingungen
curl -s https://giftcards.bidali.com/api/v1/countries/canada/brands/doordash-caJede Seite als Markdown lesen
curl -s -H "Accept: text/markdown" https://giftcards.bidali.com/brands/canada/doordash-ca
Referenz
Endpunkte
Alle Pfade sind relativ zu https://giftcards.bidali.com. Das OpenAPI-Dokument beschreibt jeden Parameter und jede Antwort.
| Pfad | Methode | Was zurückkommt |
|---|---|---|
/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 |
Maschinenlesbar
Alles, was ein Agent lesen kann
OpenAPI 3.1
/openapi.json und /openapi.yaml beschreiben jeden Endpunkt, jeden Parameter und jede Antwort, für SDK-Generatoren und Tool-Aufrufe.
Markdown-Seiten
Senden Sie Accept: text/markdown an eine beliebige Seite oder hängen Sie .md an ihren Pfad an (/index.md für die Startseite), um sie als Markdown zu erhalten.
llms.txt
/llms.txt erklärt den Shop in einfacher Sprache und wofür er sich eignet.
Sitemap
/sitemap.xml listet alle Seiten auf, mit ihrer Adresse in jeder Sprache.
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.
{
"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.
Kaufen per Code
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.
Ein MCP-Zugang ist in Vorbereitung.
Fragen von Entwicklern
Brauche ich einen API-Schlüssel?
Nicht für die Katalog-API dieser Website: Sie ist öffentlich und schreibgeschützt. Die Bidali Gift Card API, über die Bestellungen laufen, nutzt API-Schlüssel.
Kann ich mit dieser API eine Geschenkkarte kaufen?
Nein, sie liest nur den Katalog. Schicken Sie die Person zum Kauf auf die Seite der Marke auf dieser Website (links.page in jeder Antwort), oder kaufen Sie per Code mit der Bidali Gift Card API.
Gibt es ein Anfragelimit?
Es gibt kein veröffentlichtes Limit. Antworten werden einige Minuten zwischengespeichert, also eine Liste einmal abrufen und wiederverwenden.
Gibt es einen MCP-Server?
Ein MCP-Zugang ist in Vorbereitung.