image did not load, try refreshing page

This is the HTTP API of Openwords services. This means that the text of an url (that you place in the address bar of a browser) performs a remote query of the Openwords db, and returns the data in the simple 'JSON' format within your browser. The parameters of the query are within the text of the url. The below descriptions illustrate five different kinds of queries (with examples).

The Openwords db has the following structure. There is a large table of words ('words') from many languages. Next there are many connections between these words represented by the wordsConnections table. Both the 'words' and 'wordsConnections' tables have additional information attached to them. A more complete description of the Openwords database will be forthcoming.



Openwords currently hold {{langList.length}} languages, {{totalWords| number}} words, and {{totalSounds| number}} sounds:

{{lang[0]}} ({{lang[2]}}, langId={{lang[3]}}) with {{lang[1]| number}} words and {{lang[4]| number}} sounds




Available Public APIs:

/overviewOpenwords

Overview the entire languages information.

Example: /overviewOpenwords

/simpleTranslate

Translate a simple word from one language to another.

ParameterConstraintsPurpose
wordString, compulsoryThe word to be translated
langInString, compulsoryLanguage code of input language
langOutString, compulsoryLanguage code of output language
Example: /simpleTranslate?word=自由&langIn=cmn&langOut=en

/getWordInfo

Get all (first 10 for now) the words which look like the requesting word.

ParameterConstraintsPurpose
wordFormString, compulsoryThe complete or partial spelling of the word
Example: /getWordInfo?wordForm=dict

/getWordAllConnections

Get all other words which are connected to the word.

ParameterConstraintsPurpose
wordOneString, compulsoryThe complete spelling of the word
Example: /getWordAllConnections?wordOne=love

/getLanguageConnections

Get all connected words between two langauges.

ParameterConstraintsPurpose
langOneIdInteger, compulsoryID of language one
langTwoIdInteger, compulsoryID of language two
pageNumberInteger, compulsoryThe page number needed
pageSizeInteger, compulsorySize of each page
doOrderBoolean, optionalWhether order the results
orderByString, optionalOrdering criteria, such as "popRank"
Example: /getLanguageConnections?langOneId=1&langTwoId=98&pageNumber=1&pageSize=5&doOrder=true&orderBy=popRank

Download the words evaluation file in ODS format

Get all the word connections between English and your chosen language, and then contribute your evaluation input!

ParameterConstraintsPurpose
langTwoIdInteger, compulsoryID of language two
passString, optionalPassword for our permitted participants
Check above language info list and input one language ID at here:

And then type the password at here:


Click here to download

/translateDocument

Translate a document of words from one language to another. This service will return an url for the translated document upon success.

ParameterConstraintsPurpose
fileBinary, compulsoryThe file object of the document
langInString, compulsoryID of language one
langOutString, compulsoryID of language two
placeString, optionalPlaceholder for the words which cannot be translated, if this parameter is not specified then original language one words will be kept in the same place
You can drop your .txt file here (Please use UTF-8 encoding, max file size: 2MB)
HTML5 Drop File is not supported!
{{progressText}}


You can drop your transcription.txt file here (Please use UTF-8 encoding, max file size: 800KB)
HTML5 Drop File is not supported!
{{progressText}}

And more later on...