Frequent questions about Project API
General
What is an API response?
An API response is data sent back by a server in response to a call or request you made.
Are there different API responses?
Yes, you can get a success or error response.
Can I use all API endpoints?
Yes, all endpoints are available either if you are using our temporal tokens for the sandbox environment (with predefined dummy data), or a production account, in the case you have already your account registered with LanguageWire.
Credentials
What are the available API credentials?
We have 2 types of available credentials so far: A temporal token that provides access to the Sandbox data and a production token when logged in LanguageWire Platform. You can obtain these from our Dashboard.
When does a token expire?
Tokens are temporal and expire after 20 minutes. You should generate another token after that time via our Dashboard.
Dashboard applications
When should I delete my app?
You should delete you application from our Dashboard in these cases:
- When the integration is no longer needed or it is finished.
Sandbox account
How can I get access to the sandbox account?
To access to a predefined dummy account that has been set up for testing purposes in LanguageWire Platform, you must get your temporal token from the Dashboard and then use it to start retrieving dummy data.
When using a sandbox account, can I get my project translated back?
Yes, you can get your files translated back (with dummy data) but only applying Machine Translation services, since any other service is dependant on our linguists jobs in the Platform. Still, you will be able to send requests for other non MT-related services, but the system will not retrieve any response.
Project management
Which workarea should I choose for my project?
Pick the one that is more representative of your business. Retrieve the full list of Workareas
to check them all and decide which one fits better the nature of your project.
How frequently do I need to send a poll request?
If you are applying a Raw MT service to your translation project, then you can run a poll request frequently (every few minutes) as this is an automatic translation based on our Artificial Intelligence technology, with no human intervention.
However, if your project involves our experts efforts, then our recommendation is running a poll request every hour.
What happen if I start a project and I suddenly realise a change needs to be done?
When a project starts you cannot modify it using our Project API. If this ever happens you should contact your assigned LanguageWire Project Manager as soon as possible.
Can I cancel a project at any time?
You can cancel your project, but not at any time, only if it has not started yet. Therefore, only projects with "Draft" status can be cancelled.
File management
When adding a file to my project, can I add several files at the same time?
No, you can only add one file per request. However, you can include several target languages for the same file.
Is there any restriction in file names?
Yes, there are some restrictions to consider:
The file name is mandatory, and should not exceed 100 characters.
Refer to the Formats and standards section for more details.
Is there any restriction in file size?
Yes, the maximum file size is 3Gb,and 10Gb if uploaded by chunks.
How many files/documents are allowed per translation project?
The maximum number of files/documents a project can support is 400.
If I delete a file can I recover it?
No, currently there is no way to get the file back.
Can I run an operation to get all deleted files from my project?
No, currently there is not a specific request for such operation.
Reference files
Can I use reference files in different projects?
Yes, there is no restriction when using reference files in different projects.
Can I use different reference files in one request?
No, only 1 reference file is allowed per request.
Has the reference files name any restriction?
Yes, same restrictions that those applied to file name.
Can I remove a reference file from my project?
Yes, you can remove it, but only before the project has started!
How can I force my reference file to be the one picked up for experts preview?
Just name your reference file with the very same name than that used for your source file. The system will automatically identify the reference file as the one to be displayed in the preview for our experts.
Other
Which languages codes does the API use?
The API uses languages codes (or tags) following the BCP 47 format. See the language code examples here
Something missing? If you have any other related question that is not listed here, and you would like us to respond, please contact us.