Localizar un documento markdown a través de la API

POST /documents con content_type: "markdown" y sus idiomas de destino. Transept divide el documento en bloques y crea una versión por cada idioma de destino.

Luego, realice la estimación y la ejecución como se describe en Automatizar Transept con la API; la ejecución se distribuye entre todas las versiones de idioma en una sola llamada.

# BASE="https://app.transept.ai/api/public/v1"; KEY from Settings → Developer
curl -s -X POST $BASE/documents \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title": "Getting started", "content_type": "markdown", "source_language": "en",
       "target_languages": ["de", "fr"],
       "content": "# Getting started\n\nInstall the app, then…"}'
# → { document_id, language_group: [ {id, target_language}, … ] }

GET /documents/{id}/content?format=markdown en cada versión de idioma devuelve el markdown renderizado conservando la estructura. Los demás formatos (json para lecturas por bloque, docx, pdf, xliff, csv) se detallan en la tabla de formatos de Automatizar Transept con la API.

curl -s "$BASE/documents/<de-version-id>/content?format=markdown" \
  -H "Authorization: Bearer $KEY"

Si el original cambia más adelante, realice una realineación en lugar de volver a importarlo: POST /documents/{id}/resync-source conserva los bloques que no han cambiado (y sus traducciones) y marca como obsoletos los bloques modificados o añadidos; de este modo, una ejecución con el comportamiento de «solo actualizaciones» únicamente afectará a estos últimos. Es el equivalente para prosa del «delta con clave» de Localizar un catálogo de cadenas a través de la API; el comportamiento general se describe en Ejecutar solo lo que ha cambiado.

# the source changed? re-align, then run only what went stale
curl -s -X POST $BASE/documents/<master>/resync-source \
  -H "Authorization: Bearer $KEY"