Consultar ciudad
API operation: Open the endpoint in Scalar
Usa GET /countries/{country}/cities/{city} para obtener una ciudad dentro de un país. La operación es City.find.
Las solicitudes pueden usar una clave de API o un token bearer. Los roles 0 y 1 pueden acceder; la búsqueda limita la ciudad mediante ambos identificadores. El parámetro opcional params controla las relaciones country, administrator y options.
Ejemplo de SDK heredado
const response = await ordering.countries(countryId).cities(cityId).get()
El helper del SDK es cities(). Los helpers pueden variar según la versión; comprueba el paquete que utilizas.
Referencia de OpenAPI
Operación: GET /countries/{country}/cities/{city}
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
country | integer | Sí | — |
city | integer | Sí | — |
Parámetros de consulta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
params | string | No | Lista de campos separados por comas. La lista se cruza con $fillable del modelo; si está vacía o no es válida, se devuelven todos los campos. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta exitosa. El contenido de result varía según la operación y se devuelve como JSON. |
| 400 | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código. |
| 401 | Respuesta de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error: el proyecto no existe o no tiene una suscripción activa. |
| 404 | Respuesta vacía: la versión de API solicitada no está admitida. |
| 429 | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key. |
| 500 | Respuesta de error: falló la búsqueda o inicialización del proyecto. |
| 503 | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on_error = closed (cabecera Retry-After: 1). |