O Que Enviámos em Janeiro de 2026

Janeiro foi um mês movimentado. Enviámos uma série de atualizações para a Firma.dev que nos deixam bastante entusiasmados, e a maioria delas veio diretamente do feedback que recebemos dos desenvolvedores que estão a construir 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 de qualidade de vida. Outras desbloqueiam novos fluxos de trabalho inteiramente. Agora estamos na versão 1.2.0, e tudo aqui está em funcionamento hoje.

Aqui está o resumo.

Pedidos de Assinatura 40% Mais Rápidos

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

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

Se está a incorporar assinaturas no seu produto, isso importa mais do que pode parecer. 300ms de latência não parece 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 que criar primeiro um modelo. Isso fazia sentido para fluxos de trabalho repetíveis, como contratos de trabalho ou NDAs, mas adicionava etapas desnecessárias para documentos únicos.

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

Isto é útil para acordos ad hoc, contratos únicos ou qualquer situação onde não vai reutilizar a estrutura do documento. Ainda assim, obtém todos os mesmos tipos de campos, opções de signatário e rastreamento. Apenas não tem que configurar um modelo primeiro.

Veja o endpoint de criação de pedido de assinatura para detalhes de implementação.

Endpoint Criar + Enviar Atómico

Falando em reduzir chamadas de API: adicionámos um novo endpoint atómico que permite criar e enviar um pedido de assinatura numa única chamada.

Anteriormente, tinha que chamar o endpoint de criação e depois o endpoint de envio. Duas solicitações, duas viagens de ida e volta. O novo endpoint /signing-requests/create-and-send combina ambos numa 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 é cobrado. Os créditos só são deduzidos após o pedido de assinatura ser criado com sucesso e os emails serem enviados.

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

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. Estes são campos que aparecem no documento com valores pré-preenchidos, mas que o signatário não pode editar.

Isto é útil para coisas como valores de contrato, números de referência, totais calculados ou IDs de colaborador. Qualquer coisa que o signatário precisa ver para contexto mas que não deveria poder mudar.

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

Controles Granulares de Email

Adicionámos quatro novas definições que lhe dão controlo detalhado sobre quais emails 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 concluída"

• 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 são padrão para true, portanto, as integrações existentes funcionam exatamente como antes. Mas se quiser enviar seus próprios emails com marca em vez dos nossos, pode agora desligar qualquer ou todos eles e lidar com as notificações você mesmo.

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

Pule os Termos da Firma.dev para Etiqueta Branca Completa

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

Isso é projetado para equipas que querem uma experiência de assinatura totalmente com marca branca. Os seus signatários veem o seu branding, os seus emails (se tiver desativado os nossos), e os seus termos. A Firma.dev permanece invisível.

Se seguir esta rota, recomendamos ter seus próprios termos e condições em vigor. Está a assumir a responsabilidade de informar os signatários sobre as implicações legais da sua assinatura, portanto, certifique-se de que seus próprios T&C's cobrem isso.

Combinado com os controles de email acima, agora pode executar uma experiência de assinatura completamente com marca sem qualquer interface da Firma.dev a aparecer 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 a autenticação de chave API para solicitações server-to-server, além de tokens JWT para incorporar o editor de modelo e de pedido de assinatura na sua aplicação. Também inclui o novo fluxo de rotação de chaves 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 gravações, e assim por diante). Nota importante aqui: 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 maiores para um caso de uso específico, entre em contato com suporte e podemos aumentá-los, mas os padrões já são projetados para volumes muito altos.

Guia Completo de Configuração – Um walkthrough completo de ponta a ponta desde a criação da 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á 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 utiliza versionamento baseado em cabeçalhos através do 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 disruptivas são introduzidas apenas em incrementos de versão maior... Mudanças não disruptivas 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 desaparecerá simplesmente. Receberá avisos de descontinuação nos cabeçalhos de resposta por pelo menos seis meses antes de algo ser aposentado. Os cabeçalhos seguem o RFC 8594, então se já está a verificar 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 é adicionativo, então sua integração existente continua a funcionar sem alterações.

Concluindo

Esse foi Janeiro. Um monte de melhorias pequenas a médias que se somam a uma API mais capaz e mais flexível.

Os 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, você tem 25 envelopes gratuitos para testar.

Vamos continuar a enviar. Se há algo que gostaria de ver na API, avise-nos.

Comece gratuitamente – sem necessidade de cartão de crédito.