Endpoint

Definição

Um endpoint é o ponto de acesso a uma operação ou recurso de um serviço. Em uma API web, ele vive dentro do endereço usado na chamada: o caminho identifica o recurso, e o método expressa a operação pretendida.

GET /clientes/42 HTTP/1.1
Host: api.exemplo.com

Caminho e método formam a operação

A URL sozinha pode não distinguir a operação. A convenção combina caminho e método: GET /clientes consulta, POST /clientes cria, DELETE /clientes/42 remove. É o par formado por caminho e método que define o contrato daquele ponto de acesso.

O endpoint dentro do contrato

Endpoints ganham sentido quando a API documenta o formato de entrada, a resposta esperada e os status possíveis. Com esse contrato, o consumidor sabe qual caminho usar para cada recurso e qual resultado esperar em cada situação.

O que pode falhar na chamada

A falha mais comum é acertar o caminho e errar o método, ou vice-versa. Pedir DELETE em um recurso que a API trata como consulta devolve uma resposta fora do contrato, e chamar POST em um caminho que só aceita GET produz um erro de permissão. Para conferir, teste o par de caminho e método no navegador ou em uma ferramenta de requisições e compare o status recebido com a documentação. Um 404 com o caminho correto indica recurso inexistente, enquanto um 405 indica que o método não pertence àquele endpoint.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Na Formação Vibe Coding, o endpoint define o endereço que a interface usa para alcançar cada operação do backend.

Conhecer a formação →