Lokalizacja dokumentu Markdown przez API

Wyślij żądanie POST /documents z content_type: "markdown" i wybranymi językami docelowymi. Transept dzieli dokument na bloki i tworzy po jednej wersji językowej dla każdego z nich.

Następnie oszacuj koszty i uruchom proces tak jak w sekcji Automatyzacja Transept za pomocą API; pojedyncze wywołanie obejmie wszystkie wersje językowe jednocześnie.

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

Wywołanie GET /documents/{id}/content?format=markdown dla każdej wersji językowej zwraca wygenerowany Markdown z nienaruszoną strukturą. Pozostałe formaty (json do odczytu poszczególnych bloków, docx, pdf, xliff, csv) znajdziesz w tabeli formatów w sekcji Automatyzacja Transept za pomocą API.

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

Gdy plik źródłowy ulegnie później zmianie, zamiast importować go ponownie, wykonaj synchronizację: POST /documents/{id}/resync-source zachowuje niezmienione bloki (wraz z ich tłumaczeniami), a zmienione lub dodane fragmenty oznacza jako nieaktualne. Dzięki temu uruchomienie procesu w trybie only-updated obejmie tylko te bloki. Jest to tekstowy odpowiednik mechanizmu keyed delta znanego z sekcji Lokalizacja katalogu ciągów znaków przez API; ogólne zasady działania opisano w artykule Przetwarzaj tylko to, co się zmieniło.

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