Obtener Ciudades
GEThttps://{environment}.metrocuadrado.com/rest-catalogue/cities/?regionId={Id}
Obtiene el listado de ciudades disponibles para una región específica.
Ambientes Disponibles
| Ambiente | URL Base |
|---|---|
| Desarrollo | https://ptec-core-dev.metrocuadrado.com/rest-catalogue/cities/?regionId={Id} |
| Producción | https://www.metrocuadrado.com/rest-catalogue/cities/?regionId={Id} |
Parámetros de Query
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| regionId | integer | Sí | ID de la región a consultar |
Autenticación
| Header | Valor | Requerido |
|---|---|---|
| Content-Type | application/json | Sí |
| x-api-key | string | Sí |
Ejemplos
- Request
- 200 OK
- 401 Unauthorized
curl -X GET \
'https://ptec-core-dev.metrocuadrado.com/rest-catalogue/cities/?regionId=1' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
{
"data": [
{
"id": 4268,
"name": "Leticia",
"regionId": 1
},
{
"id": 4269,
"name": "El Encanto",
"regionId": 1
}
]
}
{
"message": "No API key found in request"
}
Notas Importantes
- Solo requiere API key, no necesita token JWT
- La API Key debe corresponder al ambiente seleccionado
- El parámetro regionId es obligatorio
- El listado de ciudades puede variar según la región seleccionada
Códigos de Respuesta
| Código | Descripción |
|---|---|
| 200 | Listado de ciudades obtenido |
| 401 | API Key inválida o faltante |
Probar Endpoint
API Tester
Prueba los endpoints de forma interactiva