City CRUD

[StPfeffer]

Description

Implementação de DTOs, rotas e funções para criar, listar, buscar e excluir cidades.

Endpoints

Método	Endpoint	Descrição
GET	/api/v1/cities	Lista todas as ciadades.
GET	/api/v1/cities/:cityId	Retorna a cidade referente ao ID informado.
POST	/api/v1/cities	Cria uma cidade.
DELETE	/api/v1/cities/:cityId	Exclui a cidade referente ao ID informado.

Payloads

Listar todas as cidades

Response

{
    "cities": [
        {
            "id": "7e091854-6042-4bf5-9349-de87b0909193",
            "name": "Cascavel",
            "code": "4104808",
            "stateId": "db05796f-5979-4f93-ba92-06f8577b703b"
        }
    ],
    "results": 1
}

Buscar uma cidade

Response

{
    "id": "7e091854-6042-4bf5-9349-de87b0909193",
    "name": "Cascavel",
    "code": "4104808",
    "stateId": "db05796f-5979-4f93-ba92-06f8577b703b"
}

Criar uma cidade

Request

{
    "name": "Cascavel",
    "code": "4104808",
    "stateId": "db05796f-5979-4f93-ba92-06f8577b703b"
}

Response

{
    "id": "7e091854-6042-4bf5-9349-de87b0909193",
    "name": "Cascavel",
    "code": "4104808",
    "stateId": "db05796f-5979-4f93-ba92-06f8577b703b"
}

Excluir uma cidade

Response

{
    "id": "7e091854-6042-4bf5-9349-de87b0909193",
    "name": "Cascavel",
    "code": "4104808",
    "stateId": "db05796f-5979-4f93-ba92-06f8577b703b"
}

Type of change

• [x] New feature (non-breaking change which adds functionality)

Checklist

• [x] I ran cargo clippy --all -- -D warnings just before my last commit and fixed any issue that was found.
• [x] I ran cargo fmt just before my last commit.
• [x] I ran cargo test just before my last commit and all tests passed.
• [x] I added my algorithm to the corresponding mod.rs file within its own folder, and in any parent folder(s).