You are here

API Developers Guide

General Instructions

API Developers Guide

Download Guide

One Hour Translation API exposes various methods and services delivered by One Hour Translation and allows external systems to securely launch, monitor and communicate with translation jobs. 

Request URLs:

Authentication:

Each request must include the public_key and secret_key parameters, as supplied by One Hour Translation.
To get your API keys on the Production environment, please click here

To get your API keys on the Sandbox environment, please click here

Response Format:

Responses are encoded according to the JSON scheme, Long and complex values are further encoded with Base64. Each response will include the “status” entity which represent a success or failure in processing your request. The complete status codes list may be viewed here.
Response example:

{
   "status": {
       "code": 0,
       "msg": "ok"
   },
   "errors": [ /*array of errors*/ ],
   "results": [ /*method-specific parameters as specified below*/ ]
}

Callbacks:

Some requests allow you to specify a callback URL. This URL will be used on time critical events, for example, when a translation has been received for your project. Read more about callbacks here.
 

Developer Friendly:

We are developing tools that may accelerate your development and testing process dramatically.
More tools will be published here once available. 

 

Client Libraries:

Testing and Debugging:

Sandbox Usage

OneHourTranslation provides a separated, semi-functional version on OHT for testing and development purposes. The sandbox environment may be accessed here:
http://sandbox.onehourtranslation.com

In order to use OHT sandbox, please note following:

  1. The sandbox is fully functional as a website and API interface but is completely non functional for translation purposes or any other professional services.
  2. To get started, please create a user account on OHT sandbox. Once an account is established, create your API keys here.
  3. Every text you submit for translation will be translated within a few seconds using Google's machine translation service. XML formatted text will not be translated but will rather be copied and returned to your system as a translation.
  4. Note: This behavior is limited to the sandbox only. Texts and XMLs you submit to OneHourTranslation.com will only be translated by real human translators.
  5. The sandbox environment only supports English to French translation at the moment. Other language pair will invoke a "language pair is currently unsupported" (#201) error code.