Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Addressed the latest PM's review requests.

...

#ParameterPossible ValuesDefault ValueDescription
1format
  • json
  • xml
jsonThe response format for output data.
2callback
  • callback function name

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”.
3text
  • plain text

A piece of 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 plan text as well.

Note
Avoid using # and & symbols in the text.


4tokens
  • Array of strings, e.g. ["This is a sentence number 1.", "This is a sentence number 2."]

A piece of 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.

Note

You can use either tokens or text at a time in a request. However, using text is more common.


5langen_USA short code of a language which will be used for check.
6disable_spelling
  • true
  • false
falseRegulates whether to check Check text for spelling errors or not.
7disable_grammar
  • true
  • false
falseRegulates whether to check Check text for grammar and style problems or not.
8user_dictionary
  • user dictionary name (e.g. testdict)

A user dictionary name which will be used during check spelling.

9user_wordlist
  • additional wordlist

The list of additional comma-separated words which will be used for spell checking.

10custom_dictionary
  • custom dictionary IDs (e.g. 100694)

Global custom dictionary ID(s) which can be used during check spelling.

Info

Each new Dictionary on the creation obtains its unique Dictionary ID. You can find information about your custom dictionaries by logging in to your account panel on webspellchecker.com website (Login –> Dictionaries –> List of Custom Dictionaries) Depending on the type of the version of product you are using, refer to Cloud or Server guides respectively.


11ignore_all_caps
  • 0 – Do not ignore all words written in capital letters (e.g. UPPERCASE). 
  • 1 – Ignore all words written in capital letters.
0

Regulates whether to ignore Ignore capitalized words or not.

12ignore_words_with_numbers
  • 0 – Do not ignore words that contain numbers (e.g. Number1).
  • 1 – Ignore words that contain numbers.
0

Regulates whether to ignore Ignore words containing numbers or not.

13ignore_mixed_case
  • 0 – Do not ignore words with mixed case letters (e.g. MixedCase).
  • 1 – Ignore words with mixed case letters.
0

Regulates whether to ignore Ignore words written with mixed case letters or not.

14ignore_domain_names
  • 0 – Do not ignore web addresses that start with either “www”, “http:” or “https:” and end with a domain name.
  • 1 – Ignore web addresses and domain names.
0

Regulates whether to ignore Ignore domain names, web addresses or not.

15min_word_length
  • minimal number of letters in a word to be checked
3

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.

16custom_punctuation
  • string of chars (e.g. “-“)
-

A list of characters that should be considered as delimiters during spelling check.

17short_answer
  • true
  • false
false

Enables shortening every static string JSON key name, like messages or type down to its first character, for example: 

  • m - matches, message
  • o - offset
  • l - length
  • t - type
  • r - rule
  • s - suggestions
18customerid
  • encrypted_customer_ID value

Specifies a special customer ID value that has to be passed to a request query.

A customer ID can be obtained upon subscription to the Cloud services (paid or trial).

Warning

Be sure to use a valid customer ID. Otherwise any request to Web API Cloud will fail.


...

AttributeTypeValueDescription
typestring
  • spelling
  • grammar
Type of the problem found.
offsetnumber
Start position of a problem found in a sentence/text; start position value here equals '0'’.
lengthnumber
Length The length of offset from the beginning of the error; offset here is the beginning of error related to sentence/text plus the length of the error. 
udboolean
  • true

True if a misspelled word is present in a user dictionary. This attribute-value pair is used to indicate the application not to underline the word in UI.

suggestionsarray of strings
Suggested corrections for spelling, grammar or style problem.
rulestring
Short A short description of the problem by rule; available only for type 'grammar'.
messagestring
Description of the problem; available only for type 'grammar'.

...