Ratenbegrenzung
Ist die Rate der API-Anforderungen begrenzt?
Ja, Zencoder begrenzt, wie oft Sie eine bestimmte Methode innerhalb eines bestimmten Zeitrahmens aufrufen können. Limits werden pro Methode (Ressource) verfolgt (was bedeutet, dass zum Beispiel GET und POST Anforderungen werden separat verfolgt), mit Ausnahme von Fortschrittsanforderungen, die pro Ausgabe verfolgt werden. Beispielsweise zählen Aufrufe zum Abrufen von Auftrags- und Ausgabeinformationen alle auf das gleiche Limit, während Aufrufe zum Ausgabefortschritt separat pro Ausgabe verfolgt werden.
Für jedes Konto sind 60 Anforderungen pro Minute zulässig, mit Ausnahme von Anforderungen zur Joberstellung, die auf 1.000 Anforderungen pro Minute begrenzt sind, und von Fortschrittsanforderungen, die auf 60 Anforderungen pro Minute und Ausgabe begrenzt sind.
Jede HTTP-Antwort enthält einen Header mit dem Namen "X-Zencoder-Rate-Remaining". In dieser Kopfzeile wird die Anzahl der Anrufe aufgeführt, die Sie innerhalb des aktuellen Zeitrahmens an eine bestimmte Ressource tätigen können.
Wenn Sie Ihr Kontingent überschreiten, gibt Zencoder einen 403-Fehler mit dem Text "403 Forbidden (Rate Limit Exceeded)". Wir senden auch einen zusätzlichen Header zurück, "Retry-After„, der die Anzahl der Sekunden enthält, bis Ihr Kontingent zurückgesetzt wird.
Warum ist die Rate der API-Anforderungen begrenzt?
Wir begrenzen API-Anfragen auf eine angemessene Anzahl, um sicherzustellen, dass ein Kunde von Zencoder keine negativen Auswirkungen auf andere Kunden hat. Ohne Ratenbegrenzung könnte ein Kunde unser System mit Anfragen überfluten, so dass ein anderer Kunde das System nicht nutzen kann. Dies geschieht regelmäßig aus Versehen, wenn Kunden zum ersten Mal mit einer API arbeiten. Ein einfacher Programmierfehler kann die API mit Anforderungen überfluten, die der Kunde nicht senden möchte.
Solange Ihre Anwendung ordnungsgemäß eingerichtet ist, sollte die Ratenbegrenzung kein Problem darstellen. Wenn wir einen 403 mit "Rate Limit Exceeded" im Text zurückgeben, wiederholen Sie Ihre Anfrage einfach nach dem angegebenen Zeitraum.
Wenn Sie feststellen, dass Sie regelmäßig an diese Grenzen stoßen, kontaktiere uns um Ihr Setup und Ihre Optionen zu besprechen.