Avisos e dicas

Servidor e rotasRevise estes pontos antes de avançar para a próxima seção.

Path parameters

O nome da variável em :param é fixado pela primeira rota registrada no mesmo path base. Rotas subsequentes devem reutilizar o mesmo nome.

@Get("users/:id")     // registra :id
@Get("users/:userId") // ERRADO — nome diferente no mesmo path base

Annotation vs metadados OpenAPI

statusCode em responses na annotation é descritivo para a documentação. O status HTTP real depende de oRest:setStatusResponse() no código.

Roteamento fica nesta seção; enriquecer a spec OpenAPI é trilha Doc Generate.

Autenticação vem depois

Basic Auth e OAuth2 são configurados em TlppData — leia Autenticação após a seção oREST (em especial Pool e serviço).

Próximo passo: Visão geral do oRest