Primeiros Passos
Referência da API
Referência completa para todos os endpoints da API Emailit v2, formatos de requisição e esquemas de resposta.
URL Base
Todas as requisições da API devem ser feitas para a seguinte URL base. Suportamos apenas requisições HTTPS seguras.
Nossa versão atual da API é a v2 com a seguinte URL base:
Autenticação
A API Emailit v2 utiliza chaves de API para autenticar requisições. Você pode visualizar e gerenciar suas chaves de API no Painel Emailit.
Suas chaves de API possuem muitos privilégios, portanto mantenha-as seguras! Não compartilhe suas chaves de API secretas em áreas publicamente acessíveis como GitHub, código do lado cliente, e assim por diante.
Limites de taxa
Nossa API v2 e SMTP possui um limite inicial de 2 mensagens por segundo para novos espaços de trabalho. Você sempre pode solicitar um limite maior no Painel Emailit.
Cada espaço de trabalho também possui um limite inicial de 5000 mensagens por dia.
Códigos de resposta
A API utiliza códigos de resposta HTTP convencionais para indicar sucesso ou falha.
| Código de Status | Descrição |
|---|---|
| 200 | OK - A requisição foi bem-sucedida |
| 400 | Requisição Inválida - Parâmetros de requisição inválidos |
| 401 | Não Autorizado - Chave de API inválida ou ausente |
| 403 | Proibido - Acesso negado ao recurso solicitado |
| 404 | Não Encontrado - O recurso solicitado não existe |
| 429 | Muitas Requisições - Limite de taxa excedido |
| 500 | Erro Interno do Servidor - Algo deu errado do nosso lado |