IDM SkPublish - REST API documentation


Summary

ResourceMethodDescription
http://www.example.com/api/v1/dictionaries
Getting list of available dictionaries in JSON.
Getting list of available dictionaries in XML.
http://www.example.com/api/v1/dictionaries/{dictCode}
Getting single dictionary information in JSON.
Getting single dictionary information in XML.
http://www.example.com/api/v1/dictionaries/{dictCode}/entries
Unused
Unused
http://www.example.com/api/v1/dictionaries/{dictCode}/entries/{entryId}
Getting entry information with content in specified format in JSON.
Getting entry information with content in specified format in XML.
http://www.example.com/api/v1/dictionaries/{dictCode}/entries/{entryId}/relatedentries
Getting all linked entries in same or other dictionaries in XML.
Getting all linked entries in same or other dictionaries in JSON.
http://www.example.com/api/v1/dictionaries/{dictCode}/entries/{entryId}/nearbyentries
Getting preceding and following entries of current entry in same dictionary in JSON.
Getting preceding and following entries of current entry in same dictionary in XML.
http://www.example.com/api/v1/dictionaries/{dictCode}/entries/{entryId}/pronunciations
Getting all pronunciations of the selected entry in JSON.
Getting all pronunciations of the selected entry in XML.
http://www.example.com/api/v1/dictionaries/{dictCode}/autocomplete
http://www.example.com/api/v1/dictionaries/{dictCode}/search
Getting first page of results in JSON.
Getting first page of results in XML.
http://www.example.com/api/v1/dictionaries/{dictCode}/search/first
Getting first matching result in JSON.
Getting first matching result in XML.
http://www.example.com/api/v1/dictionaries/{dictCode}/search/didyoumean
Getting all suggestions for the given word in JSON
Getting all suggestions for the given word in XML
http://www.example.com/api/v1/dictionaries/{dictCode}/topics
Getting all topics in JSON
Getting all topics in XML
http://www.example.com/api/v1/dictionaries/{dictCode}/topics/{thesaurusName}
Unused
Unused
http://www.example.com/api/v1/dictionaries/{dictCode}/topics/{thesaurusName}/{topicId}
Getting topic information with subtopic and linked entries in JSON.
Getting topic information with subtopic and linked entries in XML.
http://www.example.com/api/v1/dictionaries/{dictCode}/wordoftheday
Getting full entry for Word of the day in JSON.
Getting full entry for Word of the day in XML.
http://www.example.com/api/v1/dictionaries/{dictCode}/wordoftheday/preview
Getting short version for the Word of the day in JSON.
Getting short version for the Word of the day in XML.
http://www.example.com/api/v1/quizzes
Get Quizzes configuration.
http://www.example.com/api/v1/quizzes/composite
Return a {@link org.json.JSONArray} containing {@link org.json.JSONObject} representing a {@link RestCompositeQuiz}.
http://www.example.com/api/v1/quizzes/image
Get all quiz entry ids.
http://www.example.com/api/v1/quizzes/image/categories
Get the image quizzes categories.
http://www.example.com/api/v1/quizzes/image/categories/{categoryId}
Get the category resource.
http://www.example.com/api/v1/quizzes/image/categories/{categoryId}/{level}
Get the category level info.
http://www.example.com/api/v1/quizzes/image/categories/{categoryId}/{level}/{quizEntryId}
http://www.example.com/api/v1/quizzes/grammar
Get all grammar quiz entry ids.
http://www.example.com/api/v1/quizzes/grammar/{entryId}
http://www.example.com/api/v1/quizzes/search
Search quizzes (only in categories)
http://www.example.com/api/v1/documentation/html
REST API documentation in HTML format.
http://www.example.com/api/v1/documentation/wadl
REST API documentation in XML format.
http://www.example.com/api/v1/key/callLimit
Getting call limt informations for current used key in JSON.
Getting call limt informations for current used key in XML.
http://www.example.com/api/v1/wordoftheday
Getting full entry for Word of the day in JSON.
Getting full entry for Word of the day in XML.
http://www.example.com/api/v1/wordoftheday/preview
Getting short version for the Word of the day in JSON.
Getting short version for the Word of the day in XML.

Grammars

schema.xsd

Resources


http://www.example.com/api/v1/dictionaries

Methods
GEThttpGet()

Getting list of available dictionaries in JSON.

request
unspecified
responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Getting list of available dictionaries in XML.

request
unspecified
responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}

Methods
GEThttpGet()

Getting single dictionary information in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list

responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Getting single dictionary information in XML.

request
template params
dictCodestringdictionary code find in dictionaries list

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/entries

Methods
GEThttpGet()

Unused

request
template params
dictCodestringdictionary code find in dictionaries list

responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Unused

request
template params
dictCodestringdictionary code find in dictionaries list

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/entries/{entryId}

Methods
GEThttpGet()

Getting entry information with content in specified format in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list
entryIdstringentry id can be retrieve in search result, topics entries or word of the day preview

