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. |
|
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 |