본문으로 건너뛰기

측정 데이터 조회

배송 중 측정된 데이터를 조회합니다.

비실시간 디바이스의 경우 도착이 완료된 후에 측정 데이터 조회가 가능합니다.

최대 5일까지 측정 데이터를 조회할 수 있습니다.

Request


GET https://openapi.willog.io/ext/v2/devices/{serial}/measurements

Path Variable

NameDescription
serial디바이스 시리얼

Query Parameters

NameTypeRequiredDescription
startAtUnix timestamp(ms)true조회 범위 시작 시간
endAtUnix timestamp(ms)true조회 범위 마지막 시간
customerCodeStringfalse고객사 코드
measurementTypesArraytrue조회할 측정 타입

Measurement Types

NameDescription
TEMPERATURE온도
HUMIDITY습도
ACC가속도
ACCX가속도 X축
ACCY가속도 Y축
ACCZ가속도 Z축
TILTX기울기 X축
TILTY기울기 Y축
TILTZ기울기 Z축
EXP조도(Lux)

Example Request

GET /ext/v2/devices/{serial}/measurements?startAt=1738655274000&endAt=1738655274000&measurementTypes=TEMPERATURE&measurementTypes=HUMIDITY
Authorization: Bearer token

Response


Response Body

NameTypeNot-nullDescription
itemsArraytrue측정 데이터 목록
timeUnix timestamp(ms)true측정 시간
temperatureNumberfalse온도
humidityNumberfalse습도
accNumberfalse가속도
accxNumberfalse가속도 X
accyNumberfalse가속도 Y
acczNumberfalse가속도 Z
tiltxNumberfalse기울기 X
tiltyNumberfalse기울기 Y
tiltzNumberfalse기울기 Z

Example Response

HTTP/1.1 200 OK

{
"items": [
{
"time": 1738655274000,
"temperature": 36.5,
"humidity": 56
}
]
}

Error Responses

- customerCode에 대한 권한 없음

HTTP/1.1 400 Bad Request

{
"code": "A0016"
}

- 등록되지 않은 Device

HTTP/1.1 400 Bad Request

{
"code": "T0007"
}

- 측정 데이터 조회 범위 초과

HTTP/1.1 400 Bad Request

{
"code": "E0004"
}