query params
formatstringcan be "html" or "xml" (defaults is "html").

responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Getting entry information with content in specified format in XML.

request
template params
dictCodestringdictionary code find in dictionaries list
entryIdstringentry id can be retrieve in search result, topics entries or word of the day preview

query params
formatstringcan be "html" or "xml" (defaults is "html").

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/entries/{entryId}/relatedentries

Methods
GEThttpGetRelatedEntriesXml()

Getting all linked entries in same or other dictionaries in XML.

request
template params
dictCodestringdictionary code find in dictionaries list
entryIdstringentry id can be retrieve in search result, topics entries or word of the day preview

responses
representations for status code 200
application/xml; qs=.5
GEThttpGetRelatedEntries()

Getting all linked entries in same or other dictionaries in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list
entryIdstringentry id can be retrieve in search result, topics entries or word of the day preview

responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/dictionaries/{dictCode}/entries/{entryId}/nearbyentries

Methods
GEThttpGetNearbyEntries()

Getting preceding and following entries of current entry in same dictionary in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list
entryIdstringentry id can be retrieve in search result, topics entries or word of the day preview

query params
entrynumberintthe number of results preceding/following the given entry [optional, 10 by default, maximum allowed 50]

responses
representations for status code 200
application/json; qs=1
GEThttpGetNearbyEntriesXml()

Getting preceding and following entries of current entry in same dictionary in XML.

request
template params
dictCodestringdictionary code find in dictionaries list
entryIdstringentry id can be retrieve in search result, topics entries or word of the day preview

query params
entrynumberintthe number of results preceding/following the given entry [optional, 10 by default, maximum allowed 50]

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/entries/{entryId}/pronunciations

Methods
GEThttpGetPronunciations()

Getting all pronunciations of the selected entry in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list
entryIdstringentry id can be retrieve in search result, topics entries or word of the day preview

query params
langstringfilter pronunciations list by language
formatstringspecified pronunciations file format. can be "mp3" or "ogg" (defaults is "mp3").

responses
representations for status code 200
application/json; qs=1
GEThttpGetPronunciationsXml()

Getting all pronunciations of the selected entry in XML.

request
template params
dictCodestringdictionary code find in dictionaries list
entryIdstringentry id can be retrieve in search result, topics entries or word of the day preview

query params
langstringfilter pronunciations list by language
formatstringspecified pronunciations file format. can be "mp3" or "ogg" (defaults is "mp3").

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/autocomplete

Methods
GEThttpGet()

request
template params
dictCodestringdictionary code find in dictionaries list

query params
qstring

responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/dictionaries/{dictCode}/search

Methods
GEThttpGet()

Getting first page of results in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list

query params
qstringSearch terms
pagesizeintthe number of results per page to return
pageindexintthe index of result page to return

responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Getting first page of results in XML.

request
template params
dictCodestringdictionary code find in dictionaries list

query params
qstringSearch terms
pagesizeintthe number of results per page to return
pageindexintthe index of result page to return

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/search/first

Methods
GEThttpGetSearchFirst()

Getting first matching result in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list

query params
qstringSearch terms
formatstringcan be "html" or "xml" (defaults is "html").

responses
representations for status code 200
application/json; qs=1
GEThttpGetSearchFirstXml()

Getting first matching result in XML.

request
template params
dictCodestringdictionary code find in dictionaries list

query params
qstringSearch terms
formatstringcan be "html" or "xml" (defaults is "html").

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/search/didyoumean

Methods
GEThttpGetSpelling()

Getting all suggestions for the given word in JSON

request
template params
dictCodestringdictionary code find in dictionaries list

query params
qstringthe word we are searching for
entrynumberintthe number of Did you Mean results [optional, 10 by default, maximum allowed 10]

responses
representations for status code 200
application/json; qs=1
GEThttpGetSpellingXml()

Getting all suggestions for the given word in XML

request
template params
dictCodestringdictionary code find in dictionaries list

query params
qstringthe word we are searching for
entrynumberintthe number of Did you Mean results [optional, 10 by default, maximum allowed 10]

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/topics

Methods
GEThttpGet()

Getting all topics in JSON

request
template params
dictCodestringdictionary code find in dictionaries list

responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Getting all topics in XML

request
template params
dictCodestringdictionary code find in dictionaries list

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/topics/{thesaurusName}

Methods
GEThttpGet()

Unused

request
template params
dictCodestringdictionary code find in dictionaries list
thesaurusNamestringthe thesaurus name of the topic

responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Unused

request
template params
dictCodestringdictionary code find in dictionaries list
thesaurusNamestringthe thesaurus name of the topic

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/topics/{thesaurusName}/{topicId}

Methods
GEThttpGet()

Getting topic information with subtopic and linked entries in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list
thesaurusNamestringthe thesaurus name of the topic
topicIdstringthe id of the topic

responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Getting topic information with subtopic and linked entries in XML.

