*API REST › Guías*

# Lista de comprobación de salida a producción

> Repasa estas ocho comprobaciones antes de que tu integración funcione con datos de producción. Cada una remite a la guía que la explica.

1. **Una clave por integración, con los permisos (scopes) mínimos** Créala desde una cuenta de administrador dedicada que dure más que cualquier persona concreta, y guárdala en un gestor de secretos. La clave y cada conexión OAuth actúan como el administrador que las creó, y se detienen con 401 [`api_key_owner_inactive`](https://docs.filmo.io/es/rest-api/errors/api_key_owner_inactive) o [`api_key_owner_not_admin`](https://docs.filmo.io/es/rest-api/errors/api_key_owner_not_admin) si esa persona se va o deja de ser administradora. Ni una clave ni una conexión OAuth usan una plaza propia, pero la cuenta de administrador sí. Una clave no caduca a menos que fijes una fecha de caducidad al crearla, y no caduca por inactividad. Para rotar una, crea una segunda clave, pasa la integración a ella y revoca la primera. Consulta [cómo generar una clave](https://www.filmo.io/es/help/reference/integraciones-y-api/generar-una-clave-de-api) y [Permisos (scopes)](https://docs.filmo.io/es/rest-api/guides/scopes).
2. **Respeta Retry-After y envía una Idempotency-Key en las escrituras** Espera `Retry-After` ante un 429, envía una `Idempotency-Key` en cada escritura y sigue la tabla de decisión de reintentos. Consulta [Límites de peticiones](https://docs.filmo.io/es/rest-api/guides/rate-limits), [Idempotencia](https://docs.filmo.io/es/rest-api/guides/idempotency) y [Errores](https://docs.filmo.io/es/rest-api/guides/errors).
3. **Gestionar respuestas que no son application/problem+json** Un 413, 502 o 504 puede venir de la plataforma y no llevar `code` ni `requestId`. Decide por el estado y no intentes leer un `code`.
4. **Tolera propiedades y valores de enum desconocidos** Los clientes generados con enums cerrados fallan con los cambios aditivos que permite la política de versiones. Consulta [Versionado](https://docs.filmo.io/es/rest-api/guides/versioning).
5. **Registrar, alertar y suscribirse** Registra `X-Request-Id` en cada llamada. Filmo lo genera en el servidor, así que no puedes elegirlo; cuando contactes con soporte, envía el `requestId` junto con la hora aproximada de la petición. Configura alertas para 401 [`api_key_owner_inactive`](https://docs.filmo.io/es/rest-api/errors/api_key_owner_inactive) y [`api_key_owner_not_admin`](https://docs.filmo.io/es/rest-api/errors/api_key_owner_not_admin), y para las cabeceras `Deprecation` y `Sunset`. Suscríbete al feed de la pestaña Changelog.
6. **Revisar las automatizaciones de la cuenta** Tus escrituras activan los workflows de eventos de la cuenta y no puedes suprimirlos por petición. Enumera los workflows activos que empiezan con un evento o una entidad, pausa los que puedan llegar a un cliente y filtra los demás por `origin` para excluir `api`. Se espera que un workflow que llama a la API con una clave escape de la protección contra bucles de Filmo, así que nunca dejes sin filtrar uno que escriba de vuelta. Consulta [Pruebas](https://docs.filmo.io/es/rest-api/guides/testing).
7. **Si sincronizas datos, usa los parámetros de pasada completa** Pasa los parámetros que revelan los registros que las listas ocultan por defecto, toma los límites de la ventana de la hora del servidor y confirma con un GET antes de borrar nada por tu lado. Consulta [Sincronizar datos](https://docs.filmo.io/es/rest-api/guides/syncing-data).
8. **Revisar las capacidades y los límites, y probar** Lectura [Capacidades y límites](https://docs.filmo.io/es/further-reading/capabilities-and-limits) para ver los límites estrictos y luego ejecuta las comprobaciones de [Pruebas](https://docs.filmo.io/es/rest-api/guides/testing).

## Qué necesita la cuenta

La API y el MCP están incluidos en cualquier plan de pago y no son un add-on. Algunos módulos sí lo son: un recurso tras un add-on responde 402 [`addon_required`](https://docs.filmo.io/es/rest-api/errors/addon_required) cuando la cuenta no lo tiene, así que gestiona esa respuesta en cada recurso que uses. Solo los administradores pueden crear claves o dar su consentimiento a una conexión OAuth.

## Una última comprobación en producción

Ejecuta [`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account) una vez con la clave de producción. Confirma que la cuenta es la que esperas, que la clave tiene exactamente los permisos (scopes) que planeaste, que los add-ons que necesitas aparecen en la lista, y si la cuenta sigue en periodo de prueba ([`trial`](https://docs.filmo.io/es/rest-api/objects/account#response-trial)). La llamada también devuelve la versión del contrato y los límites que se aplican a la clave.

```bash
curl -sS "${FILMO_BASE_URL:-https://app.filmo.io}/api/v1/account" \
  -H "Authorization: Bearer $FILMO_API_KEY"
```

---

URL canónica: https://docs.filmo.io/es/rest-api/guides/going-live  
Última actualización: 2026-10-09