Um eine faire Nutzung und optimale Leistung der API zu gewährleisten, werden bestimmte Einschränkungen durchgesetzt. Das Überschreiten dieser Grenzen kann zu einer vorübergehenden Sperrung des Zugriffs führen, daher ist es wichtig, Ihre Nutzung sorgfältig zu verstehen und zu überwachen.
Anfragebeschränkungen
- Die maximale Anzahl zulässiger Anfragen beträgt 10.000 pro Stunde und API-Schlüssel.
- Wenn Sie dieses Limit überschreiten, kann Ihr API-Schlüssel für bis zu 24 Stunden vorübergehend gesperrt werden. Dies ist eine Schutzmaßnahme, um die Stabilität und Verfügbarkeit der API für alle Nutzer sicherzustellen.
Um das Erreichen des Limits zu vermeiden, sollten Sie folgende bewährte Methoden umsetzen:
- Überwachen Sie Ihre Anfragenutzung - Behalten Sie die Anzahl der Anfragen im Blick, um innerhalb der zulässigen Schwelle zu bleiben.
- Optimieren Sie Ihre Anfragen - Kombinieren Sie die Datenabfrage, wo möglich, um die Anzahl der Anfragen zu reduzieren. Nutzen Sie Batch-Verarbeitung, wenn die API dies unterstützt.
- Implementieren Sie eine Ratenbegrenzung - Integrieren Sie eine Verzögerungs- oder Warteschlangenmechanik in Ihre Anwendung, um eine Überlastung der API durch schnelle Folgeanfragen zu vermeiden.
- Gehen Sie mit Ratenbegrenzungsfehlern angemessen um - Wenn Ihr Anfragelimit überschritten wird, gibt die API einen entsprechenden Fehlercode zurück (z. B. HTTP 429 - Zu viele Anfragen). Stellen Sie sicher, dass Ihre Anwendung diese Fehler verarbeiten und Anfragen nach der Sperrfrist pausieren oder erneut senden kann.
Sichere Anfragen über HTTPS
Alle API-Anfragen müssen über HTTPS erfolgen, um Sicherheit und Datenintegrität zu gewährleisten. Anfragen über unverschlüsseltes HTTP schlagen automatisch fehl. HTTPS verschlüsselt die Kommunikation zwischen Ihrer Anwendung und dem API-Server und schützt so sensible Informationen wie Ihren API-Schlüssel und übertragene Daten.
Authentifizierung ist verpflichtend
- API-Anfragen ohne Authentifizierung schlagen fehl.
- Sie müssen Ihren API-Schlüssel oder Zugriffstoken in den Anforderungsheadern gemäß der API-Dokumentation angeben.
- Eine ordnungsgemäße Authentifizierung stellt sicher, dass Ihre Anfragen autorisiert sind und für Überwachungs- und Ratenbegrenzungszwecke nachverfolgt werden können.
Wichtige Erkenntnisse
- Bleiben Sie innerhalb des Limits von 10.000 Anfragen pro Stunde, um eine 24-stündige Sperrung zu vermeiden.
- Verwenden Sie für alle Anfragen HTTPS; HTTP wird nicht unterstützt und schlägt fehl.
- Stellen Sie sicher, dass jede Anfrage ordnungsgemäß mit Ihren einzigartigen API-Zugangsdaten authentifiziert ist.
Indem Sie diese Richtlinien einhalten und bewährte Methoden umsetzen, können Sie einen reibungslosen Zugriff auf die API aufrechterhalten, Unterbrechungen vermeiden und eine sichere sowie effiziente Nutzung gewährleisten.