Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

...

Parameters

Type

Name

Required

Description

Schema

Default

Path

projectId

YES

The project Id, e.g. 1111.

int64

Query

beaconId

NO

The id of the beacon, e.g. beaconId=111111111111111

Multiple beaconIds should be separated by commase.g. beaconId=1,2,3

string <array>

 **all beacons in project

Query

interval

YES

The interval for the metric, i.e. the granularity of the data, e.g.interval=1d

enum

  • 1d 1s (day)
  • 1m (minute)
  • 1H (hour)

Query

metric

YES

The type of metric requested, e.g.metric=RSSI.

enum

  • TEMP
  • RSSI
  • PER_BLUFI_RSSI
  • LUMS
  • X_ACCEL
  • Y_ACCEL
  • Z_ACCEL
  • X_ACCEL_HS
  • Y_ACCEL_HS
  • Z_ACCEL_HS
  • X_MAG
  • Y_MAG
  • Z_MAG
  • X_VELOCITY
  • Y_VELOCITY
  • Z_VELOCITY
  • MAG_STATE
  • BATTERY

Query

startDate

YES

The start date of the data requested. Must be in ISO 8601 format compliant, e.g.startDate=2017-09-11T13:39:57.420Z.

string 


Query

endDate

YES

The end date of the data requested. Must be in ISO 8601 format compliante.g. endDate=2017-09-25T13:39:57.421Z.

string


Query

format

YES

The desired format of the data, e.g. format=json

enum

  • json
  • csv

Query

download

NO

Whether to include a Content-Disposition header, e.g.Content-Disposition: attachment; filename="mag-state-aggregation_project-3089_09-20-2017_13-39-57-09-24-2017_13-39-57.json"

boolean

true


...

Type

Name

Required

Description

Schema

Default

Path

projectId

YES

The project Id, e.g. 3089.

int64

Query

beaconId

NO

The id of the beacon, e.g. beaconId=111111111111111

Multiple beaconIds should be separated by commase.g. beaconId=1,2,3

string <array>

 **all beacons in project

Query

startDate

YES

The start date of the data requested. Must be in ISO 8601 format compliant, e.g.startDate=2017-09-11T13:39:57.420Z.

string 


Query

endDate

YES

The end date of the data requested. Must be in ISO 8601 format compliante.g. endDate=2017-09-25T13:39:57.421Z.

string


Query

download

NO

Whether to include a Content-Disposition header, e.g.Content-Disposition: attachment; filename="mag-state-aggregation_project-3089_09-20-2017_13-39-57-09-24-2017_13-39-57.json"

boolean

false

QuerydataTypeYES

The advertisement data being request, e.g. dataType=motion.

enum <array>

  • sSpec
  • unknown
  • hearRate
  • sBv1
  • sBv2
  • tracking
  • sLight
  • sSns
  • sSnsNano
  • sSnsSummary
  • motion
  • mag
  • iBeacon
  • eddystoneUid
  • eddystoneUrl
  • eddystoneTlm
  • deviceStat
  • blufiProps
  • blufiCon
  • probe
  • df

...

Parameters

Type

Name

Required

Description

Schema

Default

Path

projectId

YES

The project Id, e.g. 3089.

int64

Query

beaconId

NO

The id of the beacon, e.g. beaconId=111111111111111

Multiple beaconIds should beseparated by commase.g. beaconId=1,2,3

string


Query

interval

YES

The interval for the metric, i.e. the granularity of the data, e.g.interval=1d

enum

  • 1d
  • 1s
  • 1m
  • 1H

Query

startDate

YES

The start date of the data requested. Must be in ISO 8601 format compliant, e.g. startDate=2017-09-11T13:39:57.420Z.

string 


Query

endDate

YES

The end date of the data requested. Must be in ISO 8601 format compliante.g. endDate=2017-09-25T13:39:57.421Z.

string


Query

format

YES

The desired format of the data, e.g. format=json

enum

  • json
  • csv

Query

download

NO

Whether to include a Content-Disposition header, e.g.Content-Disposition: attachment; filename="mag-state-aggregation_project-3089_09-20-2017_13-39-57-09-24-2017_13-39-57.json"

boolean

false

Request 

...

Type

Name

Required

Description

Schema

Default

Path

projectId

YES

The project Id, e.g. 3089.

int64

Query

beaconId

NO

The id of the beacon, e.g. beaconId=111111111111111

Multiple beaconIds should be separated by commase.g. beaconId=1,2,3

string


Query

dataType

YES

The advertisement data being request, e.g. dataType=motion.

enum

  • sSnsSummary
  • sSnsNano
