Saltar al contenido principal

Modelo de ciudades

Una ciudad pertenece a un país y puede asociarse con un administrador y opciones desplegables. Consulta la operación para los esquemas completos de las operaciones; esta guía resume los conceptos compartidos del comportamiento descrito.

Operaciones​

AcciónMétodoRecurso
ListarGET/countries/{country}/cities
ConsultarGET/countries/{country}/cities/{city}
CrearPOST/countries/{country}/cities
ActualizarPUT/countries/{country}/cities/{city}
EliminarDELETE/countries/{country}/cities/{city}

Conceptos compartidos​

  • name es obligatorio al crear una ciudad y puede usarse en filtros compatibles.
  • country_id identifica el país al que pertenece la ciudad. En las solicitudes de creación y actualización, country_id se obtiene del parámetro de ruta antes de validar.
  • administrator_id puede asociar un usuario con la ciudad y puede ser null.
  • enabled controla el estado de la ciudad.
  • country, administrator y options son relaciones que las solicitudes de lista y consulta pueden expandir mediante params.

Las operaciones descritas de ciudades usan middleware para los niveles de rol 0 y 1. No des por hecho que haya un acceso más amplio. La presencia de campos varía por operación y relaciones solicitadas, por lo que esta lista no es un esquema completo de respuesta.