Módulo de Ubicaciones
El módulo de Ubicaciones (Locations) permite acceder al listado de sedes o lugares registrados en el sistema. Este módulo también utiliza la misma estructura de autenticación, paginación y respuesta estándar de la API pública.
Consultar listado paginado de ubicaciones
Función: Obtiene un listado de ubicaciones con sus datos básicos, permitiendo aplicar filtros como ciudad, país o estado, además de paginar los resultados.
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| filters[city] | string | No | Ciudad de la ubicación. Ej: San José |
| filters[country] | string | No | País de la ubicación. Ej: Costa Rica |
| filters[status] | string | No | Estado de la ubicación. Ej: activo |
| skip | integer | No | Registros a omitir. Ej: 0 |
| take | integer | Sí | Registros a retornar. Ej: 10 |
Pasos para ejecutar la consulta
-
Ingrese a:
{BASE_URL}/api/public/v1/locations -
Busque la sección locations → Listado de ubicaciones.
-
Si desea filtrar, complete los campos:
-
Ciudad
-
País
-
Estado
-
skip
-
take (obligatorio)
-
-
Pulse “Enviar petición”.
-
Si existen registros, recibirá un 200 OK con los datos de cada ubicación.
-
Si ocurre un error interno, la API responderá con 500 INTERNAL_ERROR.