Tareas
Obtener una tarea
Devuelve el detalle de una tarea por su identificador.
Ejemplos de petición
curl https://app.filmo.io/api/v1/tasks/task_8f2a1c \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. tasks: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 ruta
Identificador de la tarea.
Límites: longitud mín. 1
Respuesta
Respuesta correcta.
Esquema de la respuesta: TaskDto
Sobre: TaskResponse. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag
La tarea, tal como la devuelve la API.
Mostrar atributos hijosOcultar atributos hijos
Identificador único de la tarea.
Título de la tarea.
Descripción o notas de la tarea; null si no tiene.
Fecha y hora de inicio en ISO 8601 con desplazamiento.
Fecha y hora de fin en ISO 8601 con desplazamiento; null si no tiene un fin definido.
Si la tarea dura todo el día.
Si la tarea está completada.
Si la tarea forma parte de una serie recurrente.
Identificador del grupo de recurrencia al que pertenece; null si no es recurrente.
Patrón de recurrencia de la tarea; null si no es recurrente.
Mostrar atributos hijosOcultar atributos hijos
Frecuencia de recurrencia: daily, weekly, monthly o yearly.
Opciones disponibles: daily, weekly, monthly, yearly
Intervalo entre repeticiones según la frecuencia (p. ej. 2 con weekly = cada dos semanas).
Número de repeticiones tras las cuales termina la recurrencia; null si no termina por número de ocurrencias.
Fecha en que termina la recurrencia, en ISO 8601 con desplazamiento; null si no termina por fecha.
Tipo de tarea (identificador del tipo).
Identificadores del personal asignado a la tarea.
Identificador del proyecto vinculado; null si la tarea no está vinculada.
Aspecto de la tarea en la agenda (color y variante).
Mostrar atributos hijosOcultar atributos hijos
Color de la tarea en la agenda (código hexadecimal).
Variante visual de la tarea: primary, secondary, destructive o default.
Opciones disponibles: primary, secondary, destructive, default
Fecha de creación en ISO 8601 con desplazamiento.
Fecha de la última actualización en ISO 8601 con desplazamiento.
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.
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
Recurso no encontrado (not_found): no existe o está fuera del alcance de la clave de API.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
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
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
Tarea
La tarea, tal como la devuelve la API.
¿Te ha resultado útil esta página?