Automatize o Transept com a API

Crie uma chave de API pessoal em Configurações → Desenvolvedor. Ela está disponível em todos os planos, inclusive no Gratuito — não há barreiras extras, o que limita o uso é o seu saldo de palavras. Dê um nome à chave, defina uma expiração opcional e copie o segredo quando ele for exibido: ele aparece apenas uma vez e não poderá ser recuperado depois. Revogue uma chave a qualquer momento na mesma página.

As solicitações são autenticadas com a chave em um cabeçalho Authorization: Bearer tsk_live_… — apenas no cabeçalho, nunca em uma URL.

Crie um documento a partir de texto simples, HTML ou markdown, ou faça o upload de um arquivo — os mesmos formatos que o aplicativo aceita. Você também pode importar uma tabela de strings (.tstrings.json): um formato estruturado para textos de interface ou strings de jogos, onde cada string é uma unidade com uma chave estável e seu próprio contexto — uma observação sobre o que é, onde aparece, um limite de caracteres e o significado de seus placeholders. Tudo isso chega ao modelo; placeholders como {name} são protegidos contra remoção ou renomeação, e os plurais são expandidos por idioma (uma forma em inglês torna-se duas em alemão, quatro em ucraniano). Quaisquer traduções que o arquivo já contenha são importadas como estão, sem custo, e alimentam a memória de tradução imediatamente.

Uma execução em grupo traduz para vários idiomas de uma só vez. Informe o nome do documento, o Workflow ou modelo a ser usado e os idiomas de destino; o Transept cria as versões de idioma que faltarem e executa o Workflow em cada uma delas. Um único ID rastreia todo o processo — consulte-o para acompanhar o progresso de cada idioma e saber se ele está aguardando revisão.

Para repetir execuções, reenvie o arquivo atual de uma tabela de strings e o Transept identifica o que mudou: strings inalteradas mantêm suas traduções (e qualquer revisão já feita), e a execução processa apenas as unidades novas ou que foram realmente alteradas — a versão para API de Executar apenas o que mudou. Uma chamada de criação de trabalho também aceita um cabeçalho Idempotency-Key, para que uma nova tentativa após uma instabilidade na rede retorne o resultado original em vez de um segundo documento e uma segunda cobrança.

Em vez de fazer polling, registre uma URL e o Transept enviará um evento via push quando uma execução terminar ou falhar, quando uma revisão estiver pronta para análise, quando um upload terminar de ser processado e quando uma exportação estiver pronta. Cada envio contém um cabeçalho HMAC-SHA256 X-Transept-Signature: t=…,v1=… para que o seu receptor possa verificar se ele realmente veio de nós, e um endpoint com falha é tentado novamente com backoff antes de ser desativado.

Um Workflow também pode ser executado automaticamente a partir de uma automação de banco de dados do Notion: aponte o webhook da automação para a URL de gatilho e o Transept executará o Workflow na página que foi alterada. O detalhe é que um webhook do Notion nunca envia o conteúdo da página — ele apenas informa qual página disparou o gatilho. O Transept lê essa página por meio da sua conexão com o Notion, portanto, duas condições precisam ser atendidas; do contrário, cada acionamento será recusado com um erro de acesso e o card do gatilho exibirá o aviso “não foi possível ler a página do Notion”:

• Conecte o Notion ao Transept — em Configurações → Integrações. Esse é o link de OAuth único que permite ao Transept ler em seu nome.
• Compartilhe o banco de dados de origem com a integração dentro do Notion — abra o banco de dados (ou página), clique no menu •••, escolha Conexões e adicione o Transept. Conectar o Notion em Configurações não concede acesso a um banco de dados específico por si só; sem esta etapa, a conexão estará ativa, mas a página continuará inacessível.
• Acione por meio de uma alteração de propriedade, não apenas pela edição do corpo. As automações do Notion são acionadas por alterações de propriedades (e adição de páginas), portanto, editar apenas o corpo da página pode não disparar nada. O padrão mais confiável é usar uma propriedade de Status que a automação monitore — altere-a (por exemplo, para “Pronto para traduzir”) e essa mudança é o que ativará o gatilho.

A lista completa de endpoints é publicada como uma especificação OpenAPI que você pode importar no n8n, Zapier ou em um gerador de código: acesse em /public/v1/docs na sua API do Transept ou obtenha o JSON bruto em /public/v1/openapi.json. Execuções iniciadas via API cobram palavras exatamente como no editor do aplicativo.