SDKs · Go
SDK Go
Go 1.24+, context em toda chamada e iteradores para paginar.
Instalação
Adicione o pacote ao projeto.
terminal
Configurar o cliente
A chave vem de COFFEEMAIL_API_KEY ou do construtor. Use uma chave por ambiente.
cliente
Enviar um email
O envio entra na fila e volta em milissegundos com o id e o status queued. Retorno: (*T, error).
Os métodos devolvem (*T, error), no idioma do Go: confira err antes de usar o valor. Erros da API são *coffeemail.Error e combinam com errors.Is (ErrNotFound, ErrRateLimited…).
enviar
Tratar erros
Erros da API chegam tipados, com code, status e requestId; nada é lançado no caminho comum.
erros
Paginar
Listas devolvem a página e o cursor nextCursor; passe-o em after para buscar a próxima.
paginar
Verificar webhooks
Valide x-webhook-signature com o corpo bruto da requisição, x-webhook-timestamp e x-webhook-idempotency-key. A janela padrão é de 300 segundos.
O subpacote webhook verifica a assinatura. Para conferir à mão: sha256= + HMAC-SHA256, em hex, de "timestamp.idempotencyKey.corpo" com o segredo whsec_, comparado em tempo constante.
webhook
Referência de métodos
Todos os métodos públicos, agrupados por recurso. Cada linha mostra o endpoint chamado; abra a referência da API para ver campos e respostas.
Emails8 métodos
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Emails.Send(ctx, …) | POST/emails |
client.Emails.SendBatch(ctx, …) | POST/emails/batch |
client.Emails.Get(ctx, …) | GET/emails/{id} |
client.Emails.List(ctx, …) | GET/emails |
client.Emails.GetEvents(ctx, …) | GET/emails/{id}/events |
client.Emails.GetTags(ctx, …) | GET/emails/tags |
client.Emails.Cancel(ctx, …) | POST/emails/{id}/cancel |
client.Emails.Resend(ctx, …) | POST/emails/{id}/resend |
Domínios10 métodos
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Domains.Create(ctx, …) | POST/domains |
client.Domains.List(ctx, …) | GET/domains |
client.Domains.Get(ctx, …) | GET/domains/{id} |
client.Domains.Verify(ctx, …) | POST/domains/{id}/verify |
client.Domains.Delete(ctx, …) | DELETE/domains/{id} |
client.Domains.GetHealth(ctx, …) | POST/domains/{id}/health |
client.Domains.GetWarmupStatus(ctx, …) | GET/domains/{id}/warmup |
client.Domains.RotateDKIM(ctx, …) | POST/domains/{id}/dkim/rotate |
client.Domains.SetTrackingDomain(ctx, …) | PUT/domains/{id}/tracking-domain |
client.Domains.RemoveTrackingDomain(ctx, …) | DELETE/domains/{id}/tracking-domain |
Modelos12 métodos
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Templates.Create(ctx, …) | POST/templates |
client.Templates.List(ctx, …) | GET/templates |
client.Templates.Get(ctx, …) | GET/templates/{id} |
client.Templates.Update(ctx, …) | PATCH/templates/{id} |
client.Templates.Delete(ctx, …) | DELETE/templates/{id} |
client.Templates.Preview(ctx, …) | POST/templates/preview |
client.Templates.Format(ctx, …) | POST/templates/format |
client.Templates.TestRender(ctx, …) | POST/templates/test-render |
client.Templates.TestSend(ctx, …) | POST/templates/{id}/test-send |
client.Templates.ListVersions(ctx, …) | GET/templates/{id}/versions |
client.Templates.GetVersion(ctx, …) | GET/templates/{id}/versions/{version} |
client.Templates.RestoreVersion(ctx, …) | POST/templates/{id}/versions/{version}/restore |
Audiências e contatos10 métodos
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Audiences.Create(ctx, …) | POST/audiences |
client.Audiences.List(ctx, …) | GET/audiences |
client.Audiences.Get(ctx, …) | GET/audiences/{id} |
client.Audiences.Update(ctx, …) | PUT/audiences/{id} |
client.Audiences.Delete(ctx, …) | DELETE/audiences/{id} |
client.Audiences.Contacts.Create(ctx, …) | POST/audiences/{id}/contacts |
client.Audiences.Contacts.List(ctx, …) | GET/audiences/{id}/contacts |
client.Audiences.Contacts.BulkAdd(ctx, …) | POST/audiences/{id}/contacts/bulk |
client.Audiences.Contacts.Update(ctx, …) | PUT/audiences/{id}/contacts/{contactId} |
client.Audiences.Contacts.Delete(ctx, …) | DELETE/audiences/{id}/contacts/{contactId} |
Campanhas6 métodos
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Broadcasts.Create(ctx, …) | POST/broadcasts |
client.Broadcasts.List(ctx, …) | GET/broadcasts |
client.Broadcasts.Get(ctx, …) | GET/broadcasts/{id} |
client.Broadcasts.Send(ctx, …) | POST/broadcasts/{id}/send |
client.Broadcasts.TestSend(ctx, …) | POST/broadcasts/{id}/test-send |
client.Broadcasts.Cancel(ctx, …) | POST/broadcasts/{id}/cancel |
Remetentes5 métodos
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Senders.Create(ctx, …) | POST/senders |
client.Senders.List(ctx, …) | GET/senders |
client.Senders.Verify(ctx, …) | POST/senders/verify |
client.Senders.ResendVerification(ctx, …) | POST/senders/{id}/resend-verification |
client.Senders.Delete(ctx, …) | DELETE/senders/{id} |
Supressões6 métodos
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Suppressions.Create(ctx, …) | POST/suppressions |
client.Suppressions.List(ctx, …) | GET/suppressions |
client.Suppressions.Get(ctx, …) | GET/suppressions/{id} |
client.Suppressions.Delete(ctx, …) | DELETE/suppressions/{id} |
client.Suppressions.Reactivate(ctx, …) | POST/suppressions/{id}/reactivate |
client.Suppressions.BulkCreate(ctx, …) | POST/suppressions/bulk |
Webhooks11 métodos
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Webhooks.Create(ctx, …) | POST/webhooks |
client.Webhooks.List(ctx, …) | GET/webhooks |
client.Webhooks.Get(ctx, …) | GET/webhooks/{id} |
client.Webhooks.Update(ctx, …) | PUT/webhooks/{id} |
client.Webhooks.Toggle(ctx, …) | PATCH/webhooks/{id} |
client.Webhooks.Delete(ctx, …) | DELETE/webhooks/{id} |
client.Webhooks.RotateSecret(ctx, …) | POST/webhooks/{id}/rotate-secret |
client.Webhooks.ListDeliveries(ctx, …) | GET/webhooks/{id}/deliveries |
client.Webhooks.Test(ctx, …) | POST/webhooks/{id}/test |
client.Webhooks.GetDelivery(ctx, …) | GET/webhooks/{id}/deliveries/{deliveryId} |
client.Webhooks.ReplayDelivery(ctx, …) | POST/webhooks/{id}/deliveries/{deliveryId}/replay |
Estatísticas1 método
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Stats.Get(ctx, …) | GET/stats |
Validação1 método
Endpoints →| Método | Endpoint chamado |
|---|---|
client.Validation.Validate(ctx, …) | POST/validate |