Lionbridge onDemand API (V. 2014-06-10)

The Lionbridge onDemand API is a RESTful programming interface to Lionbridge’s onDemand Translation Service. With the Lionbridge onDemand API you can:

  • Create onDemand buyer accounts using Create Account.
  • Find the most cost-effective translation quality level for your content using List Services.
  • Create translation projects using Generate Quote.
  • Get a notification when your project is done.

The API can be used against the onDemand Retail site or an onDemand Enterprise site. Scroll down for a High Level Workflow

Version: 2014-06-10 Latest

Earlier Releases:

New in This Release

  • Files Support
  • Improved error messages

Getting Help

The Lionbridge onDemand integration support team is eager to help you be successful with your integration. The best way to reach them is through the onDemand Support Portal. There you will find support articles and a form to submit a support ticket.

Getting API Keys

You can get API keys on our sandbox server by registering for an account and then visiting the profile page to create your API keys.

alternate text

If you have trouble getting your API keys or need an account on an enterprise site sandbox, please contact support.

High Level Workflow

This high level sequence diagram shows the workflow for creating and completing onDemand projects. The process starts with an end user building list of content assets to translate within the client application. Then the merchant selects a service and target languages and requests a quote. onDemand responds with a quote that contains information about how the work will be broken down into projects and pricing information. The end user can authorize the quote (and if necessary pay) to start the project.

alternate text
  1. The end user uses the client application to build a list of content to be translated. These assets can be products or files.
  2. The end user selects an option to translate the selected assets and is presented a list of translation services that are available. Typically, these translation services will represent different quality levels such as straight machine translation, machine translation with human post edit, crowd translation, professional translation, and specialist domain translation. The list of avialable services can be found by calling the List Services API.
  3. The end user submits the list of content assets for a quote.
  4. If the project is file-based, the client application uploads each file using the Add File API. If the project is product-based, the products are sent to onDemand when generating the quote.
  5. The client application calls the Generate Quote API to build a quote for the selected content and translation service. Product-based projects and some file-based products will come back immediately with a completed quote containing a price. Other quotes will require additional time to parse the files.
  6. If the price is not ready, the quote will come back with a status of calculating and no price. If this is the case, the client application should regularly call the Get Quote API until the quote is “Pending” or has a status of “Error.”
  7. The client application should notify the end user that the price is ready.
  8. The end user can authorize or reject the quote.
  9. The client application calls either the Authorize Quote or Reject Quote API depending on the end user’s preference. If the end user has a prepaid balance or has been given free translation credit, authorizing the quote will automatically start the translation projects. If funds are required, the end user must go through a payment process.
  10. If payment is required, the authorize quote request will come back with an HTTP status code of 402. The body of the response will contain a PaymentURL that the end user can follow to submit payment.
  11. The client application sends the end user to the payment page where he or she can pay for the balance due.
  12. Lionbridge will complete the projects and notify the client application that the translated content is ready.

Glossary

This is list of terminology used in this document.

  • Currency. Lionbridge onDemand currently supports the following 4 currencies: CAD (Canadian Dollars), EUR (Euros), GBP (Great Britain Pound Sterling), USD (US Dollars).
  • LanguageCode. A locale code in the format en-us where EN is the 2 character ISO language code and US is the 2 character ISO country code.
  • Product. A product SKU to be translated.
  • Project. Like items are grouped into a Project and delivered to the translation system. Translation completion notifications is done at the project level. For translation efficiency, all products in project must be in the same top level category and have the same language and quality settings.
  • Service. A service defines pricing and quality level for a project.
  • Quote. A quote maps to a transaction which can include 1 or more projects.