Glossário
API RESTful
API RESTful
A API RESTful (REpresentational State Transfer) é um tipo de API baseada na web que segue um conjunto de princípios para criar uma comunicação escalável e sem estado entre sistemas. É uma das maneiras mais comuns de os aplicativos solicitarem ou manipularem dados pela internet, geralmente via HTTP.
Na infraestrutura de e-mail, as APIs RESTful costumam ser usadas para:
- Enviar e-mails transacionais ou de marketing por meio de um ESP
- Recuperar logs e análises (por exemplo, devoluções, aberturas, cliques)
- Gerenciar listas de e-mails e supressões
- Monitorar o desempenho da entregabilidade de forma programática
As APIs REST normalmente usam quatro métodos HTTP principais:
- GET: recuperar dados
- POST: criar um novo recurso
- PUT: atualizar um recurso existente
- DELETE: remover um recurso
Por exemplo, a API de e-mail da Mailgun é RESTful. A equipe de desenvolvimento pode usar o POST para enviar uma mensagem à API da Mailgun e, segundos depois, usar o GET para obter um log de entrega para essa mesma mensagem.
O REST é flexível, agnóstico de linguagem e fácil de trabalhar – especialmente para integrar a funcionalidade de e-mail em aplicativos da web, CRMs ou ferramentas de automação de marketing.