Skip to content

fix: corrige erros estruturais, identação, semânticos e de validação#5

Open
gfLobo wants to merge 2 commits into
augusto-herrmann:mainfrom
gfLobo:patch-1
Open

fix: corrige erros estruturais, identação, semânticos e de validação#5
gfLobo wants to merge 2 commits into
augusto-herrmann:mainfrom
gfLobo:patch-1

Conversation

@gfLobo

@gfLobo gfLobo commented Mar 19, 2026

Copy link
Copy Markdown

Atual

O swagger estava reclamando um pouco dos caracteres especiais e métodos com mesmo nome.

image

Em: https://forge.etsi.org/swagger/editor/

Structural error at paths./eleicao/estados/{ano}/ano.get.responses.200.content.application/json.schema.items
should NOT have additional properties
additionalProperty: uf
Jump to line 170

Semantic error at paths./eleicao/ordinarias.get.responses.200.content.application/json.schema.items.$ref
$ref values must be RFC3986-compliant percent-encoded URIs
Jump to line 251

Semantic error at paths./eleicao/suplementares/{ano}/{uf}.get.operationId
Operations must have unique operationIds.
Jump to line 261

Semantic error at paths./eleicao/suplementares/{ano}/{uf}.get.responses.200.content.application/json.schema.items.$ref
$ref values must be RFC3986-compliant percent-encoded URIs
Jump to line 285

Semantic error at components.schemas.Eleição
Component names can only contain the characters A-Z a-z 0-9 - . _
Jump to line 1051

image

Em: https://editor.swagger.io/


Correções

  • Resolve erro estrutural em /eleicao/estados/{ano}/ano definindo corretamente items como um objeto com a propriedade uf, em vez de passar a propriedade diretamente no array.
  • Renomeia o schema Eleição para Eleicao em components.schemas, pois nomes de componentes suportam apenas caracteres A-Z a-z 0-9 - . _
  • Corrige os apontamentos de $ref em /eleicao/ordinarias e /eleicao/suplementares/{ano}/{uf} para usar #/components/schemas/Eleicao, resolvendo o erro de URI não compatível com a RFC3986 (remoção de caracteres especiais).
  • Altera o operationId da rota /eleicao/suplementares/{ano}/{uf} para garantir unicidade, resolvendo o conflito com a rota /eleicao/estados/{ano}/ano que utilizava o mesmo id (eleicoes_suplementares_estados).

gfLobo added 2 commits March 19, 2026 15:08
- Resolve erro estrutural em `/eleicao/estados/{ano}/ano` definindo
  corretamente `items` como um objeto com a propriedade `uf`, em vez de
  passar a propriedade diretamente no array.
- Renomeia o schema `Eleição` para `Eleicao` em `components.schemas`, 
  pois nomes de componentes suportam apenas caracteres A-Z a-z 0-9 - . _
- Corrige os apontamentos de `$ref` em `/eleicao/ordinarias` e 
  `/eleicao/suplementares/{ano}/{uf}` para usar `#/components/schemas/Eleicao`,
  resolvendo o erro de URI não compatível com a RFC3986 (remoção de caracteres especiais).
- Altera o `operationId` da rota `/eleicao/suplementares/{ano}/{uf}` 
  para garantir unicidade, resolvendo o conflito com a rota `/eleicao/estados/{ano}/ano` 
  que utilizava o mesmo id (`eleicoes_suplementares_estados`).
@gfLobo gfLobo changed the title fix: corrige erros estruturais e semânticos de validação fix: corrige erros estruturais, identação e semânticos de validação Mar 19, 2026
@gfLobo gfLobo changed the title fix: corrige erros estruturais, identação e semânticos de validação fix: corrige erros estruturais, identação, semânticos e de validação Mar 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant