Résolution des problèmes

Codes d'erreur API

L’API Frame.io peut renvoyer les erreurs courantes suivantes :

CodeDétailsRaison(s)
401Non autorisé — jeton API non valide. Vérifiez que vous utilisez l’authentification Bearer Token et que vous transmettez votre jeton via l’en-tête Authorization.
402Utilisation dépassée — Vous avez dépassé les limites de votre Forfait Frame.io.
403Interdit — Vous n’avez pas accès à cette ressource. Renvoyé à la fois pour l’accès Utilisateur et pour la portée du jeton.
404Introuvable — Ressource introuvable.La ressource a été déplacée ou supprimée.
422Arguments non valides — Un ou plusieurs paramètres fournis n’étaient pas valides.
429Limite de taux atteinte — Vous avez atteint la limite de taux pour l’API.
500Erreur serveur — Notre serveur ne sait pas comment interpréter votre demande, ou n’a pas pu traiter votre demande dans le délai disponible (30 secondes).URL de demande, corps mal formé, ou impossible de terminer pour une autre raison.

Dépannage des erreurs courantes

Lorsque vous utilisez un jeton API valide pour effectuer des tâches courantes, les erreurs les plus courantes sont 403, 404 et 500. Une erreur 403 indique généralement l’un des trois scénarios suivants :

  1. Le jeton utilisé dans la demande, et/ou l’Utilisateur auquel appartient le jeton, n’a pas un accès suffisant à la zone du Compte Frame.io où la ressource a été demandée.
  2. Le jeton n’a pas suffisamment de portées pour la ressource demandée. Par exemple : appel GET /comments/ sans la portée comments.read.
  3. Un problème de trafic réseau empêche l’API Frame.io de traiter la demande. Si vous soupçonnez que vos demandes sont bloquées par un problème de trafic réseau, veuillez contacter l’assistance clientèle.

Une erreur 404 indique généralement qu’une ressource n’existe plus — elle a été déplacée ou supprimée. Une erreur 500 indique généralement une URL de demande ou un corps mal formés, mais peut également se produire lorsque nous ne parvenons pas à traiter la demande dans le délai imparti (30 s).

Limitation du taux

L’API Frame.io applique des limites de taux par jeton. La limite par défaut pour un jeton est de 50 appels par seconde. Certaines méthodes ont des limites inférieures (par exemple, POST /assets/:id/children est limité à 5 assets par seconde).

Toutes les limites sont susceptibles de changer et, lorsqu’elles sont atteintes, renvoient une erreur HTTP 429. Nous suggérons d’utiliser une approche de temporisation exponentielle pour gérer la limitation du taux.

Consultez notre Guide sur les limites de taux pour en savoir plus.