Webhooks

Webhooks offer an elegant and efficient solution for notification of job completion. For each job, the API will perform an HTTP post against the provided callback_uri on your servers. This prevents the need to ping the API to get the latest job status at regular intervals.

{ 
  job: [
    {
      job_key: "98DA46AD-9A7B-4F92-BDFC0655992A9CE2",
      token: "sometoken",
      sl: "English",
      tl: "Japanese",
      status: "COMPLETED",
      source_file : "test.xml",
      translated_file: [
        {
          "tl": "Japanese",
          "download_url": "https://sandbox.strakertranslations.com/v3/translate/download/?u=69D1EE14-6346-4BD6-827E3D881F5E0FEA"
        }
      ]
      created_at: "22/10/2014",
      callback_uri: "http://myapi.com/callback",
      title: "Test Job",
      lead_time: 48,
      translation_type: "file"
    }
  ]
}

Webhooks Security

Straker Translations will sign all inbound requests to your application with an X-Straker-Signature HTTP header.

The signature uses the HMAC-SHA1 hashing algorithm with the payloads that we send to your webhook listener and your API access_token as the secret key.