Dieser Artikel enthält bewährte Methoden für die Interaktion mit und die Verwendung der Vimeo-API.
In diesem Artikel erfährst du mehr über Folgendes:
- Cache-Antworten
- Feldfilter verwenden
- Halte dich an die Ratenlimits
- Scraping vermeiden
- Verwende nur unsere öffentlich dokumentierten APIs
Cache-Antworten
Die meisten Metadaten auf Vimeo ändern sich nicht häufig (wie z. B. Videonamen, Beschreibungen, Einbettungscode usw.). Wo immer möglich, sollten Entwickler diese Antworten zwischenspeichern und aus dem Cache liefern und nur dann Anfragen an die API stellen, wenn neue Metadaten benötigt oder erwartet werden. Die Implementierung von Parametern wie den If-Modified-Since Header kann in diesem Bereich helfen. Weitere Informationen erhältst du unter 'Verwendung des If-Modified-Since Headers' auf unserer Entwicklerseite.
Feldfilter verwenden
Viele Anfragen an Vimeo liefern eine Masse an Daten, was vielleicht nicht effizient ist, wenn du nur eine bestimmte Information benötigst. Die Verwendung des fields-Parameters, um genau anzugeben, was du von der Antwort benötigst, wird die Auslastung unserer Server verringern und die Antwort der API beschleunigen.Weitere Informationen erhältst du unter 'Verwendung des fields-Parameters'. Zusätzlich bekommst du mit dem fields-Parameter ein höheres Ratenlimit.
Halte dich an die Ratenlimits
Wir setzen Ratenlimits durch, um eine stabile Plattform für alle Entwickler zu gewährleisten.Wenn deine Anwendung das Ratenlimit überschreitet, gibt die API einen HTTP 429-Fehler aus.Entwickler sollten damit rechnen und keine Anfragen an die API stellen, bis das Ratenlimit-Verbot aufgehoben wurde.Weitere Informationen erhältst du unter 'Arbeiten mit Ratenlimits'.
Scraping vermeiden
Scraping bezeichnet das Extrahieren von Daten aus einer Website, oft durch Laden einer Webseite und Ausführen eines Skripts, um die gewünschten Daten von der Seite zu erhalten.
Anstatt Daten durch Scraping abzurufen, sollten Entwickler eine unserer APIs verwenden, um die gleichen Daten zu erhalten; die Implementierung unserer API ist einfacher und schneller als das Scraping auf der Website.
Wenn wir feststellen, dass ein Server Scraping gegenüber Vimeo einsetzt und uns mit gewaltigem Traffic bombardiert, können wir die IP-Adresse dieses Servers ohne Vorankündigung sperren.Wenn du glaubst, dass die IP-Adresse deines Servers gesperrt wurde, wende dich an den Support und gib uns zusätzliche Informationen.
Verwende nur unsere öffentlich dokumentierten APIs
Unerschrockene Entwickler entdecken möglicherweise Meta-Tags, Konfigurationsdateien oder andere APIs, die verwendet werden, um Daten von Vimeo zu erhalten. Auch wenn sie für versierte Benutzer zugänglich sein mögen, bitten wir darum, dass Entwickler nur die öffentlichen APIs verwenden, die auf der Entwickler-Website dokumentiert sind. Diese internen APIs sind nicht für die Nutzung durch Dritte vorgesehen und können jederzeit ohne Vorankündigung geändert werden.