post https://{access_key}:{secret}@api.tolq.com/v1/translations/requests
Send the content you need to translate.
Request
{
"request": {
"a.key": {
"text": "Some text to translate",
},
"b.key": {
"text": "More text to translate",
"html": true
}
},
"source_language_code": "en",
"target_language_code": "de",
"quality": "translation",
"options": {
"style_guide_reference_id":1,
"context_url": "http://tolq.com/translations_on_this_page",
"name": "My translations",
"description": "A clarification for future reference",
"auto_client_review": false,
"callback_url": "http://www.tolq.com/translations_completed",
"plain_text": "true",
"char_limit": {"a.key": 120},
"preferred_delivery_date": "2025-02-12T16:35:44Z",
"purchase_order_code": "2022-order-18"
}
}
Results
{
"id": 9,
"name": "I like bacon",
"slug": "i-like-bacon",
"context_url": "http://www.tolq.com",
"description": "This is a description",
"created_at": "2014-09-16T13:17:04.368Z",
"completed_at": "2014-09-16T13:17:04.368Z",
"quality": "standard",
"status": "pending"
}
{}
The callback url
You don't need to constantly poll for the state of translation of a translation request in order to get the approved translations as soon as possible in your system.
If you provide a callback_url in the request we will call back on that url with the same payload as Retrieve a Translation Request when the translations have been reviewed and are finished.
Payment
The order will be billed to your account according to the billing information you have set up.
If you would like to verify the price of a request before you commit to an order, you can use the quote endpoint first.
Language Codes
All language codes have to be in ISO 639-1 format (two letters).