Crear ciudad
API operation: Abrir la operación en la Referencia de la API
Usa POST /countries/{country}/cities para crear una ciudad bajo un país. La operación pública actual es City.register.
El comportamiento descrito restringe esta operación a los niveles de rol 0 y 1. Copia el valor country de la ruta en country_id antes de validar la solicitud. La Referencia de la API enumera name y country_id como campos obligatorios, aunque la ruta también proporciona el país.
Los campos opcionales del comportamiento descrito incluyen administrator_id y enabled. Consulta la operación para los esquemas completos de solicitud, respuesta y error.
Ejemplo de SDK heredado
const response = await ordering.countries(countryId).cities().save(data)
El método del SDK que se muestra es cities(); confirma el paquete y la versión del SDK antes de usarlo.
Referencia de OpenAPI
Operación: POST /countries/{country}/cities
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
country | integer | Sí | — |
Campos del cuerpo de la solicitud
| Nombre | Tipo | Obligatorio |
|---|---|---|
administrator_id | integer | null | No |
country_id | integer | Sí |
enabled | boolean | No |
name | any | Sí |
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). |