Tipos de tarea
Listar tipos de tarea
Devuelve el catálogo de tipos de tarea: primero los del sistema y luego los personalizados de la cuenta.
Ejemplos de petición
curl https://app.filmo.io/api/v1/task-types \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
Sin paginación.
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. tasks:read
Parámetros de consulta
Incluir tipos archivados: "true" los devuelve además de los activos; "false" u omitirlo los oculta.
Respuesta
Respuesta correcta.
Esquema de la respuesta: TaskTypeDto
Sobre: TaskTypeItems. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Mostrar atributos hijosOcultar atributos hijos
Identificador único del tipo de tarea.
Nombre del tipo de tarea. Los tipos de sistema se sirven en español; los tipos personalizados llevan el nombre que les dio la cuenta.
Color asociado al tipo de tarea (código hexadecimal).
Si es un tipo del sistema (predefinido) o un tipo personalizado de la cuenta.
Si el tipo está archivado.
Número de tareas que usan el tipo; null para los tipos del sistema (no se calcula).
Fecha de creación en ISO 8601 con desplazamiento; null para los tipos del sistema.
Fecha de la última actualización en ISO 8601 con desplazamiento; null para los tipos del sistema.
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).
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
Tipo de tarea
El tipo de tarea, tal como lo devuelve la API.
¿Te ha resultado útil esta página?