Vehículos
Obtener un vehículo
Devuelve un vehículo por su identificador: matrícula, plazas, carga útil, fecha de la próxima inspección, colección y si aparece en el planificador.
Ejemplos de petición
curl https://app.filmo.io/api/v1/vehicles/vehi_8f2a1c \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
NO incluye el coste por kilómetro: cruzado con la duración de un servicio da lo que le cuesta a la empresa mover el equipo, y los costes internos se excluyen del borde público por diseño.
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. vehicles: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 del vehículo.
Límites: longitud mín. 1
Respuesta
Respuesta correcta.
Esquema de la respuesta: VehicleDto
Sobre: VehicleResponse. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag
Vehículo de la flota. No incluye costes operativos ni ajustes de precios.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del vehículo.
Nombre del vehículo.
Estado operativo: active (disponible), maintenance (en el taller) o inactive (fuera de servicio).
Opciones disponibles: active, maintenance, inactive
Número de registro; null si no consta.
Plazas, incluido el asiento del conductor; null si no consta.
Carga útil en kilogramos; null si no se ha registrado.
Fecha de la próxima inspección técnica en ISO 8601 UTC; null si no consta.
Identificador de la colección a la que pertenece; null si no está en ninguna.
Ruta de la colección; null si no aplica.
true si aparece en el planificador de la cuenta.
Fecha de creación en ISO 8601 UTC; null si no consta.
Fecha de la última modificación en ISO 8601 UTC; null si no está registrada.
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
Vehículo
Vehículo de la flota.
¿Te ha resultado útil esta página?