O Que Enviámos em Janeiro de 2026

Janeiro foi um mês movimentado. Enviamos uma série de atualizações para a Firma.dev das quais estamos bastante entusiasmados, e a maioria delas veio diretamente do feedback que recebemos dos desenvolvedores construindo sobre a API.

O tema deste mês foi tornar a API mais rápida, mais flexível e mais fácil de integrar. Algumas dessas mudanças são pequenas melhorias na qualidade de vida. Outras desbloqueiam fluxos de trabalho totalmente novos. Agora estamos na versão 1.2.0, e tudo aqui está ativo hoje.

Aqui está o resumo.

Pedidos de Assinatura 40% mais Rápidos

Passamos algumas semanas investigando o desempenho e conseguimos reduzir nossa latência média de solicitação de assinatura de 820ms para cerca de 500ms. Isso é aproximadamente uma melhoria de 40% em toda a linha.

As mudanças foram principalmente trabalhos de infraestrutura. Limpamos algumas consultas de banco de dados que se tornaram ineficientes ao longo do tempo e movemos ativos estáticos para o AWS CloudFront para cache de borda. Nada revolucionário, mas o tipo de trabalho que se compõe.

Se você está incorporando assinaturas em seu produto, isso importa mais do que pode parecer. 300ms de latência não parecem muito, mas é a diferença entre um fluxo de assinatura que parece instantâneo e um que parece lento. Respostas mais rápidas significam menos fluxos abandonados e menos fricção para seus usuários.

Pedidos de Assinatura Únicos (Sem Modelo Necessário)

Anteriormente, se você queria enviar um documento para assinatura através da Firma.dev, você tinha que criar um modelo primeiro. Isso fazia sentido para fluxos de trabalho repetitivos, como contratos de trabalho ou NDAs, mas adicionava etapas desnecessárias para documentos únicos.

Agora, você pode pular o modelo inteiramente. Faça upload de um PDF diretamente, defina seus campos e destinatários na hora e envie. Uma chamada de API, sem necessidade de criação de modelo.

Isso é útil para acordos ad-hoc, contratos de uma só vez ou qualquer situação em que você não vai reutilizar a estrutura do documento. Você ainda tem todos os mesmos tipos de campo, opções de assinante e rastreamento. Você apenas não precisa configurar um modelo primeiro.

Confira o endpoint de criação de solicitação de assinatura para detalhes de implementação.

Endpoint de Criação + Envio Atômico

Falando em reduzir chamadas API: adicionamos um novo endpoint atômico que permite criar e enviar uma solicitação de assinatura em uma única chamada.

Anteriormente, você chamava o endpoint de criação e depois chamava o endpoint de envio. Duas solicitações, duas viagens de ida e volta. O novo endpoint /signing-requests/create-and-send combina ambas em uma.

Mas o verdadeiro benefício é a integridade transacional. O endpoint valida tudo antes de criar qualquer coisa. Se algo falha na validação, nada é criado e você não é cobrado. Os créditos são deduzidos apenas após a solicitação de assinatura ser criada com sucesso e os emails serem enviados.

Dos documentos: "Chamada única de API em vez de duas solicitações separadas... Dedução de crédito atômica – só cobra se tudo tiver sucesso."

Se você está construindo automações ou fluxos de trabalho de alto volume, este endpoint é mais limpo e confiável do que encadear duas chamadas juntas.

Campos Somente para Leitura

Agora você pode marcar campos como somente leitura ao criar ou atualizar uma solicitação de assinatura. Estes são campos que aparecem no documento com valores pré-preenchidos, mas que o assinante não pode editar.

Isso é útil para coisas como valores de contrato, números de referência, totais calculados ou IDs de funcionários. Qualquer coisa que o assinante precise ver para contexto, mas não deve poder alterar.

Você encontrará a propriedade read_only no endpoint de atualização abrangente. Defina-o como true em qualquer campo de texto, e ele se tornará visível, mas não editável.

Controles Granulares de Email

Adicionamos quatro novas configurações que lhe dão controle detalhado sobre quais e-mails a Firma.dev envia em seu nome:

• send_signing_email – a notificação inicial "por favor assine este documento"

