Localize um documento markdown via API

POST /documents com content_type: "markdown" e seus idiomas de destino. O Transept divide o documento em blocos e cria uma versão para cada idioma de destino.

Em seguida, faça a estimativa e a execução como em Automatize o Transept com a API; a execução abrange todas as versões de idioma em uma única chamada.

# 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 em cada versão de idioma retorna o markdown renderizado com a estrutura preservada. Os outros formatos (json para leitura por blocos, docx, pdf, xliff, csv) estão listados na tabela de formatos de Automatize o Transept com a API.

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

Se o original for alterado futuramente, use o realinhamento em vez de reimportar: o POST /documents/{id}/resync-source mantém os blocos inalterados (e suas traduções) e marca os blocos alterados ou adicionados como desatualizados, de modo que uma execução com o comportamento de apenas atualizados afete apenas esses itens. É o equivalente em prosa do delta por chaves em Localize um catálogo de strings via API; o comportamento geral é Executar apenas o que mudou.

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