Calendario
Obtener la agenda de un rango
Devuelve la agenda consolidada de una ventana: proyectos, pedidos, tareas, servicios internos y servicios de pedido.
Ejemplos de petición
curl 'https://app.filmo.io/api/v1/schedule?startDate=2026-09-01T08%3A00%3A00Z&endDate=2026-09-01T08%3A00%3A00Z' \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
No pagina: está acotada por fechas, que es lo que pide un calendario, pero cada capa tiene un tope y la respuesta no indica cuándo se ha cortado: como máximo 200 proyectos, 200 pedidos y 500 tareas, ordenados por fecha de inicio, de modo que una capa que devuelve exactamente su tope puede estar truncada (usa una ventana más corta). Solo aparecen los registros activos: proyectos en draft, budgeted, confirmed o in_progress, y pedidos en draft, reserved, prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned o checked_in_partially; un pedido checked_in, cancelado o archivado no se devuelve. Por tanto, no es una instantánea completa: no borres un registro solo porque falte. Las personas asignadas salen por identificador y nombre; sus datos de contacto no.
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. schedule:read
Cabeceras
Lectura condicional: el ETag de la copia que ya tienes. Si el recurso no ha cambiado, la respuesta es 304 sin cuerpo.
Ejemplo:"\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
Parámetros de consulta
Inicio de la ventana, en ISO 8601 con desplazamiento.
Fin de la ventana, en ISO 8601 con desplazamiento.
Qué capas obtener: projects, orders, tasks, internal_services u order_services. Por defecto, todas. Repite el parámetro o separa los valores con comas para indicar varias.
Opciones disponibles: projects, orders, tasks, internal_services, order_services
Límites: mín. 1 elementos, máx. 50 elementos
Filtra los proyectos por estado.
Límites: mín. 1 elementos, máx. 50 elementos
Filtra los pedidos por estado.
Límites: mín. 1 elementos, máx. 50 elementos
Conserva solo lo asignado a estos miembros del personal.
Límites: mín. 1 elementos, máx. 200 elementos
Respuesta
Respuesta correcta.
Esquema de la respuesta: ScheduleDto
Sobre: ScheduleResponse. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag
Agenda consolidada de una ventana de fechas.
Mostrar atributos hijosOcultar atributos hijos
Proyectos que caen dentro de la ventana.
Mostrar atributos hijosOcultar atributos hijos
Pedidos que caen dentro de la ventana.
Mostrar atributos hijosOcultar atributos hijos
Tareas del planificador. Sin los datos de contacto de las personas a las que están asignadas.
Mostrar atributos hijosOcultar atributos hijos
Mostrar atributos hijosOcultar atributos hijos
Identificador del miembro del personal.
Nombre que se muestra en la agenda.
Asignaciones no vinculadas a un pedido.
Mostrar atributos hijosOcultar atributos hijos
Mostrar atributos hijosOcultar atributos hijos
Identificador del miembro del personal.
Nombre que se muestra en la agenda.
Servicios de personal y de flota asociados a un pedido.
Mostrar atributos hijosOcultar atributos hijos
Mostrar atributos hijosOcultar atributos hijos
Identificador del miembro del personal.
Nombre que se muestra en la agenda.
Información adicional sobre la respuesta.
Mostrar atributos hijosOcultar atributos hijos
Avisos del ciclo de vida; solo aparecen cuando la operación está obsoleta.
Mostrar atributos hijosOcultar atributos hijos
Código de aviso estable.
Opciones disponibles: deprecated
Para personas: qué está obsoleto, hasta cuándo y qué usar.
Día (YYYY-MM-DD) en que la operación deja de estar disponible.
operationId de la operación que hay que usar en su lugar, o null si no hay ninguna.
Dónde está documentada la deprecación (el changelog).
No modificado: el If-None-Match enviado coincide con el ETag actual. Sin cuerpo; la copia que tienes está al día.
Cabeceras: ETag
Sin cuerpo.
Petición no válida (validation_error): consulta o cuerpo mal formados. errors[] enumera cada campo erróneo con su código estable.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Fallo de autenticación (unauthorized, api_key_invalid, api_key_revoked, api_key_expired, api_key_owner_inactive, api_key_owner_not_admin).
Cabeceras: X-Request-Id · Content-Language
No permitido (insufficient_scope: la clave de API no tiene el scope requerido, indicado en requiredScope; forbidden: el propietario de la clave carece del permiso que exige la operación). insufficient_scope se responde antes de que la petición cuente contra el límite de peticiones, así que no lleva cabeceras RateLimit-*; forbidden sí.
Cabeceras: X-Request-Id · Content-Language
Límite de peticiones superado (rate_limited): reintenta tras Retry-After segundos; RateLimit-* indica qué cuota se ha agotado.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Retry-After
Error interno (internal_error).
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Errores
| Estado | Códigos | Significado |
|---|---|---|
| 400 | validation_error | Consulta o cuerpo mal formados. errors[] enumera cada campo erróneo con su código estable. |
401, 403, 429, 500 los puede devolver cualquier operación. Errores
Obsolescencia
Esta operación no está obsoleta. Las obsolescencias se anuncian con la cabecera Deprecation y una fecha de retirada. Política de versiones
Relacionado
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasOperaciones
Agenda
Agenda consolidada de una ventana de fechas.
¿Te ha resultado útil esta página?