Zurück zur Übersicht
API-Dokumentation
Interaktive Referenz aller REST-API-Endpunkte. Testen Sie Anfragen direkt in der Dokumentation mit Ihrem API-Schlüssel.
Bearer-Token-Authentifizierung
10 Anfragen/Sekunde (Rate-Limit)
OpenAPI 3.1
Schnellstart
Erstellen Sie einen API-Schlüssel in Ihren Kontoeinstellungen, dann senden Sie Ihre erste Anfrage:
curl -H "Authorization: Bearer zvg_XXXXXXXX_YYYYYYYY..." \ "https://api.zvg-einfach.de/v1/auctions?land=st&per_page=5"
Kostenlose Sandbox
Jedes Konto, auch ein kostenloses, kann in den Kontoeinstellungen einen Sandbox-Schlüssel erstellen. Eine Registrierung ist nötig, eine Zahlung nicht.
- Nur Daten aus Sachsen-Anhalt (Bundesland-Kürzel
st) - 100 Aufrufe pro Tag (Zurücksetzung um 00:00 UTC), 10 Anfragen pro Sekunde
- Ein Schlüssel pro Konto, ohne Ablaufdatum
- Anfragen für ein anderes Bundesland liefern
403 sandbox_region_restricted, ein aufgebrauchtes Tageslimit liefert429 daily_limit_exceeded - Die Header
X-DailyLimit-RemainingundGET /v1/mezeigen die verbleibenden Aufrufe
Mit einem API-Abo gilt derselbe Schlüssel für alle Bundesländer, ohne Tageslimit.
