v1

latestSwagger 2.02026-07-137114146.9 KB

Data

Chart data for current feed

The Chart API is what we use on io.adafruit.com to populate charts over varying timespans with a consistent number of data points. The maximum number of points returned is 480. This API works by aggregating slices of time into a single value by averaging.

All time-based parameters are optional, if none are given it will default to 1 hour at the finest-grained resolution possible.

get/{username}/feeds/{feed_key}/data/chart

Path parameters

usernamestring required

a valid username string

feed_keystring required

a valid feed key

Query parameters

start_timestring date-time

Start time for filtering, returns records created after given time.

end_timestring date-time

End time for filtering, returns records created before give time.

resolutioninteger

A resolution size in minutes. By giving a resolution value you will get back grouped data points aggregated over resolution-sized intervals. NOTE: time span is preferred over resolution, so if you request a span of time that includes more than max limit points you may get a larger resolution than you requested. Valid resolutions are 1, 5, 10, 30, 60, and 120.

hoursinteger

The number of hours the chart should cover.

Response

A JSON record containing chart data and the parameters used to generate it.

parametersobject

columnsstring[]

The names of the columns returned as data.