Introduction to the Language I/O API

What is the Language I/O API and what is it for?

The Language I/O API allows you to configure custom connections between your CRM or platform and Language I/O services. A typical example would be if the CRM that you use is not supported by any of the Language I/O plugins, or you want to connect internal tools for internal translation needs. 

API Requests

The base URL for the Language I/O API is https://agw.golinguist.com/linguistnow/resources/.

The Language I/O API allows you to detect the language of a piece of content or translate a piece of content to one or several languages. The endpoints available for consumptions are the following:

• Locale
• Translate

Supported request methods include cURL, Postman, and python or javascript libraries. The payload format is JSON. Here is an example of sending an API request using cURL:

curl \
-H "Content-Type:application/json" -X POST \ -d '{"sourceContent": "Hola", "sourceLocale": "es-es", "targetLocale": "fr-fr", "contentTypeName": "api", "translationType": "machine", "textType": "text"}' \ https://agw.golinguist.com/linguistnow/resources/translate/

API Responses

The response format for all requests is a JSON object. The HTTP status code shows if a request succeeds or not. A 200 status code means success. Any other code means a failure occurred.

Example of a successful request:

HTTP/1.1 200 OK
   {
     "rnResponseProjectId": "123456",
     "statusMessage": "Machine translation complete",
     "translatedText": "Bonjour",
     "translationId": 4994,
     "wordCount": 6
   }


Example of a failed request:

HTTP/1.1 400 Bad Request
   {
     "error":{
          "userMessage":"We were unable to detect the language of the message.",
          "id":501,
          "message": "ERROR: The translation request was missing the source language and we were unable to detect it. Please contact support@languageio.com with error code 501:1588195898167"
     }
   }