Versions Compared

Old Version 6

changes.mady.by.user External Developers (Wordbee)

Saved on

compared with

New Version 7

changes.mady.by.user Stephan Böhmig

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Parameters are included as a JSON object in the request body:

files

Mandatory.

The selected files to be downloaded

A list of the previously uploaded files that you submit for translation.

Each file is listed with its file token and the file format ID to use.

Example:

Code Block
[
  {
    "token": "3e896bb7812d48e780a119adf39c6dd0",
    "parserId": 1235
  },
  {
    "token": "3e896bb7812d48e780a119adf39c6dd0",
    "parserId": 231
  }
]

See below on how to upload files and obtain the file tokens.

object[], Mandatory
src

The source language code. Make sure to only use source languages according to the MTHive

form

configuration.

string, Mandatory
trgMandatory. The target language code. Make sure to only use target languages according to the
MTHive form
MT Hive configuration.string, Mandatory
profileOptionIdx

The option index for the selected Mt Hive configuration (Zero-based index).

MT Hive lets you specify multiple profiles, see "Settings" > "MT Hive". 

int, Mandatory

FILES AND CONFIGURATIONS

The API requires a file token and a format ID. The former references a previously uploaded file. The latter the file filter configuration ID (or format ID) to use for processing.

To upload a file use this API method: media/upload. It returns a token that you would include with the payload (see files above).

The parserId field designates the file filter configuration to use to process the file. You find the available options for each type of file in the configuration under node /options/formats/{file type}/foptions[*]/foption

Example:

Image Added

Here a single option (2266) is available for Microsoft Word files. Since the configuration lists the supported file extensions, it is relatively easy to automate a lookup mechanism in code.

 Using an ID that does not exist will result in a failure.

RESULTS

The method executes asynchronously. It returns the operation ID which is a number.

...