Skip to content

POST_orders.md

Latest commit

 

History

History
77 lines (67 loc) · 2.5 KB

POST_orders.md

File metadata and controls

77 lines (67 loc) · 2.5 KB

Order Resources

POST orders

Description

Send an order to professional translators.

Requires authentication

  • Details described here

Parameters

  • from_locale (required) - the locale to be translated from, default base locale of the project
  • to_locales (required) - locale codes to be translated to, comma separated e.g. 'en-US,fr-FR,zh-TW', please refer to GET locales
  • items (required) - items to be translated, format reference here
  • tone (optional) - tone of the translation. ['FORMAL', 'INFORMAL'], default not specified
  • note (optional) - note for translator about the order
  • is_including_review (optional) - set translation review is required. true or false, default false
  • specialization (optional) - code of project specialization such as game, default general, please refer to GET specializations

Example

Request

POST https://plugin.api.onesky.io/1/projects/:project_id/orders

Response

status 201 Created

{
    "order": {
        "id": 372,
        "amount": "50.00",
        "ordered_at": "2013-08-15T08:12:40+0000",
        "ordered_at_timestamp":13283746583,
        "tasks": [
            {
                "id": 123,
                "from_language": {
                    "code": "en-US",
                    "english_name": "English (United States)",
                    "local_name": "English (United States)",
                    "locale": "en",
                    "region" : "US"
                },
                "to_language": {
                    "code": "ja-JP",
                    "english_name": "Japanese",
                    "local_name": "日本語",
                    "locale": "ja",
                    "region" : "JP"
                }
            },
            {
                "id": 122,
                "from_language": {
                    "code": "en-US",
                    "english_name": "English (United States)",
                    "local_name": "English (United States)",
                    "locale": "en",
                    "region" : "US"
                },
                "to_language": {
                    "code": "ko-KR",
                    "english_name": "Korean",
                    "local_name": "한국어",
                    "locale": "ko",
                    "region" : "KR"
                }
            }
        ]
    }
}