Incidencias
Obtener una incidencia
Devuelve una incidencia por su identificador: qué se rompió, sobre qué recae, en qué estado está y si bloquea la disponibilidad del material.
Ejemplos de petición
curl https://app.filmo.io/api/v1/incidents/inci_8f2a1c \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
NO incluye el coste de reparación ni la nota de resolución interna.
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. incidents: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 incidencia.
Límites: longitud mín. 1
Respuesta
Respuesta correcta.
Esquema de la respuesta: IncidentDto
Sobre: IncidentResponse. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag
Material roto, perdido o que funciona mal, con su estado de reparación.
Mostrar atributos hijosOcultar atributos hijos
Identificador único de la incidencia.
Número de incidencia legible.
Título corto de la incidencia.
Descripción; null si no tiene.
Naturaleza: damage, loss, malfunction, cosmetic, theft o custom.
A qué afecta: item, serializedItem, space, kit, vehicle o custom.
Opciones disponibles: item, serializedItem, space, kit, vehicle, custom
Estado del ciclo de vida: draft, open, waiting, repairing, complete o lost.
Prioridad: urgent, high, medium, low o none.
Gravedad declarada.
true cuando la incidencia retira el material del conjunto disponible.
Unidades afectadas en stock a granel; null cuando no aplica.
Artículo afectado; null si no aplica.
Unidad física afectada; null si no aplica.
Espacio afectado; null si no aplica.
Vehículo afectado; null si no aplica.
Pedido en el que se detectó; null si no procede.
Proyecto asociado; null si no aplica.
Fecha objetivo de resolución en ISO 8601 UTC; null si no tiene.
Comentarios que tiene la incidencia.
Fecha de creación en ISO 8601 UTC.
Fecha de la última modificación en ISO 8601 UTC.
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
Add-on requerido (addon_required): el plan de la cuenta no incluye el add-on que necesita esta operación; requiredAddon lo nombra.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
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
| Estado | Códigos | Significado |
|---|---|---|
| 402 | addon_required | El plan de la cuenta no incluye el add-on que necesita esta operación; requiredAddon lo nombra. |
| 404 | not_found | No existe o queda fuera del alcance de la clave de API. |
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
Incidencia
Material roto, perdido o que funciona mal, con su estado de reparación.
¿Te ha resultado útil esta página?