QuerystorageTypeYESDescribe how you would like the fetch the data. ALL will query both cache and long term storage for result. CACHE: only hits cache. STORAGE: only hits long term storage. For Example, storageType=all 

enum 

  • ALL
  • CACHE 
  • STORAGE

QueryfilterNO

Filter the type of raw metric. Each filter should be separated by a comma, e.g. filters=low_res,high_res

enum 

  • LOW_RES
  • HIGH_RES
  • ADV
  • NON_ADV

QuerydeviceJobIdNOFilter by deviceJobIdint64
QuerysessionIdNOFilter by sessionIdstring

Query

startDate

YESThe start date of the data requested. Must be in ISO 8601 format compliant, e.g. startDate=2017-09-11T13:39:57.420Z.

string 


Query

endDate

YES

The end date of the data requested. Must be in ISO 8601 format compliante.g. endDate=2017-09-25T13:39:57.421Z.

string


Query

format

YES

The desired format of the data, e.g. format=json

enum

  • json
  • csv

QueryheaderNOWhether to include headers in the CSV (only applicable when format=csv)booleantrue
QueryseparatorNOThe separator for the CSV response. By default, commas are used, if the separator is "eu" then semi-colons are used. Any separator can be used as long as it's only a single character, e.g. separator=(only applicable when format=csv)stringdefault

...

Type

Name

Required

Description

Schema

Default

Path

projectId

YES

The project Id, e.g. 3089.

int64

Query

beaconId

NO

The id of the beacon, e.g. beaconId=111111111111111

Multiple beaconIds should be separated by commase.g. beaconId=1,2,3

string


Query

startDate

YESThe start date of the data requested. Must be in ISO 8601 format compliant, e.g. startDate=2017-09-11T13:39:57.420Z.

string 


Query

endDate

YES

The end date of the data requested. Must be in ISO 8601 format compliante.g. endDate=2017-09-25T13:39:57.421Z.

string


QueryformatYES

The desired format of the data, e.g. format=json

enum

  • json
  • csv

QuerybaseTempNO
float
QuerydetailsNO
booleanfalse
QuerydownloadNOWhether to include a Content-Disposition header, e.g.Content-Disposition: attachment; filename="mag-state-aggregation_project-3089_09-20-2017_13-39-57-09-24-2017_13-39-57.json"booleantrue
QueryrawNO
booleanfalse
QueryshowClosedNO
booleanfalse
QueryheaderNOWhether to include headers in the CSV (only applicable when format=csv)booleantrue
QueryseparatorNOThe separator for the CSV response. By default, commas are used, if the separator is "eu" then semi-colons are used. Any separator can be used as long as it's only a single character, e.g. separator=(only applicable when format=csv)

enum

  • default
  • eu
default

...

Type

Name

Required

Description

Schema

Default

Path

projectId

YES

The project Id, e.g. 3089.

int64

Query

beaconId

NO

The id of the beacon, e.g. beaconId=111111111111111

Multiple beaconIds should be separated by commase.g. beaconId=1,2,3

string


Query

startDate

YESThe start date of the data requested. Must be in ISO 8601 format compliant, e.g. startDate=2017-09-11T13:39:57.420Z.

string 


Query

endDate

YES

The end date of the data requested. Must be in ISO 8601 format compliante.g. endDate=2017-09-25T13:39:57.421Z.

string


QueryformatYES

The desired format of the data, e.g. format=csv

enum

  • csv

QuerydownloadNOWhether to include a Content-Disposition header, e.g.Content-Disposition: attachment; filename="mag-state-aggregation_project-3089_09-20-2017_13-39-57-09-24-2017_13-39-57.json"booleantrue
QueryrcmOnlyNOWhether you only want remote condition monitoring data, e.g. rcmOnly=true

QueryheaderNOWhether to include headers in the CSV (only applicable when format=csv)booleantrue
QueryseparatorNOThe separator for the CSV response. By default, commas are used, if the separator is "eu" then semi-colons are used. Any separator can be used as long as it's only a single character, e.g. separator=(only applicable when format=csv)

enum

  • default
  • eu
default
QuerydataTypeYESThe advertisement data being request, e.g. dataType=sBv2

enum

  • sSpec
  • unknown
  • hearRate
  • sBv1
  • sBv2
  • tracking
  • sLight
  • sSns
  • sSnsNano
  • sSnsSummary
  • motion
  • mag
  • iBeacon
  • eddystoneUid
  • eddystoneUrl
  • eddystoneTlm
  • deviceStat
  • blufiProps
  • blufiCon
  • probe
  • df

...