Introduction

This documentation explains the features and endpoint usage of GlobalLink Connect Rest API V2. The V2 API is a session based API which implements authentication by using bearer tokens.

Connectors API

The connectors API allows you to get the list of configured connectors and their details such as configured language directions, file formats, and submission configuration options.

Connectors Get


        

      Connectors Config

      
              

          Connectors Logs

          
                  

              Context API

              The context API allows you to submit a HTML rendering of the content for which translation is requested. This is then used for doing in-context reviews of the translations before the final translations are delivered back to the content repository.

              You can also submit XML files which will be transformed to HTML on the server using a preconfigured XSLT processor.

              Context Config

              
                      

                  Upload HTML

                  
                          

                      Upload XSLT

                      
                              

                          Upload Zip

                          
                                  

                              Content API

                              The content API allows you to upload files, reference files, or binary (base64) data for translation.

                              Upload Data

                              
                                      

                                  Upload File

                                  
                                          

                                      Upload Reference

                                      
                                              

                                          List Unsubmitted Content

                                          
                                                  

                                              Show Content History

                                              
                                                      

                                                  Jobs API

                                                  The jobs API allows you to query the list of jobs filtered by various criteria.

                                                  Jobs List

                                                  
                                                          

                                                      Jobs Status

                                                      
                                                              

                                                          Jobs Tasks

                                                          
                                                                  

                                                              Jobs Wordcount

                                                              
                                                                      

                                                                  Cancel a job.

                                                                  
                                                                          

                                                                      Session API

                                                                      GlobalLink Connect APIs use bearer authentication. The Authentication API provides the access token to authenticate API calls. The access token needs to be included in the header of every request.

                                                                      Session Start

                                                                      
                                                                              

                                                                          Session Terminate

                                                                          
                                                                                  

                                                                              Submission API

                                                                              The Submission API allows you to retrieve submission details, for example word count, status, etc.

                                                                              Get Submission List

                                                                              
                                                                                      

                                                                                  Get Jobs List

                                                                                  
                                                                                          

                                                                                      Submission Status

                                                                                      
                                                                                              

                                                                                          Submit Content

                                                                                          
                                                                                                  

                                                                                              Get Task List

                                                                                              
                                                                                                      

                                                                                                  Submission Wordcount

                                                                                                  
                                                                                                          

                                                                                                      Submission Download Deliverable

                                                                                                      
                                                                                                              

                                                                                                          Cancel a submission

                                                                                                          
                                                                                                                  

                                                                                                              Tasks API

                                                                                                              The Tasks API allows you to fetch task details, download translated files, and confirm delivery of the downloaded files.

                                                                                                              Get Task List

                                                                                                              
                                                                                                                        

                                                                                                                  Download Task

                                                                                                                  
                                                                                                                            

                                                                                                                      Confirm Task

                                                                                                                      
                                                                                                                                

                                                                                                                          Task Cancel

                                                                                                                          
                                                                                                                                    

                                                                                                                              Confirm Cancel

                                                                                                                              
                                                                                                                                        

                                                                                                                                  Task Error

                                                                                                                                  
                                                                                                                                            

                                                                                                                                      Task PD Phase

                                                                                                                                      
                                                                                                                                                

                                                                                                                                          Notification API

                                                                                                                                          The notification API allows you to send a mail to submitter and all users with "admin" role for the connector.

                                                                                                                                          Notify

                                                                                                                                          
                                                                                                                                                  

                                                                                                                                              Datastore API

                                                                                                                                              The datastore API allows you to save a set of data collection related to the connector in a key value format.

                                                                                                                                              Connectors Data Store

                                                                                                                                              
                                                                                                                                                      

                                                                                                                                                  Connectors Data Store

                                                                                                                                                  
                                                                                                                                                          

                                                                                                                                                      List

                                                                                                                                                      
                                                                                                                                                              

                                                                                                                                                          Add/ Update

                                                                                                                                                          
                                                                                                                                                                  

                                                                                                                                                              Delete

                                                                                                                                                              
                                                                                                                                                                      

                                                                                                                                                                  Get Specific Entry

                                                                                                                                                                  
                                                                                                                                                                          

                                                                                                                                                                      Errors

                                                                                                                                                                      We use standard HTTP response codes for success and failure notifications, and the errors are further classified by error_type. The errors fall under the following categories:

                                                                                                                                                                      Error Type Reason Example
                                                                                                                                                                      400 Invalid data input or requests Incorrect connector ID, file name, file type, submitter name, attributes, etc.
                                                                                                                                                                      401 Unauthorized access Incorrect user name or password, expired bearer token
                                                                                                                                                                      404 Not found Incorrect link or server not found
                                                                                                                                                                      500 Server errors Exceptions occurring in the server

                                                                                                                                                                      Please contact the Support Center for help resolving error codes.