Localizzare un documento markdown tramite API

Invia una richiesta POST /documents con content_type: "markdown" e le tue lingue di destinazione. Transept suddivide il documento in blocchi e crea una versione per ogni lingua di destinazione.

Quindi procedi con la stima e l'esecuzione come descritto in Automatizzare Transept tramite API; l'esecuzione coinvolge tutte le versioni linguistiche con un'unica chiamata.

# 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 per ogni versione linguistica restituisce il markdown renderizzato con la struttura intatta. Gli altri formati (json per la lettura dei singoli blocchi, docx, pdf, xliff, csv) sono elencati nella tabella dei formati di Automatizzare Transept tramite API.

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

Se il sorgente viene modificato in un secondo momento, riallinea invece di reimportare: POST /documents/{id}/resync-source mantiene i blocchi invariati (e le relative traduzioni) e contrassegna come obsoleti quelli modificati o aggiunti; un'esecuzione con comportamento only-updated agirà solo su questi ultimi. È il corrispettivo per la prosa del delta basato su chiavi in Localizzare un catalogo di stringhe tramite API; il comportamento generale è descritto in Eseguire solo ciò che è cambiato.

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