Para saber más
Obtener soporte
Cita el id de petición y la hora aproximada de la petición, con su zona horaria. Las respuestas de la API llevan el id en la cabecera X-Request-Id, y cada error lo repite como requestId.
El id de la petición
Enlace a esta sección: El id de la peticiónToda respuesta de la API, correcta o no, lleva una cabecera X-Request-Id, con la forma req_ seguida de caracteres hexadecimales. Un cuerpo de error repite el valor como requestId. Identifica una petición. Filmo lo genera en el servidor: nunca se usa un valor que envíes.
Hay dos lugares que no siguen esto. Los endpoints de OAuth no devuelven ningún id de petición, y un 401 del endpoint MCP puede llevarlo solo en el cuerpo, no en la cabecera.
{
"type": "https://docs.filmo.io/errors/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "The order does not exist",
"requestId": "req_5f1c2f4e3a5b4f6d8e7a0b1c2d3e4f5a"
}Registra el id de petición de cada llamada fallida. No esperes a tener un problema para empezar a guardarlo.
Cita el id de petición cuanto antes. Filmo no promete que una petición se pueda localizar después, ni durante cuánto tiempo, así que una petición de hace semanas puede no encontrarse. Por eso la hora de la petición importa tanto como el id.
Qué incluir
Enlace a esta sección: Qué incluir- El id de la petición, o varios si el problema se repite.
- La hora aproximada de la petición, con su zona horaria.
- La operación: método y ruta, como
POST /api./v1 /orders - Qué esperabas y qué ocurrió: el estado HTTP y el
codedel error. - Los scopes de la clave (los
scopesdeGET /api), si el problema es de permisos./v1 /account - Si usaste la API REST o una herramienta MCP, y el cliente.
Qué dejar fuera
Enlace a esta sección: Qué dejar fuera- La clave de API, o cualquier parte de ella.
- Datos personales de clientes o de personal. El id de petición y la hora es lo que necesita soporte.
- Cuerpos de respuesta completos que contengan registros. Envía la forma o una copia con los datos ocultos.
Antes de escribir
Enlace a esta sección: Antes de escribir- Comprueba el estado y el guía de errores. La primera llamada que falla suele tener una causa conocida.
- Si el error es un 400 en una fecha, comprueba el desplazamiento; consulta fechas y horas.
- En un 429, espera a
Retry-Afterantes de volver a intentarlo. - En un 5xx en una escritura, reintenta primero con la misma
Idempotency-Key, para que la escritura no se ejecute dos veces.
Escribir a soporte
Enlace a esta sección: Escribir a soportePon la información de arriba en tu primer mensaje, para que nadie tenga que pedirla de nuevo. Esta documentación no promete un tiempo de respuesta.
Para ponerte en contacto, sigue los pasos de Contactar con soporte en el centro de ayuda.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasGuías
Errores
Los errores son documentos de problema RFC 9457. Ramifica según el
codeestable, nunca según el texto, y usa la tabla de reintentos para decidir si volver a intentarlo.Guías
Respuestas
Las respuestas correctas envuelven su contenido en
data; las listas añadenpagination; algunas operaciones añadenmeta; los errores son problemas RFC 9457. Las respuestas de la API comparten un mismo conjunto de cabeceras.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.
¿Te ha resultado útil esta página?