Translation API (1.0.0)

Download OpenAPI specification:Download

Introduction

This translation server allows to performs machine and human translation.

Authentication

The Translation API uses Bearer Auth to authenticate users. Use Login endpoint with your Translate.com credentials to get an access token.

bearerAuth

Security Scheme Type	HTTP
HTTP Authorization Scheme	bearer

Login

Determine acces token. Access token has 1 year life time duration

Request Body schema: application/json

Your credentials - email and password

email required	string <email> john@mail.com
password required	string Password

Responses

Request samples

Payload
cURL

Content type

application/json


{"email": "Valid email address",
"password": "string"
}

Response samples

200
415
422
429

Content type

application/json


{"meta": 
{"status": 200,
"success": true
},
"data": 
{"token": "string"
}
}

Machine translation

Authorizations:

bearerAuth

Request Body schema: application/json

Translation data to perform machine translation

text required	string A text needed to translate
source_language required	string The original language of the source text
translation_language required	string The language to be translated

Responses

Request samples

Payload
cURL

Content type

application/json


{"text": "Some text to translate",
"source_language": "en",
"translation_language": "fr"
}

Response samples

Content type

application/json


{"meta": 
{"status": 200,
"success": true
},
"data": 
{"text": "Some text to translate",
"translation": "Du texte à traduire",
"source_language": "en",
"translation_language": "fr"
}
}

Human Translation

Authorizations:

bearerAuth

Request Body schema: application/json

Translation data to create human translation

text	string A source text
source_language	string The language of the source text
translation_language	array Translation Language
	object (CompletionAction) Describe how translation should be delivered to the user

Responses

Request samples

Payload
cURL

Content type

application/json

Example


{"text": "Some text to translate",
"source_language": "en",
"translation_language": 
["fr"
],
"completion_action": 
{"name": "url",
"action": "https://myserver.com/send/callback/here"
}
}

Response samples

Content type

application/json


{"meta": 
{"status": 200,
"success": true
},
"data": 
{"id": "string",
"payment_details": 
{"order_words": 0,
"words_remaining_after_order": 0
}
}
}