Automatice Transept con la API

Cree una clave de API personal en Ajustes → Desarrollador. Está disponible en todos los planes, incluido el gratuito: no hay restricciones de acceso, el límite de uso lo define su saldo de palabras. Asigne un nombre a la clave, establezca opcionalmente una caducidad y copie el secreto cuando se muestre: aparece una sola vez y no podrá recuperarse después. Revoque una clave en cualquier momento desde la misma página.

Las solicitudes se autentican mediante la clave en un encabezado Authorization: Bearer tsk_live_… —solo en el encabezado, nunca en una URL.

Cree un documento a partir de texto sin formato, HTML o Markdown, o suba un archivo (los mismos formatos que acepta la aplicación). También puede importar una tabla de cadenas (.tstrings.json): un formato estructurado para texto de interfaz o cadenas de videojuegos, donde cada cadena es una unidad con una clave estable y su propio contexto —una nota sobre qué es, dónde aparece, el límite de caracteres y qué significan sus marcadores de posición. Toda esa información llega al modelo; los marcadores como {name} están protegidos para que no se eliminen ni se renombre, y los plurales se expanden por idioma (una forma en inglés se convierte en dos en alemán y en cuatro en ucraniano). Cualquier traducción que el archivo ya incluya se importa tal cual, de forma gratuita, y alimenta la memoria de traducción de inmediato.

Una ejecución de grupo traduce a varios idiomas a la vez. Indique el documento, el workflow o la plantilla a ejecutar y los idiomas de destino; Transept crea las versiones de idioma que falten y ejecuta el workflow en cada una. Un único ID rastrea todo el proceso: consúltelo para conocer el progreso de cada idioma y si hay alguna revisión pendiente.

Para ejecuciones recurrentes, vuelva a enviar el archivo actual de una tabla de cadenas y Transept identificará qué ha cambiado: las cadenas sin cambios conservarán sus traducciones (y cualquier revisión ya realizada), y la ejecución solo afectará a las unidades nuevas o que realmente hayan cambiado —la versión para la API de Ejecutar solo lo que ha cambiado. Las llamadas que crean tareas también aceptan un encabezado Idempotency-Key, por lo que un reintento tras un microcorte de red devolverá el resultado original en lugar de un segundo documento y una segunda factura.

En lugar de realizar sondeos, registre una URL y Transept enviará un evento push cuando una ejecución finalice o falle, cuando una revisión esté lista para su consulta, cuando termine de procesarse una subida o cuando una exportación esté preparada. Cada envío incluye un encabezado HMAC-SHA256 X-Transept-Signature: t=…,v1=… para que su receptor pueda verificar que realmente procede de nosotros; si un endpoint falla, se reintentará con una espera exponencial antes de desactivarlo.

Un Workflow también puede ejecutarse automáticamente desde una automatización de base de datos de Notion: apunte el webhook de la automatización a la URL del disparador y Transept ejecutará el Workflow en la página que haya cambiado. El inconveniente es que un webhook de Notion nunca incluye el contenido de la página; solo indica qué página se activó. Transept lee esa página a través de su conexión de Notion, por lo que deben cumplirse dos condiciones o, de lo contrario, cada activación será rechazada con un error de acceso y la tarjeta del disparador mostrará el aviso «no se pudo leer la página de Notion»:

• Conecte Notion en Transept — en Ajustes → Integraciones. Es el enlace OAuth de un solo uso que permite a Transept leer en su nombre.
• Comparta la base de datos de origen con la integración dentro de Notion — abra la base de datos (o página), haga clic en su menú •••, elija Conexiones y añada Transept. Conectar Notion en Ajustes no otorga acceso a una base de datos específica por sí solo; sin este paso, la conexión está activa pero la página seguirá sin poder leerse.
• Active la ejecución al cambiar una propiedad, no solo al editar el cuerpo. Las automatizaciones de Notion se activan con los cambios de propiedad (y la creación de páginas), por lo que editar solo el cuerpo de una página puede no activar nada. El método más fiable es usar una propiedad de Estado que la automatización supervise: cámbiela (por ejemplo, a «Listo para traducir») y ese cambio es el que activa el disparador.

La lista completa de endpoints se publica como una especificación OpenAPI que puede importar en n8n, Zapier o un generador de código: consúltela en /public/v1/docs en su API de Transept, o descargue el JSON sin procesar en /public/v1/openapi.json. Las ejecuciones iniciadas a través de la API facturan las palabras exactamente igual que el editor de la aplicación.