POST/translation

Request a translation

You can post your texts to be translated to this endpoint. A different translation job is created for each source language, target language pair. As response these jobs are returned.

Parameters

Body JSON

token:

required

string

You need access token to call this endpoint. You can retrieve it by calling /auth/login endpoint. Tokens are expired in 24 hours for security reasons.

project_id:

required

string

Id of the project translation belongs. Translation jobs will be created according to configuration settings like source language, target laguages or quality.

text_to_translate:

required

string

UTF-8 encoded test to be translated

text_type:

string

Type of the text. Possible choices are text,json,html,xliff. Default value is text

instructions:

string

Instructions for the translators

extras:

string

Custom parameters for your own usage that will be passed back with jobs

Example Response


{
  "status": "success",
  "code": 200,
  "jobs": [
    {
      "target_language_id": "en",
      "source_language_id": "tr",
      "document": {
        "text_to_translate": "Hello, this my text  that i want to be translated",
        "instructions": "",
        "extras": "",
        "word_count": 10
      },
      "created_at": {
        "sec": 1478193000,
        "usec": 756000
      },
      "updated_at": {
        "sec": 1478193000,
        "usec": 756000
      },
      "currency": "TRY",
      "code": "JOB_ab1f",
      "price": 1.5,
      "vat": 0.27
    },
    {
      "target_language_id": "fr",
      "source_language_id": "tr",
      "document": {
        "text_to_translate": "Hello, this my text  that i want to be translated",
        "instructions": "",
        "extras": "",
        "word_count": 10
      },
      "created_at": {
        "sec": 1478193000,
        "usec": 759000
      },
      "updated_at": {
        "sec": 1478193000,
        "usec": 759000
      },
      "currency": "TRY",
      "code": "JOB_663b",
      "price": 1.8,
      "vat": 0.32
    },
    {
      "target_language_id": "it",
      "source_language_id": "tr",
      "document": {
        "text_to_translate": "Hello, this my text  that i want to be translated",
        "instructions": "",
        "extras": "",
        "word_count": 10
      },
      "created_at": {
        "sec": 1478193000,
        "usec": 760000
      },
      "updated_at": {
        "sec": 1478193000,
        "usec": 760000
      },
      "currency": "TRY",
      "code": "JOB_e631",
      "price": 2,
      "vat": 0.36
    }
  ],
  "msg": "Translation is created"
}