Documentation Center

API- Table of responses to discovery command

Describes the structure and content of a response to the discovery command, particularly useful to check what is mandatory.

Discovery commands and their response.

StructureTypeRequiredDescription
discoveryobjectYesthe name of the command that was requested
 commandsarray (of objects)Yesarray of all supported commands
  command valueYesthe name of the command
  description valueYessimple description of command functionality
  notes valueNoextra information
  parameters array (of objects)NOarray of all parameters this command supports
   namevalueYesname of the parameter
   descriptionvalueYessimple description of the parameter
   requiredbooleanYesis this parameter mandatory? true|false
   format valueNo

This field provides information about the format of the parameter. This is used by the API to validate the format received and to provide clues and a means for API consumers to present input fields and perform validation before sending the command to the server.

Possible values:

  • Bool: true / false
  • Number: integer or decimal
  • array: a JSON array
  • object: a JSON object
  • string
  • password
  • /regex/

where regex is the actual regular expression and must be compatible with both .NET and Javascript regex syntax. (Note: not validated on Server at the moment)

If format is set, the server will enforce it.

The server will attempt to cast strings to the type specified. For example, "123.4" and 123.4 are acceptable values.

   accepts array (of values)No

This is an array of values that the command accepts in this filed. Ie. For language, this could be ['en','ru']. Note that accepted values are case insensitive, so any of following values are acceptable ['en', 'EN', 'En', 'ru', 'RU', 'Ru']. Values in this array must pass the format value, if defined.

If accepts is missing, or null, then the field is not limited. If accepts is an empty array, then no values are permitted (i.e. the field cannot currently be set).