Guia por tema

Design de APIs

Design de APIs robustas: princípios REST, trade-offs do GraphQL, versionamento, autenticação, webhooks e idempotência em integrações reais.

3 tópicos · 11 artigos

Design de APIs REST

Recursos, verbos HTTP, códigos de status e versionamento.

GraphQL vs. REST

Trade-offs e quando usar cada um.

Autenticação e integrações

Tokens, webhooks e chamadas que podem ser repetidas com segurança.

Perguntas frequentes

REST ou GraphQL?

REST é mais simples e aproveita cache HTTP; GraphQL é flexível, mas mais complexo de operar. Para a maioria dos casos, comece com REST.

GraphQL é complexo demais?

Para times pequenos, geralmente sim. Ele compensa quando há muitos clientes com necessidades de dados diferentes consumindo a mesma API.

Como versionar uma API REST?

Versão na URL (/v1/, /v2/) é a forma mais clara para quem consome. Versão por header é uma alternativa quando você quer URLs estáveis.

Quando usar gRPC?

Na comunicação interna entre serviços, onde performance e contratos tipados importam. Para APIs públicas, prefira REST: gRPC exige HTTP/2 e payload binário.