Glossário · Programação e APIs

O que é REST?

REST: Representational State Transfer

Definição

Representational State Transfer: estilo de arquitetura descrito por Roy Fielding em 2000, em que recursos identificados por URIs são manipulados por uma interface uniforme, em geral os métodos do HTTP.

Como funciona

As restrições do REST incluem cliente-servidor, comunicação sem estado (cada requisição traz tudo o que é preciso para ser entendida), respostas que podem ir para cache, interface uniforme e sistema em camadas.

Numa API REST sobre HTTP, cada recurso tem uma URI (/ramais/2001), e os métodos expressam a ação: GET lê, POST cria, PUT substitui, PATCH altera em parte e DELETE remove. Os códigos de status (200, 201, 404, 409 e outros) dizem o resultado.

Muita API chamada de REST é, na prática, HTTP com JSON sem seguir todas as restrições. O termo virou sinônimo de “API web por recursos”.

Na prática

Requisição fictícia que ativa o siga-me de um ramal:

PATCH numa API REST
PATCH /v1/ramais/2001 HTTP/1.1
Host: api.example.com
Authorization: Bearer <token>
Content-Type: application/json

{"siga_me": "2002"}

Erro comum

Usar GET para ações que mudam estado. O GET deve ser seguro e idempotente; caches, pré-carregamento de navegadores e robôs podem repetir GETs à vontade, disparando a ação várias vezes.

Termos relacionados

Referências

Padrões e documentação

Veja também o glossário completo, o blog e os cursos da EDCA.

Cursos

Aprenda VoIP e redes com a EDCA.

Cursos sobre SIP, Wireshark e cálculo de sub-redes IPv4.

Ver os cursos

Newsletter

Receba novos artigos e termos.

Um e-mail quando houver conteúdo novo. Sem spam, e você sai quando quiser.

Assinar a newsletter