Espacios
Obtener un almacén o espacio
Devuelve el detalle de un almacén o espacio por su identificador, con su capacidad, superficie, comodidades y campos personalizados.
Ejemplos de petición
curl https://app.filmo.io/api/v1/spaces/spac_8f2a1c \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. spaces: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 espacio.
Límites: longitud mín. 1
Respuesta
Respuesta correcta.
Esquema de la respuesta: SpaceDetailDto
Sobre: SpaceDetailResponse. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag
Detalle de un almacén o espacio alquilable.
Mostrar atributos hijosOcultar atributos hijos
Identificador único del espacio.
Nombre del espacio.
Referencia interna del espacio, útil para casarla con sistemas externos; null si no tiene.
true si el espacio es un almacén que gestiona stock y puede ser el almacén principal de un pedido; false si es un espacio alquilable.
Identificador de la colección a la que pertenece; null si no está en ninguna.
Ruta completa de la colección, por ejemplo "Estudios > Fotografía"; null si no aplica.
Edificio en el que se encuentra; null si no aplica.
Planta en la que se encuentra; null si no aplica.
Ubicación física del espacio.
Mostrar atributos hijosOcultar atributos hijos
Dirección postal; null si no se ha registrado.
Municipio; null si no está registrado.
Código postal; null si no se ha registrado.
País; null si no consta.
Latitud en grados decimales; null si no está geolocalizado.
Longitud en grados decimales; null si no está geolocalizado.
Fecha de creación en ISO 8601 UTC.
Fecha de la última modificación en ISO 8601 UTC.
Descripción del espacio; null si no tiene.
Capacidad en personas; null si no está definida.
Superficie en metros cuadrados; null si no está definida.
Dimensiones en texto libre; null si no están definidas.
Servicios adicionales disponibles (wifi, proyector...).
Equipamiento fijo disponible en el espacio.
Precios de alquiler del espacio; null si no está configurado. Los mismos campos que acepta PATCH /pricing.
Mostrar atributos hijosOcultar atributos hijos
Modo de precio; null si no está configurado.
Opciones disponibles: periodPrice, fixedPrice, pricingStructure
Precio base de alquiler como cadena decimal; null si no está configurado.
Límites: patrón ^-?\d+\.\d{2}$
Unidad de periodo del precio; null si no está configurada.
Opciones disponibles: hour, day, week, month
Si el espacio admite seguro.
Si el espacio admite descuento.
Importe de la fianza como cadena decimal; null si no está definido.
Límites: patrón ^-?\d+\.\d{2}$
Margen de tiempo reservado ANTES del alquiler; null si no hay.
Unidad del margen previo; null si no hay.
Opciones disponibles: hour, day
Margen de tiempo reservado DESPUÉS del alquiler; null si no hay.
Unidad del margen posterior; null si no hay.
Opciones disponibles: hour, day
Valores de los campos personalizados por identificador de campo personalizado; las definiciones están en /api.
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 relacionadasCatálogo e inventario
Espacio
Almacén o espacio alquilable de la cuenta.
¿Te ha resultado útil esta página?