• send_finish_email – a confirmação "assinatura completa"

• send_expiration_email – o lembrete quando uma solicitação está prestes a expirar

• send_cancellation_email – a notificação quando uma solicitação é cancelada

Todos os quatro têm padrão como true, então as integrações existentes funcionam exatamente como antes. Mas se você quiser enviar seus próprios e-mails de marca em vez dos nossos, agora pode desligar qualquer um ou todos esses e lidar com as notificações você mesmo.

Isso se encaixa bem com as configurações de marca branca abaixo.

Pular Termos da Firma.dev para Rotulagem Branca Completa

Há uma nova configuração em seu espaço de trabalho chamada "Aceitação de Termos Obrigatória." Quando está ativada (o padrão), os signatários têm que aceitar os termos e condições da Firma.dev antes de assinar. Quando você a desativa, essa etapa desaparece completamente.

Isso é projetado para equipes que querem uma experiência de assinatura totalmente de marca branca. Seus signatários veem sua marca, seus e-mails (se você desativou os nossos) e seus termos. A Firma.dev permanece invisível.

Se você seguir esse caminho, recomendamos ter seus próprios termos e condições em vigor. Você está assumindo a responsabilidade de informar os signatários sobre as implicações legais de sua assinatura, então certifique-se de que seus próprios T&C cobrem isso.

Combinado com os controles de e-mail acima, você pode agora executar uma experiência de assinatura completamente de marca sem qualquer interface da Firma.dev aparecendo para seus usuários finais.

Novos Guias para Desenvolvedores

Reescrevemos uma parte da nossa documentação este mês. Três novos guias foram ao ar:

Guia de Autenticação – Abrange a autenticação de chave API para solicitações de servidor para servidor, além de tokens JWT para incorporar o modelo e editores de solicitação de assinatura em seu aplicativo. Também inclui o novo fluxo de rotação de chave API com períodos de carência de 24 horas.

Guia de Limites de Taxa – Documenta todos os níveis de limite de taxa (200 solicitações/min para leituras, 120/min para escritas, e assim por diante). Nota importante aqui: os limites de taxa são por espaço de trabalho, e você pode ter espaços de trabalho ilimitados em sua conta. Isso lhe dá escalabilidade horizontal ilimitada. Se de alguma forma você precisar de limites ainda mais altos para um caso de uso específico, entre em contato com o suporte e podemos aumentá-los, mas os padrões já são construídos para volumes muito altos.

Guia de Configuração Completa – Um guia completo do início ao fim, desde a criação da conta até a assinatura incorporada. Abrange espaços de trabalho, modelos, solicitações de assinatura, editores incorporados, webhooks e gerenciamento de créditos. Se você está apenas começando, este é o lugar para começar.

Versionamento Completo da API

Introduzimos um sistema formal de versionamento este mês. A API agora usa versionamento baseado em cabeçalho via o cabeçalho X-API-Version, e estamos atualmente na v1.2.0.

A versão curta: estamos comprometidos em não quebrar sua integração. Do guia de versionamento: "Quebras de compatibilidade são introduzidas apenas em incrementos de versão principal... Mudanças não quebras de compatibilidade, como novos campos opcionais ou novos endpoints, não requerem uma nova versão."

Quando finalmente lançarmos uma v2, a versão antiga não simplesmente desaparecerá. Você receberá avisos de descontinuação nos cabeçalhos de resposta por pelo menos seis meses antes que algo seja desativado. Os cabeçalhos seguem o RFC 8594, então se você já estiver verificando os cabeçalhos Deprecation e Sunset em outras APIs, saberá o que esperar.

Por enquanto, a v1 está ativa sem descontinuação agendada. Tudo o que enviamos este mês é aditivo, então sua integração existente continua funcionando sem alterações.

Concluindo

Isso é janeiro. Muitas melhorias pequenas a médias que somam a uma API mais capaz e flexível.

Preços não mudaram. Ainda é $0,029 por envelope, pague conforme o uso, sem mínimos. Se você ainda não tentou a Firma.dev, você recebe 25 envelopes gratuitos para testar.

Vamos continuar enviando. Se há algo que você quer ver na API, nos informe.

Comece de graça – sem necessidade de cartão de crédito.