request
template params
dictCodestringdictionary code find in dictionaries list
thesaurusNamestringthe thesaurus name of the topic
topicIdstringthe id of the topic

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/wordoftheday

Methods
GEThttpGet()

Getting full entry for Word of the day in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list

query params
daystringdate representation in ISO 8601 format date (YYYY-MM-DD, optional)
formatstringcan be "html" or "xml" (optional) (defaults is "html")

responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Getting full entry for Word of the day in XML.

request
template params
dictCodestringdictionary code find in dictionaries list

query params
daystringdate representation in ISO 8601 format date (YYYY-MM-DD, optional)
formatstringcan be "html" or "xml" (optional) (defaults is "html")

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/dictionaries/{dictCode}/wordoftheday/preview

Methods
GEThttpGetPreview()

Getting short version for the Word of the day in JSON.

request
template params
dictCodestringdictionary code find in dictionaries list

query params
daystringdate representation in ISO 8601 format date (YYYY-MM-DD, optional)

responses
representations for status code 200
application/json; qs=1
GEThttpGetPreviewXml()

Getting short version for the Word of the day in XML.

request
template params
dictCodestringdictionary code find in dictionaries list

query params
daystringdate representation in ISO 8601 format date (YYYY-MM-DD, optional)

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/quizzes

Quizzes resource.

Methods
GEThttpGet()

Get Quizzes configuration.

request
unspecified
responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/quizzes/composite

Composite quizzes resource.

Methods
GEThttpGet()

Return a {@link org.json.JSONArray} containing {@link org.json.JSONObject} representing a {@link RestCompositeQuiz}.

request
unspecified
responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/quizzes/image

Methods
GEThttpGet()

Get all quiz entry ids.

request
unspecified
responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/quizzes/image/categories

Quiz categories resource (without grammar quizzes)

Methods
GEThttpGet()

Get the image quizzes categories.

request
unspecified
responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/quizzes/image/categories/{categoryId}

Quiz category resource.

Methods
GEThttpGet()

Get the category resource.

request
template params
categoryIdstringThe id of the category.

responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/quizzes/image/categories/{categoryId}/{level}

Quiz category level resource.

Methods
GEThttpGet()

Get the category level info.

request
template params
categoryIdstringThe id of the category.
levelintThe level.

responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/quizzes/image/categories/{categoryId}/{level}/{quizEntryId}

A Quiz entry resource.

Methods
GEThttpGet()

request
template params
categoryIdstringThe id of the category.
levelintThe level.
quizEntryIdstringThe id of the entry to retrieve.

responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/quizzes/grammar

Grammar quizzes resource.

Methods
GEThttpGet()

Get all grammar quiz entry ids.

request
unspecified
responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/quizzes/grammar/{entryId}

A Quiz entry resource.

Methods
GEThttpGet()

request
template params
entryIdstring

responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/quizzes/search

Search quizzes resource.

Methods
GEThttpGet()

Search quizzes (only in categories)

request
query params
sizeintThe number of quizzes to include in the result.
levelstringThe levels of the quizzes to return.
shuffleboolean
default: true
Shuffle the result.

responses
representations for status code 200
application/json; qs=1

http://www.example.com/api/v1/documentation/html

Methods
GEThttpGetHtmlDoc()

REST API documentation in HTML format.

request
unspecified
responses
representations for status code 200
text/html

http://www.example.com/api/v1/documentation/wadl

Methods
GEThttpGetXmlDoc()

REST API documentation in XML format.

request
unspecified
responses
representations for status code 200
text/xml

http://www.example.com/api/v1/key/callLimit

Methods
GEThttpGetCallLimit()

Getting call limt informations for current used key in JSON.

request
unspecified
responses
representations for status code 200
application/json; qs=1
GEThttpGetCallLimitXml()

Getting call limt informations for current used key in XML.

request
unspecified
responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/wordoftheday

Methods
GEThttpGet()

Getting full entry for Word of the day in JSON.

request
query params
daystringdate representation in ISO 8601 format date (YYYY-MM-DD, optional)
formatstringcan be "html" or "xml" (optional) (defaults is "html")

responses
representations for status code 200
application/json; qs=1
GEThttpGetXml()

Getting full entry for Word of the day in XML.

request
query params
daystringdate representation in ISO 8601 format date (YYYY-MM-DD, optional)
formatstringcan be "html" or "xml" (optional) (defaults is "html")

responses
representations for status code 200
application/xml; qs=.5

http://www.example.com/api/v1/wordoftheday/preview

Methods
GEThttpGetPreview()

Getting short version for the Word of the day in JSON.

request
query params
daystringdate representation in ISO 8601 format date (YYYY-MM-DD, optional)

responses
representations for status code 200
application/json; qs=1
GEThttpGetPreviewXml()

Getting short version for the Word of the day in XML.

request
query params
daystringdate representation in ISO 8601 format date (YYYY-MM-DD, optional)

responses
representations for status code 200
application/xml; qs=.5