Skip to content

Atualiza cliente para a API OpenAPI atual - #83

Open
kellyson71 wants to merge 2 commits into
ivmelo:masterfrom
kellyson71:feat/openapi-3-api-update
Open

kellyson71 wants to merge 2 commits into
ivmelo:masterfrom
kellyson71:feat/openapi-3-api-update

Conversation

@kellyson71

Copy link
Copy Markdown

Contexto

O cliente ainda usa a API legada em /api/v2/, endpoints minhas-informacoes, autenticação antiga e o prefixo JWT. O contrato OpenAPI 3.1 atual usa /api/, recursos agrupados por domínio, tokens pair/refresh/verify e autenticação Bearer.

Este PR amplia e substitui a atualização parcial proposta no #80, que está sem atividade desde 2022. Também incorpora versões corrigidas das dependências cobertas pelos PRs #79 e #82.

Alterações

  • migra a base padrão e os métodos existentes para os endpoints atuais de Ensino;
  • atualiza a autenticação para POST /api/token/pair com JSON e header Bearer;
  • mantém suporte ao token de responsável, agora no endpoint e formato atuais;
  • adiciona refreshToken() e verifyToken();
  • preserva o retorno histórico de listas nos métodos existentes, desempacotando results das respostas paginadas;
  • adiciona request() para acessar qualquer endpoint presente ou futuro do OpenAPI, incluindo GET, POST e DELETE;
  • permite configurar a URL base e injetar um cliente HTTP, facilitando instalações SUAP próprias e testes;
  • atualiza Guzzle para versões suportadas (^6.5.8 || ^7.9) e regenera o lockfile sem advisories;
  • corrige e amplia a documentação;
  • adiciona testes offline com o handler simulado do Guzzle.

Validação

  • composer test
  • composer validate --strict
  • composer audit
  • lint de todos os arquivos PHP
  • git diff --check

Todos passaram localmente com PHP 8.5 e Guzzle 7.15.5.

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