API Autentique vs SignDocs Brasil: Comparação para Desenvolvedores
O Autentique conquistou os desenvolvedores brasileiros pelo caminho mais simpático que existe: um plano gratuito generoso e um produto que funciona. Se você está lendo isto, provavelmente já usa — e está avaliando se a API acompanha o crescimento do seu produto. Esta comparação fica no terreno técnico: GraphQL vs REST, chave estática vs OAuth2, SDKs comunitários vs oficiais, ICP-Brasil condicionado vs nativo — com os pontos em que o Autentique é legitimamente forte ditos sem rodeio. (A comparação dos apps, com preços, está em Autentique vs SignDocs Brasil.)
A tabela, primeiro
| Dimensão | Autentique (API v2) | SignDocs Brasil |
|---|---|---|
| Estilo de API | GraphQL — endpoint único api.autentique.com.br/v2/graphql |
REST — recursos e verbos HTTP (/v1/signing-sessions, /v1/envelopes...) |
| Autenticação | Chave de API estática (Bearer), gerada no painel | OAuth2 client-credentials; token JWT ES256 de 15 minutos, renovado pelo SDK |
| SDKs | Comunitários (Node.js, PHP, Delphi, .NET) + coleções Postman/Altair | Seis oficiais: Node, Python, PHP, Java, C#/.NET, Go — com OAuth2 e verificação de webhook embutidas |
| Rate limit documentado | 60 requisições/minuto | Headers RateLimit-* nas respostas; cotas por operação dimensionadas em contrato |
| Sandbox | Modo sandbox para testes sem consumir documentos | Ambiente dedicado api-hml.signdocs.com.br — gratuito, fluxo completo, TTL de 7 dias |
| Autenticação do signatário | Métodos da plataforma (e-mail, WhatsApp...) | Perfil por signatário: clique, OTP, biometria com prova de vida, certificado ICP-Brasil |
| ICP-Brasil | Condicionado a planos pagos; A3 exige o aplicativo do Autentique | Nativo em todos os planos: A1 no fluxo da API, A3 via assinador desktop (Win/macOS/Linux, PKCS#11) |
| Evidências | Relatório de assinaturas da plataforma | Evidence pack .p7m (PKCS#7) + verificador público independente |
| Grátis | 20 docs/mês no plano gratuito — o mais generoso do mercado | Sandbox ilimitado p/ desenvolvimento; app com 5 docs/mês; produção da API sob medida |
As quatro diferenças que pesam em produção
1. Credencial estática vs token de 15 minutos
A chave estática do Autentique é conveniente — e permanente: vazou, vale até alguém revogar no painel. O OAuth2 da SignDocs troca client_id/client_secret por um token que expira em 15 minutos (JWT ES256, chaves em KMS). Em auditoria de segurança, em cliente enterprise e em incidente real, essa diferença aparece. Com SDK oficial, a renovação é invisível para o seu código.
2. SDK comunitário vs SDK oficial
SDK comunitário é generosidade de desenvolvedor — até o autor mudar de emprego. SDK oficial é compromisso do fornecedor: acompanha a API, corrige junto, documenta junto. Os seis SDKs da SignDocs trazem OAuth2, tipagem dos payloads e o verificador de webhook prontos — o código que você não escreve é o código que você não mantém.
3. Autenticação do signatário como parte da API
Na SignDocs, o nível de garantia é um campo por signatário: policy.profile vai do clique (CLICK_ONLY) ao OTP, à biometria com prova de vida e ao certificado ICP-Brasil — no mesmo envelope, cada participante com o seu. É o que permite desenhar o fluxo por risco do documento em vez de por limitação da plataforma. O mapa completo está em autenticação multimétodo.
4. Evidência verificável sem depender do fornecedor
O evidence pack da SignDocs é um container PKCS#7 (.p7m) — padrão aberto, legível por ferramentas de mercado — e qualquer pessoa confere um documento no verificador público, sem conta. Prova que não depende da existência (nem da boa vontade) do fornecedor é uma pergunta que vale para qualquer plataforma — está no nosso checklist de 20 perguntas, e recomendamos fazê-la também ao Autentique.
O teste que vale mais que este artigo
Reproduza o seu fluxo principal nos dois sandboxes — os dois são gratuitos. No da SignDocs, o caminho é o quickstart de 5 minutos: credenciais de homologação, POST /oauth2/token, POST /v1/signing-sessions com o PDF em base64, webhook SIGNING_SESSION.COMPLETED com verificação HMAC. Compare o código que sobrou de cada lado, o tempo até o primeiro documento assinado e a qualidade dos erros quando você errou de propósito. Essa tarde de teste responde mais do que qualquer comparativo.
Perguntas Frequentes
A API do Autentique é REST ou GraphQL?
GraphQL. A API v2 do Autentique expõe um único endpoint GraphQL (api.autentique.com.br/v2/graphql), autenticado por chave de API estática enviada como Bearer token, com limite documentado de 60 requisições por minuto. É uma escolha de arquitetura legítima — quem já trabalha com GraphQL se sente em casa. A SignDocs Brasil segue o caminho REST: recursos e verbos HTTP convencionais (POST /v1/signing-sessions, GET /v1/transactions/{id}), que dispensam client GraphQL e casam direto com qualquer stack HTTP. A escolha entre os dois estilos é de preferência de equipe; as demais diferenças da comparação são mais objetivas.
Qual a diferença de autenticação entre as duas APIs?
O Autentique usa chave de API estática gerada no painel — simples de começar, mas a mesma credencial vale até ser revogada manualmente, o que amplia o dano de um vazamento. A SignDocs usa OAuth2 client-credentials: a aplicação troca client_id e client_secret por um bearer token JWT (ES256) que expira em 15 minutos e é renovado automaticamente pelos SDKs. Para projetos pessoais a diferença é conveniência; para auditorias de segurança e clientes enterprise, credencial de curta duração costuma ser requisito.
O Autentique tem SDKs oficiais?
Não — a documentação do Autentique lista SDKs criados pela comunidade (Node.js, PHP, Delphi, .NET), além de coleções para Postman e Altair. SDKs comunitários funcionam, mas a manutenção acompanha o tempo livre do autor, não o roadmap da API. A SignDocs mantém seis SDKs oficiais — TypeScript/Node (npm), Python (PyPI), PHP (Composer), Java (Maven), C#/.NET (NuGet) e Go — todos com autenticação OAuth2 e verificação de assinatura de webhooks embutidas, publicados e versionados pela própria plataforma.
E o plano gratuito — o Autentique não é mais generoso?
Para volume gratuito de documentos, sim — o Autentique oferece 20 documentos por mês no plano gratuito, um dos mais generosos do mercado, e reconhecemos isso sem rodeio. A comparação muda de eixo quando o assunto é integração: na SignDocs, o sandbox de homologação é gratuito e ilimitado para desenvolvimento (api-hml.signdocs.com.br, TTL de 7 dias nas entidades), e a produção via API é um plano sob medida dimensionado pelo seu volume. Já no custo pago, o próximo degrau do Autentique é o Profissional a R$ 99/mês, enquanto os planos do app da SignDocs começam em R$ 19,90/mês. Quem decide entre eles deve olhar o custo no seu volume real, não o headline do grátis.
Como as duas tratam certificado ICP-Brasil?
No Autentique, a assinatura com certificado ICP-Brasil é condicionada aos planos pagos, e o uso de token A3 requer a instalação do aplicativo do Autentique. Na SignDocs, ICP-Brasil é nativo em todos os planos: o certificado A1 do próprio signatário assina no fluxo da API (perfil DIGITAL_CERTIFICATE), e tokens A3 físicos são atendidos pelo assinador desktop multiplataforma (Windows, macOS e Linux), que conversa diretamente com o middleware PKCS#11 do fabricante.
Quando o Autentique é a escolha certa — e quando a SignDocs?
Autentique: se o seu caso é volume baixo e gratuito de documentos simples, sua equipe prefere GraphQL e você não depende de ICP-Brasil nem de SDK oficial — o produto é maduro e o plano gratuito, real. SignDocs: se a integração é o produto — você quer REST com SDKs oficiais, OAuth2 de curta duração, webhooks HMAC com retry, níveis de autenticação por signatário (do clique à biometria com prova de vida e ao ICP-Brasil nativo) e um evidence pack verificável de forma independente. O teste honesto é o mesmo de sempre: reproduza o seu fluxo nos dois sandboxes e compare o código que sobrou.
Faça o teste da tarde: seu fluxo nos dois sandboxes
Credenciais de homologação gratuitas, primeira assinatura em 5 minutos, webhooks e evidências completos — compare com o que você tem hoje.
Criar credenciais de homologação Falar com o time comercial