Integrationsleitfaden für die Housing Market API

Die Referenztabellen, Endpunktbeschreibungen, Fehlercodes und Beispiele werden aus der API-Spezifikation generiert und bleiben in jeder Sprache auf Englisch. Namen, Parameter und Codes sind überall identisch.

Ratenlimits und Kontingente

Jeder Schlüssel hat ein Ratenlimit pro Minute sowie Tages- und Monatskontingente.

Die Limits für Ihren Schlüssel werden in der Konsole angezeigt, und jede Antwort enthält die Header RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset. In diesem Leitfaden werden keine Zahlen veröffentlicht.

  • rate_limited: Sie haben in der aktuellen Minute zu viele Anfragen gesendet.
  • quota_exceeded: Das Tages- oder Monatskontingent des Schlüssels ist aufgebraucht.

Beide werden als HTTP 429 mit einem Retry-After-Header zurückgegeben, der die Anzahl der zu wartenden Sekunden enthält. Warten Sie so lange, und versuchen Sie es dann mit exponentiellem Back-off erneut. Wiederholen Sie Anfragen nicht in einer engen Schleife.

Die Nutzung wird überwacht. Muster, die nach dem Kopieren des Datenbestands oder nach einem geteilten Schlüssel aussehen, können dazu führen, dass ein Schlüssel pausiert wird.