Lokalizace markdownového dokumentu přes API

Použijte POST /documents s content_type: "markdown" a cílovými jazyky. Transept dokument rozdělí na bloky a pro každý cílový jazyk vytvoří samostatnou verzi.

Poté proveďte odhad a spusťte proces podle návodu Automatizace Transeptu přes API; spuštění se v rámci jednoho volání provede pro všechny jazykové verze najednou.

# 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}, … ] }

Volání GET /documents/{id}/content?format=markdown pro každou jazykovou verzi vrátí vygenerovaný markdown se zachovanou strukturou. Ostatní formáty (json pro čtení po blocích, docx, pdf, xliff, csv) jsou uvedeny v tabulce formátů v části Automatizace Transeptu přes API.

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

Pokud se zdroj později změní, místo nového importu použijte synchronizaci: POST /documents/{id}/resync-source zachová nezměněné bloky (včetně jejich překladů) a změněné či přidané bloky označí jako neaktuální. Spuštění v režimu „pouze aktualizované“ (only-updated) pak zpracuje jen tyto části. Jde o textový protějšek delty založené na klíčích z článku Lokalizace katalogu řetězců přes API; obecný princip je popsán v části Zpracovat pouze změny.

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