API & Integrações

Q: A API tem um ambiente de sandbox?

Sim. O DUO tem um sandbox completo com os mesmos endpoints de produção — sem envios reais, sem custos. A API Key de sandbox é gerada automaticamente na criação da conta e pode ser usada para testar todos os fluxos de integração.

Q: Como funciona a autenticação da API?

A API usa autenticação por API Key passada no header Authorization: Bearer sk_live_... . Podes criar múltiplas API Keys com permissões diferentes (email only, SMS only, full access) e rotá-las sem downtime diretamente na plataforma.

Q: Quais são os limites de rate limiting?

Os limites dependem do teu plano. Os headers X-RateLimit-Limit , X-RateLimit-Remaining e X-RateLimit-Reset estão presentes em todas as respostas. Para volumes muito altos, o SMPP 3.4 suporta até 1.000 SMS/segundo sem rate limiting.

Q: Como verifico a autenticidade dos webhooks?

Cada webhook inclui o header X-DUO-Signature com uma assinatura HMAC-SHA256 do payload usando o teu webhook secret. Valida sempre a assinatura antes de processar o evento — os SDKs oficiais incluem um helper para esta validação.

Q: Existe documentação interativa da API?

Sim. A documentação completa está disponível em docs.duo.pt com interface Swagger interativa — podes testar todos os endpoints diretamente no browser com a tua API Key de sandbox.

Q: O DUO suporta SMPP para integrações de alto volume?

Sim. O DUO suporta o protocolo SMPP 3.4 para integrações de alto volume (até 1.000 SMS/segundo) com sistemas legados e plataformas de telecomunicações. Disponível nos planos Corporate SMS. Fala com a equipa para configuração.

API REST documentada, SDKs para 5 linguagens, webhooks em tempo real e conectores nativos para os principais CRMs e ERPs — tudo o que precisas para integrar o DUO.

API REST

Uma API para tudo. Email, SMS e Certificação.

API REST unificada para email marketing, SMS transacional e email certificado — com autenticação por API Key, respostas JSON consistentes e sandbox para testes. Uma integração, todos os produtos.

OpenAPI 3.0 — documentação interativa com Swagger
Autenticação por API Key com rotação automática
Sandbox completo com os mesmos endpoints de produção
Rate limiting transparente com headers de quota
Respostas JSON consistentes em todos os endpoints
Versionamento de API com retrocompatibilidade garantida

Webhooks

Eventos em tempo real. Para o teu sistema.

Recebe notificações instantâneas de qualquer evento — email entregue, aberto, SMS entregue, certificado emitido — diretamente no teu endpoint. Entrega garantida com retry automático.

Notificações instantâneas de todos os eventos DUO
Retry automático 3x em caso de falha (backoff exponencial)
Assinatura HMAC-SHA256 para verificação de autenticidade
Histórico de webhooks consultável na plataforma
Filtros por tipo de evento e produto
Teste de webhooks diretamente na plataforma

Integrações

Integra com o que já usas

Conectores nativos para os principais CRMs, ERPs e plataformas de e-commerce — sem código, sem semanas de implementação.

FAQs

Perguntas frequentes

As dúvidas mais comuns sobre a API e integrações DUO.

A API tem um ambiente de sandbox?

Sim. O DUO tem um sandbox completo com os mesmos endpoints de produção — sem envios reais, sem custos. A API Key de sandbox é gerada automaticamente na criação da conta e pode ser usada para testar todos os fluxos de integração.

Como funciona a autenticação da API?

A API usa autenticação por API Key passada no header Authorization: Bearer sk_live_.... Podes criar múltiplas API Keys com permissões diferentes (email only, SMS only, full access) e rotá-las sem downtime diretamente na plataforma.

Quais são os limites de rate limiting?

Os limites dependem do teu plano. Os headers X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset estão presentes em todas as respostas. Para volumes muito altos, o SMPP 3.4 suporta até 1.000 SMS/segundo sem rate limiting.

Como verifico a autenticidade dos webhooks?

Cada webhook inclui o header X-DUO-Signature com uma assinatura HMAC-SHA256 do payload usando o teu webhook secret. Valida sempre a assinatura antes de processar o evento — os SDKs oficiais incluem um helper para esta validação.

Existe documentação interativa da API?

Sim. A documentação completa está disponível em docs.duo.pt com interface Swagger interativa — podes testar todos os endpoints diretamente no browser com a tua API Key de sandbox.

O DUO suporta SMPP para integrações de alto volume?

Sim. O DUO suporta o protocolo SMPP 3.4 para integrações de alto volume (até 1.000 SMS/segundo) com sistemas legados e plataformas de telecomunicações. Disponível nos planos Corporate SMS. Fala com a equipa para configuração.

Pronto para integrar o DUO no teu stack?

Documentação disponível em docs.duo.pt — ou fala com a equipa para uma demo técnica.