JSON Serializer

The default OpenTSDB serializer parses and returns JSON formatted data. Below you’ll find details about the serializer and request parameters that affect only the the JSON serializer. If the serializer has extra parameters for a specific endpoint, they’ll be listed below.

Serializer Name

json

Serializer Options

The following options are supported via query string:

Parameter	Data Type	Required	Description	Default	Example
jsonp	String	Optional	Wraps the response in a JavaScript function name passed to the parameter.	empty	jsonp=callback

JSONP

The JSON formatter can wrap responses in a JavaScript function using the jsonp query string parameter. Supply the name of the function you wish to use and the result will be wrapped.

Example Request

http://localhost:4242/api/version?jsonp=callback

Example Response

callback({
    "timestamp": "1362712695",
    "host": "DF81QBM1",
    "repo": "/c/temp/a/opentsdb/build",
    "full_revision": "11c5eefd79f0c800b703ebd29c10e7f924c01572",
    "short_revision": "11c5eef",
    "user": "df81qbm1_/clarsen",
    "repo_status": "MODIFIED",
    "version": "2.0.0"
})

api/query

The JSON serializer allows some query string parameters that modify the output but have no effect on the data retrieved.

Name	Data Type	Required	Description	Default	Example
arrays	Boolean	Optional	Returns the data points formatted as an array of arrays instead of a map of key/value pairs. Each array consists of the timestamp followed by the value.	false	arrays=true