Servicios
Obtener un servicio
Devuelve un servicio vendible por su identificador: tipo, cantidad por defecto, si está incluido en el precio del documento y qué recursos se necesitan para prestarlo.
Ejemplos de petición
curl https://app.filmo.io/api/v1/services/serv_8f2a1c \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
NO emite su coste ni el nombre interno.
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. services: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 servicio.
Límites: longitud mín. 1
Respuesta
Respuesta correcta.
Esquema de la respuesta: ServiceDto
Sobre: ServiceResponse. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag
Línea vendible que no procede del inventario: personal, transporte, jornadas de trabajo.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del servicio.
Nombre del servicio tal como lo ve el cliente.
Tipo: crew (personal), fleet (vehículos) o general.
Descripción; null si no tiene.
Cantidad que se añade por defecto a un pedido.
Si aparece como servicio planificable.
Si su importe cuenta para el total del documento.
Ruta de la colección a la que pertenece; null si no está en ninguna.
Recursos necesarios para prestarlo.
Mostrar atributos hijosOcultar atributos hijos
Lo necesario para prestarlo: personal o vehículo.
Opciones disponibles: personnel, vehicle
Cuántos hacen falta.
Límites: mín. 1
Etiquetas que debe tener el recurso asignado. Ej.: "Carné C".
Límites: máx. 20 elementos, cada uno: longitud máx. 100
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
Servicio
Línea vendible que no procede del inventario: personal, transporte, jornadas de trabajo.
¿Te ha resultado útil esta página?