REST TLPP
O REST TLPP roda nativamente no AppServer: você declara rotas no código (ou via JSON), atende requisições HTTP com o objeto oRest e, quando quiser, documenta a API na trilha Doc Generate.
Os exemplos .tlpp desta seção vivem em totvs/tlpp-sample-rest — a doc ensina o conceito e aponta para o fonte completo no GitHub.
O que o REST TLPP oferece
Capacidades do produto — não é o mapa de leitura (esse está na trilha abaixo).
| Capacidade | O que resolve |
|---|---|
| Performance nativa | HTTP no AppServer, sem camada externa |
| Rotas no código | Annotations (@Get, @Post, …) ou mapeamento JSON |
| Runtime dinâmico | Subir serviços em runtime com tlpp.rest |
| Isolamento por thread | Cada requisição com seu oRest |
| Segurança HTTP | Basic Auth e OAuth2 via TlppData |
| Extensão do ciclo de vida | Callbacks (User Exits) opcionais |
Trilha sugerida
Uma ordem só — do zero à API funcionando. O menu lateral espelha essa sequência; cada bloco termina em Avisos e dicas.
| Etapa | O que você aprende | Comece em |
|---|---|---|
| 1 — Começando | Subir o servidor, Hello World, montar URLs | Quickstart |
| 2 — Servidor e rotas | Annotations, INI/JSON, rotas sem annotation | Annotations |
| 3 — oREST | Ler requisição, montar resposta, pool e utilitários | Visão geral do oRest |
| 4 — Autenticação | Basic Auth e OAuth2 via TlppData | Authorization |
| 5 — Callbacks | OnBlock, OnError, OnSend… (opcional no primeiro endpoint) | Callbacks |
| 6 — Referência | Operação do servidor REST nativo | Operação do servidor |
| 7 — Exemplos REST | Catálogo de .tlpp no repositório de samples | Exemplos do repositório |
A configuração de auth usa TlppData no servidor e métodos do oRest para inspecionar o esquema em runtime — conceitos de Pool e serviço. Você não precisa de auth para o Quickstart.
Se você já conhece REST em outros frameworks, as etapas 1–2 cobrem o que é específico do AppServer; a etapa 3 (oRest) equivale ao objeto request/response do seu framework.
Escolha um caminho
Próximo passo: Quickstart