| | Contacts | |
Free translations and professional services
Human Translation Server
®Web service specifications (WSDL) :
- Human Translation Quote Request - [ function: quote ]
- Human Translation Quote Confirmation - [ function: confirm ]
- Machine Transaltion Request - [ function: mt ]
- List of Available Languages - [ function: ll ]
- List of Available Charset - [ function: lc ]
- Charset Conversion - [ function: cc ]
Quote Request:
This function returns the price and delivery date for a human translation.
This is the first step
in ordering a human translation using HTS.
Quote Confirmation:
This function confirms a previously requested human translation quote.
This is the second and final step
in placing an order for human translation using HTS.
Machine Translation:
This function machine-translates a given text from one language to another.
The text to-be-translated must be given UTF-8 character encoding. Likewise, the
returned translation will also be in UTF-8. You can use the free Charset Conversion (“cc”) function,
described below, to convert to and from UTF-8. For each machine translation, only one HTS call is
required. The list of supported source and target languages can be found on http://free.translated.net
List of Available Languages:
This function shows the list of language codes supported for human translation (for the source and target
parameters of the quote and confirm functions).
The list contains the RFC 3066 code, the ISO two- and
tree-letter codes and language names in English, French and Italian. Use of this function is free of charge.
This function should be used to periodically update the supported language list on your system.
List of Available Charsets:
This function shows the list of supported languages encodings (to be passed in the senc and tenc
parameters of the human translation "quote" function).
This function
should be used to periodically update the character encoding list on your system.
Charset Conversion:
This function helps you change character encoding by converting text from one character set to another.
quoteResponse quote( string cid, string p, string fd, string s, string t, string df, string text,string w, string jt, string pn, string v, string iv, string senc, string tenc )
confirmResponse confirm( string cid, string p, string pid, int c)
llResponse ll( string cid, string p)
lcResponse lc( string cid, string p)
| Parameter | Description | Default value/Examples | Required |
| c | Confirm or decline a quote. | Examples: c=1 : confirm c=0 : decline | Required |
| cid | Customer ID. Your ID as provided by Translated | Examples: cid=myusername | Required |
| df | Data format. The format of the data specified in the text parameter. Possible values: plaintext,html,xml,xliff,doc,xls, pdf,mif or any format agreed with Translated | Default: df=plaintext | Optional |
| fd | Force date. This parameter forces the delivery date. If you need your document to be done faster then the standard delivery date you can specify a deadline and the quote will return the corrisponding price. We normally deliver 2000words per day with 4 hours start-up time. Rush jobs can cost from 120% to 250% of the standard cost. The date must bein th ISO 8601 format: YYYY-MM-DDTHH:mm:SSZ. To avoid confusion, we suggest you to indicate all time in the Universal Time (UTC,Zulu Time). Example: 2005 March 14th 12:00:00 in New York would be: 2005-03-14T17:00:00z [in Zulu time] 2005-03-14T12:00:00-05:00 [using the time zone offset] | Default: fd=0 Example: fd=2005-03-22T17:00:00Z | Optional |
| iv | Implementation version. The implementation level representing the data excanghed method(1=plaintext, 2=SOAP) | Default: iv=2 | Optional |
| jt | Job Type. Valid job types are: T for Translation R for Revision E for Evaluation | Default: jt=T | Optional |
| p | Password. Your password as provided by Translated | Example: p=mypassword | Required |
| pid | Project ID. The ID of the project that you want to confirm, as specified during a previous quote. | Example: pid=343223 | Required |
| pn | Project Name. The name of the project as defined by you. This information will appear in the Order Tracking System and on any relevant Invoices | Example: pn=YOUR_NAME | Optional |
| s | Source Language. The language of the document to be translated. | Example: s=English | Required |
| senc | Source Encoding. The character encoding of the source document or source text to be translated. This overrides any charset already specified if the text passed is HTML or XML. Use the "lc" function to obtain a list of available charsets. | Example: senc=ISO-8859-1 | Required for cc Optional for quote |
| t | Target Language(s). The Language(s) into which the document will be translated. For machine translation, only one target may be specified. | Example: t="English,French" | Required |
| tenc | Target Encoding. The character encoding you want for the translated text(where possible). Use "lc" function to obtain a list of available encodings | Example: tenc=UTF-8 | Optional for quote Required for cc |
| text | The text you want to translate. The value of this parameter can be also the name of a file or a url. (In case of url, HTS will retrieve the file from the address) | Example: text=hello | Required (optional if w is given) |
| v | API version. The version of the API to which your application conforms. | Default: v=1 | Optional |
| w | Word count. By specifying a word count, you are over-riding the automatic word count we perform on every text parameter | Example: w=100 | Optional |
- Function quote returns an object called quoteResponse with the following properties:
| return_code | 1 if the quote has succeeded, 0 if there was an error |
| error_message | "OK" if there was no error, or else the text describing the error |
| delivery_date | is the date and time representing the guaranteed deadline for the order, given in the ISO 8601 standard: YYYY-MM-DDTHH:mm:SSZ |
| word_count | is the number of words given in the text parameter |
| price | is the cost in Euro for the order, formatted as a number with no thousands separator and "." as decimal separator |
| project_id | is the project ID to be used when you want to confirm this order |
- Function confirm returns an object called confirmResponse with the following properties:
| return_code | 1 if the confirmation has succeeded, 0 if there was an error |
| error_message | "OK" if there was no error, or else the text describing the error |
- Function mt returns an object called mtResponse with the following properties:
| return_code | 1 if the call has succeeded, 0 if there was an error |
| error_message | "OK" if there was no error, or else the text describing the error |
| credits | Your remaining translation credit balance. Credits are purchased in advance and each credit is good for one machine translation. |
| translation | the machine translation in UTF-8 encoding |
- Function ll returns an object called llResponse with the following properties:
| return_code | 1 if the call has succeeded, 0 if there was an error |
| error_message | "OK" if there was no error, or else the text describing the error |
| languages | is a list of language codes in which the first value of each
language group is the language code that you should pass as the "source" or
"target" parameter in the quote and confirm human translation functions Example: <languages> <language>Albanian;sq-AL;sq;alb;Albanian;Albanais;Albanese</language> <language>Arabic;ar-SA;ar;ara;Arabic;Arabe;Arabo</language> · · · </languages> |
- Function lc returns an object called lcResponse with the following properties:
| return_code | 1 if the call has succeeded, 0 if there was an error |
| error_message | "OK" if there was no error, or else the text describing the error |
| encodings | is a list of available charset Example: <encodings> <encode>ISO-8859-1</encode> <encode>UTF-8</encode> <encode>CP1250/CR-LF</encode> · · · </encodings> |
- Function cc returns an object called ccResponse with the following properties:
| return_code | 1 if the call has succeeded, 0 if there was an error |
| error_message | "OK" if there was no error, or else the text describing the error |
| text | is the text recoded according to the tenc parameter. |