Data Types

Here is the list of basic data types mentioned in the API documentation:

String

Specified "as-is" in responses and requests.

Integer

Specified as a sequence of digits optionally prefixed with , in responses and requests.

Float

Specified as a sequence of digits separated by . and optionally prefixed with -, in responses and requests.

Timestamp

In responses dates are returned in the ISO-8601 format.

In requests you can use:

  • The ISO-8601 format, e.g.: 2015-09-08T01:55:28+05:00
  • The Unix time format, e.g.: 1441828693

Boolean

Booleans are represented as true or false in responses.

In requests in addition to case-insensitive true and false you can use integers 1 and 0.

Binary

Binary data are to be base64-encoded, in responses and requests.

Option

Options are returned as upper-case strings in responses.

In requests they are case-insensitive.

Array

Responses use JSON to represent arrays.

In requests you can use the following formats:

  • JSON array, if you use the JSON request format, e.g.: "numbers": [1, 2, 3]
  • The field name plus [], e.g.: numbers[]=1&numbers[]=2&numbers[]=3
  • Comma-separated values (if values do not contain special symbols), e.g.: numbers=1,2,3