O Que Enviámos em Janeiro de 2026

Janeiro foi um mês movimentado. Lançámos uma série de atualizações para a Firma.dev que estamos muito entusiasmados, e a maioria delas veio diretamente do feedback que recebemos de desenvolvedores que constroem na 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 de qualidade de vida. Outras desbloqueiam completamente novos fluxos de trabalho. Estamos agora na versão 1.2.0, e tudo aqui está disponível hoje.

Aqui está o resumo.

Pedidos de Assinatura 40% Mais Rápidos

Passámos algumas semanas a aprofundar o desempenho e conseguimos reduzir a latência média dos pedidos de assinatura de 820ms para cerca de 500ms. Isso é aproximadamente uma melhoria de 40% em toda a linha.

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

Se está a integrar assinaturas no seu produto, isso importa mais do que pode parecer. 300ms de latência não soa 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 os seus utilizadores.

Pedidos de Assinatura Únicos (Sem Necessidade de Modelo)

Anteriormente, se quisesse enviar um documento para assinatura através da Firma.dev, tinha de criar um modelo primeiro. Isso fazia sentido para fluxos de trabalho repetíveis como contratos de trabalho ou NDAs, mas acrescentava etapas desnecessárias para documentos únicos.

Agora pode pular completamente o modelo. Faça upload de um PDF diretamente, defina os seus campos e destinatários em linha, e envie-o. Um chamado à API, sem necessidade de criação de modelo.

Isso é útil para acordos ad-hoc, contratos únicos, ou qualquer situação em que não vai reutilizar a estrutura do documento. Ainda tem todos os mesmos tipos de campo, opções de signatário, e acompanhamento. Apenas não precisa configurar um modelo primeiro.

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

Endpoint de Criação + Envio Atômico

Falando de reduzir chamadas à API: adicionamos um novo endpoint atômico que lhe permite criar e enviar um pedido de assinatura em uma única chamada.

Anteriormente chamava o endpoint de criação, depois o endpoint de envio. Duas solicitações, duas idas e voltas. O novo endpoint /signing-requests/create-and-send combina ambos em um só.

Mas o verdadeiro benefício é a integridade transacional. O endpoint valida tudo antes de criar qualquer coisa. Se algo falhar na validação, nada é criado e não lhe é cobrado. Créditos são apenas deduzidos depois que o pedido de assinatura é criado com sucesso e os e-mails são enviados.

Dos docs: "Uma única chamada de API em vez de duas solicitações separadas... Dedução de crédito atômico – só cobra se tudo for bem-sucedido."

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

Campos Apenas de Leitura

Agora pode marcar campos como apenas de leitura ao criar ou atualizar um pedido de assinatura. Esses são campos que aparecem no documento com valores pré-preenchidos, mas o signatário não pode editá-los.

Isso é útil para coisas como montantes de contrato, números de referência, totais calculados ou IDs de funcionários. Qualquer coisa que o signatário precisa ver para contexto mas não deve ser capaz de 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 controlo preciso 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 um pedido está prestes a expirar

• send_cancellation_email – a notificação quando um pedido é cancelado

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

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

Ignorar Termos da Firma.dev para Total Marca Branca

Há uma nova configuração no seu espaço de trabalho chamada "Requerir Aceitação de Termos." Quando está ativada (o padrão), os signatários têm de aceitar os termos e condições da Firma.dev antes de assinar. Quando desativá-la, essa etapa desaparece completamente.

Isso é projetado para equipas que desejam uma experiência de assinatura totalmente de marca branca. Os seus signatários veem a sua marca, os seus e-mails (se desativou os nossos), e os seus termos. A Firma.dev fica invisível.

Se optar por este caminho, recomendamos ter seus próprios termos e condições em vigor. Assumirá a responsabilidade de informar os signatários sobre as implicações legais da sua assinatura, então certifique-se de que seus próprios T&Cs cobrem isso.

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

Novos Guias para Desenvolvedores

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

Guia de Autenticação – Cobre autenticação de chave API para solicitações de servidor para servidor, além de tokens JWT para incorporar os editores de modelo e pedidos de assinatura na sua aplicação. 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 na sua conta. Isso lhe dá escalabilidade horizontal efetivamente ilimitada. Se, de alguma forma, precisar de limites ainda mais elevados para um caso de uso específico, entre em contato com o suporte e podemos aumentá-los, mas os padrões já estão organizados para volumes muito altos.

Guia Completo de Configuração – Um guia completo de ponta a ponta, desde a criação de conta até a assinatura incorporada. Cobre espaços de trabalho, modelos, pedidos de assinatura, editores incorporados, webhooks e gestão de créditos. Se está começando agora, 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 a não quebrar sua integração. Do guia de versionamento: "Mudanças quebra-integridade são introduzidas apenas em incrementos de versão principal... Mudanças não quebra-integridade, como novos campos opcionais ou novos endpoints, não exigem uma nova versão."

Quando lançarmos eventualmente uma v2, a versão antiga não desaparecerá simplesmente. Você receberá avisos de descontinuação nos cabeçalhos de resposta por pelo menos seis meses antes de qualquer coisa ser descontinuada. Os cabeçalhos seguem RFC 8594, portanto, se já estiver verificando cabeçalhos Deprecation e Sunset em outras APIs, saberá o que esperar.

Por agora, a v1 está ativa sem qualquer descontinuação programada. Tudo o que lançámos este mês é aditivo, então sua integração existente continua a funcionar sem mudanças.

Conclusão

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

Preços não mudaram. Ainda é €0.029 por envelope, pago conforme o uso, sem mínimos. Se ainda não experimentou a Firma.dev, recebe 25 envelopes gratuitos para testar.

Vamos continuar a lançar novidades. Se houver algo que gostaria de ver na API, avise-nos.

Comece agora gratuitamente – não é necessário cartão de crédito.