Page History
...
Parameter | Possible Values | Default Value | Description | |||
---|---|---|---|---|---|---|
1 | format |
| json | The parameter set a response format for output data. | ||
2 | callback |
| The parameter specifies a callback function name that will be used to manipulate with the JSON data received from the server. Such approach enables sharing of data bypassing same-origin policy. It can be used only along with “format=json”. | |||
3 | tokens |
| The parameter defines a text separated in tokens that will be sent for check. The text should be presented as an array of strings. Right now each string is a token which equals one sentence.
| |||
4 | text |
| The parameter defines a text which will be sent for check. The text has to be in the UTF-8 encoding. Any found tags in the text will be interpreted as a plan text as well. Note, that you shouldn't use # and & symbols in the text. | |||
5 | lang |
| en_US | The parameter sets a shot code of a language which will be used for check. | ||
6 | disable_spelling |
| false | The parameter regulates whether to check text for spelling errors. | ||
7 | disable_grammar |
| false | The parameter regulates whether to check text for grammar and style problems. | ||
8 | user_dictionary |
| The parameter specifies a user dictionary name which will be used during check spelling. | |||
9 | user_wordlist |
| The parameter provides the list of additional coma-separated words which will be used for spellchecking. | |||
10 | custom_dictionary |
| The parameter specifies global custom dictionary IDs which can be used during check spelling.
| |||
11 | ignore_all_caps |
| 0 | The parameter regulates whether to ignore capitalized words or not. | ||
12 | ignore_words_with_numbers |
| 0 | The parameter regulates whether to ignore words containing numbers or not. | ||
13 | ignore_mixed_case |
| 0 | The parameter regulates whether to ignore words written with mixed case letters or not. | ||
14 | ignore_domain_names |
| 0 | The parameter regulates whether to ignore domain names, web addresses or not. | ||
15 | min_word_length |
| 3 | The parameter specifies the minimal number of letters in the word which will be checked for spelling. E.g. if 3 is specified, the words with 2 letters and less will be ignored.
| ||
16 | custom_punctuation |
| - | The parameter defines a list of characters that should be considered as delimiters during spelling check. | ||
17 | short_answer |
| false | The parameter is responsible for shortening every static string JSON key name, like messages or type, down to its first character, like 'm' or 't'. | ||
18 | customerid |
| This parameter specifies a special customer ID value that has to be passed to a request query. An encrypted A customer ID can be obtained upon subscription to the Cloud WebSpellChecker services (paid or trial).
|
Example
...
1.1 [GET]: Check request for Am. English text with all available check types (output in JSON)
Code Block | ||
---|---|---|
| ||
http(s)://svc.webspellchecker.net/spellcheck31/script/ssrv.fcgi?cmd=check_spelling&format=json&text=Thisthis sampl text demonstrates the work of the WebSpellChecker Web API service.&out_type=words&slang=lang=en_US&format=json&customerid=[encrypted_customer_ID] |
Parameters:
Command:
checkcheck
- Format: json
- Text: “this
Text: this sampl text demonstrates the work of the Web API service.
” Language:
American English (en_US
)Format: json
Request Response:
Code Block | ||||
---|---|---|---|---|
| ||||
[ { "wordresult": "sampl", [ { "ud": false, "suggestionsmatches": [ "sample", { "sampled", "sampler", type": "spelling", "samplesoffset": 5, "amplelength": 5, "amplysuggestions",: [ "scamp", "stampsample", ] } ] |
Example 2.1: Check Request using GET (Output in XML)
Code Block | ||
---|---|---|
| ||
http(s)://svc.webspellchecker.net/spellcheck31/script/ssrv.fcgi?cmd=check_spelling&format=xml&text=This sampl text demonstrates the work of the WebSpellChecker Web API service.&out_type=words&slang=en_US&customerid=[encrypted_customer_ID] |
Parameters:
- Command: check
- Format: XML
- Text: “This sampl text demonstrates the work of the WebSpellChecker Web API service.”
- Language: American English (en_US)
Request Response:
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="utf-8"?> <check_spelling> <misspelling> "sampled", "sampler", <word>sampl</word> <ud>false</ud> "samples", <suggestions> <suggestion>sample</suggestion>"ample", <suggestion>sampled</suggestion> <suggestion>sampler</suggestion>"amply", <suggestion>samples</suggestion> <suggestion>ample</suggestion> "scamp", <suggestion>amply</suggestion> "stamp" <suggestion>scamp</suggestion> ] <suggestion>stamp</suggestion>}, </suggestions> </misspelling> </check_spelling> |
Example 2.3: Check Spelling Request using POST (Output in JSON)
Here we use the same request and parameters as described in example above but form it as a POST request.
Code Block | ||
---|---|---|
| ||
https://svc.webspellchecker.net/spellcheck31/script/ssrv.fcgi? |
Code Block | ||
---|---|---|
| ||
cmd=check_spelling&format=json&text=This sampl text demonstrates the work of the WebSpellChecker Web API service.&out_type=words&slang=en_US&customerid=[encrypted_customer_ID] |
Request Response:
{
"type": "grammar",
"offset": 0,
"length": 4,
"rule": "UPPERCASE_SENTENCE_START",
"message": "This sentence does not start with an uppercase letter",
"suggestions": [
"This"
]
}
]
}
]
} |
Example 1.2 [GET]: Check request for Am. English text with all available check types (output in XML)
Code Block | ||
---|---|---|
| ||
http(s)://svc.webspellchecker.net/spellcheck31/script/ssrv.fcgi?cmd=check&text=this sampl text demonstrates the work of the Web API service.&lang=en_US&format=xml&customerid=encrypted_customer_ID |
Parameters:
- Command: check
- Text: this sampl text demonstrates the work of the Web API service.
- Language: en_US
- Format: xml
Request Response:
Code Block | ||||
---|---|---|---|---|
| ||||
<result>
<result>
<matches>
<matches>
<type>spelling</type>
<offset>5</offset>
<length>5</length>
<suggestions>
<suggestions>sample</suggestions>
<suggestions>sampled</suggestions>
<suggestions>sampler</suggestions>
<suggestions>samples</suggestions>
<suggestions>ample</suggestions>
<suggestions>amply</suggestions>
<suggestions>scamp</suggestions>
<suggestions>stamp</suggestions>
</suggestions>
</matches>
<type>grammar</type>
<offset>0</offset>
<length>4</length>
<rule>UPPERCASE_SENTENCE_START</rule>
<message>This sentence does not start with an uppercase letter</message>
<suggestions>
<suggestions>This</suggestions>
</suggestions>
</matches>
</result>
</result> |
Example 1.3 [GET]: Check request for Am. English text as two tokens with all available check types (output in JSON)
Code Block | ||
---|---|---|
| ||
https://svc.webspellchecker.net/spellcheck31/script/ssrv.fcgi?cmd=check&tokens=["this sampl text.", " It demonstrate the work of the Web API service."]&lang=en_US&customerid=encrypted_customer_ID |
Parameters:
Command: check
Tokens: ["this sampl text.", " It demonstrate the work of the Web API service."]
Language: en_US
Format: json
Request Response:
Code Block | ||||
---|---|---|---|---|
| ||||
{
"result": [
{
"matches": [
{
"type": "spelling",
"offset": 5,
"length": 5,
"suggestions": [
"sample",
"sampled",
"sampler",
"samples",
"ample",
"amply",
"scamp",
"stamp"
]
},
{
"type": "grammar",
"offset": 0,
"length": 4,
"rule": "UPPERCASE_SENTENCE_START",
"message": "This sentence does not start with an uppercase letter",
"suggestions": [
"This"
]
}
]
},
{
"matches": [
{
"type": "grammar",
"offset": 4,
"length": 11,
"rule": "IT_VBZ",
"message": "Did you mean demonstrates?",
"suggestions": [
"demonstrates"
]
}
]
}
]
} |
Example 1.4 [GET]: Check request for Am. English text as two tokens with all available check types and shorntened response (output in JSON)
Code Block | ||
---|---|---|
| ||
https://svc.webspellchecker.net/spellcheck31/script/ssrv.fcgi?cmd=check&tokens=["this sampl text.", " It demonstrate the work of the Web API service."]&lang=en_US&short_answer=true&customerid=encrypted_customer_ID |
Parameters:
Command: check
Tokens: ["this sampl text.", " It demonstrate the work of the Web API service."]
Language: en_US
Format: json
- Short Answer: true
Request Response:
Code Block | ||||
---|---|---|---|---|
| ||||
{
"r": [
{
"m": [
{
"t": "spelling",
"o": 5,
"l": 5,
"s": [
"sample",
"sampled",
"sampler",
"samples",
"ample",
"amply",
"scamp",
"stamp"
]
},
{
"t": "grammar",
"o": 0,
"l": 4,
"r": "UPPERCASE_SENTENCE_START",
"m": "This sentence does not start with an uppercase letter",
"s": [
"This"
]
}
]
},
{
"m": [
{
"t": "grammar",
"o": 4,
"l": 11,
"r": "IT_VBZ",
"m": "Did you mean demonstrates?",
"s": [
"demonstrates"
]
}
]
}
]
} |
Example 1.4 [POST]: Check request for Am. English text with all available check types (output in JSON)
Here we use the same request and parameters as described in example 1.1 but form it as a POST request.
Code Block | ||
---|---|---|
| ||
https://svc.webspellchecker.net/spellcheck31/script/ssrv.fcgi? |
Code Block | ||
---|---|---|
| ||
cmd=check&text=this sampl text demonstrates the work of the Web API service.&lang=en_US&format=json&customerid=encrypted_customer_ID |
Request Response:
Code Block | ||||
---|---|---|---|---|
| ||||
{
"result": [
{
"matches": [
{
"type": "spelling",
"offset": 5,
"length": 5,
"suggestions": [
"sample",
"sampled",
"sampler",
"samples",
"ample",
"amply",
"scamp",
"stamp"
]
},
{
"type": "grammar",
"offset": 0,
"length": 4,
"rule": "UPPERCASE_SENTENCE_START",
"message": "This sentence does not start with an uppercase letter",
| ||||
Code Block | ||||
| ||||
[ { "word": "sampl", "ud": false, "suggestions": [ "samplesuggestions",: [ "sampled", "samplerThis", "samples", "ample",] "amply", } "scamp", ] "stamp" } ] } ] |