> This page is for Plate-forme, version Hérité.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 expérimental: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Hérité: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# Codes d'erreur API

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




| Code | Détails | Raison(s) |
| ---------- | ---------- | ---------- |
| `401` | **Non 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. |  |
| `402` | **Utilisation dépassée** -- Vous avez dépassé les limites de votre Forfait Frame.io. |  |
| `403` | **Interdit** -- Vous n'avez pas accès à cette ressource. Renvoyé à la fois pour l'accès Utilisateur et pour la portée du jeton. |  |
| `404` | **Introuvable** -- Ressource introuvable. | La ressource a été déplacée ou supprimée. |
| `422` | **Arguments non valides** -- Un ou plusieurs paramètres fournis n'étaient pas valides. |  |
| `429` | **Limite de taux atteinte** -- Vous avez atteint la limite de taux pour l'API. |  |
| `500` | **Erreur 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](./rate-limits) sur les limites de taux pour en savoir plus.