Miscellaneous

This section contains the following information:

  • Timestamps
  • Tokens

Timestamps

The Platform API uses region-independent timestamps to record the time that certain actions are performed. These timestamps take on the form of Unix Time, predominantly in milliseconds, which is a 13-digit number (for example, 1484012373521). A few resources, notably channels, contain timestamps in the form of seconds, which are 10-digits long. The length of the timestamp is specified in the parameter description in the Platform API docs.

Note: Unix time may be checked on most Unix systems by typing date +%s on the command line.


Tokens

When querying a set of data, the Platform API uses tokens to return results in small and continuous chunks. A token is simply an encoded location within a list, and can be passed as a parameter to begin a query from that location.

For example, calling a List query with the following parameters would return 20 items starting from the location encoded in token=YXYWRFBTQlArEUBXWFNeF2p2FEFdUA~~.

?token=YXYWRFBTQlArEUBXWFNeF2p2FEFdUA~~&limit=20

A List query typically returns a next field in the response body. This field contains the next token, which can be used to load the next chunk of results. If this field is blank, the query has reached the end of its results.

Note: If a token is not specified, the query is started from the beginning of the data set.