Retrieve Job(s)

GET | https://[api | sandbox].strakertranslations.com/v3/translate?job_key={Job Key}

The GET method is used to view the status of any job in the system. The rate limit for getting translation method is 60 requests per hour for each access token. However, for most clients, this will not affect them as it is over 60. To substantiate a GET job call, you will need to have the job_key and your access_token.

Request Headers

API requests are authenticated by the Bearer Token.

Content-Type: multipart/form-data; charset=utf-8;
Authorization: Bearer {access_token}

Parameters

Response Example

translate/file

{
  "job": [
    {
      "workflow": "TRANSLATION",
      "job_key": "3CEB930D-5E8A-4F15-84EEF836DB762A24",
      "token": "token",
      "sl": "English",
      "review": "false",
      "purchase_order": "",
      "translated_file": [
        {
          "tl": "Chinese_Simplified",
          "download_url": "https://sandbox.strakertranslations.com/v3/translate/download?u=AAE18478-95AB-4890-9B482808448DC042"
        },
        {
          "tl": "Japanese",
          "download_url": "https://sandbox.strakertranslations.com/v3/translate/download?u=1A2C13B9-D6CC-49EB-9DF0555D59F1ACE2"
        }
      ],
      "status": "COMPLETED",
      "tj_number": "",
      "wordcount": 0,
      "created_at": "19/10/2017",
      "priority": 0,
      "reserved_word": "",
      "source_file": "sample.resx",
      "callback_uri": "http://myapi.php",
      "title": "Job title",
      "lead_time": 0,
      "tl": "Chinese_Simplified,Japanese",
      "translation_type": "file"
    }
  ]
}

translate/text

{
  "job": [
    {
      "workflow": "TRANSLATION",
      "job_key": "2BE16C84-C06F-4569-839CC566F993F9F1",
      "translated_text": [
        {
          "translation": "",
          "tl": "Japanese"
        }
      ],
      "token": "sometoken",
      "sl": "English",
      "review": "false",
      "purchase_order": "",
      "payload": "Connecting to the straker translation system is easy",
      "status": "COMPLETED",
      "tj_number": "",
      "wordcount": 0,
      "created_at": "19/10/2017",
      "priority": 0,
      "reserved_word": "",
      "callback_uri": "http://myapi.com/callback",
      "title": "Test job",
      "lead_time": 0,
      "tl": "Japanese",
      "translation_type": "text"
    }
  ]
}

Download Translation

GET | {download_url}

If the job status is COMPLETED, translated_file of each job returns collection of language (tl) and download link (download_url).

"translated_file": [
  {
    "tl": "Chinese_Simplified",
    "download_url": "https://sandbox.strakertranslations.com/v3/translate/download?u=ABCDEFG"
  }, {
    "tl": "Japanese",
    "download_url": "https://sandbox.strakertranslations.com/v3/translate/download?u=HIJKLMN"
  }
]

"translated_text": [
  {
    "translation": "",
    "tl": "Japanese"
  }
]