Lista de comprobación de salida a producción

1. 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 o 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 y Permisos (scopes).

2. 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, Idempotencia y Errores.

3. 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. 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.

5. 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 y api_key_owner_not_admin, y para las cabeceras Deprecation y Sunset. Suscríbete al feed de la pestaña Changelog.

6. 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.

7. 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.

8. 8

   Revisar las capacidades y los límites, y probar

   Lectura Capacidades y límites para ver los límites estrictos y luego ejecuta las comprobaciones de Pruebas.

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 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.

Ejecuta GET /api/v1/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). La llamada también devuelve la versión del contrato y los límites que se aplican a la clave.

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