측정 데이터 조회

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

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

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

Request

---

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

Path Variable

Name	Description
serial	디바이스 시리얼

Query Parameters

Name	Type	Required	Description
startAt	Unix timestamp(ms)	true	조회 범위 시작 시간
endAt	Unix timestamp(ms)	true	조회 범위 마지막 시간
customerCode	String	false	고객사 코드
measurementTypes	Array	true	조회할 측정 타입

Measurement Types

Name	Description
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

Name	Type	Not-null	Description
items	Array	true	측정 데이터 목록
time	Unix timestamp(ms)	true	측정 시간
temperature	Number	false	온도
humidity	Number	false	습도
acc	Number	false	가속도
accx	Number	false	가속도 X
accy	Number	false	가속도 Y
accz	Number	false	가속도 Z
tiltx	Number	false	기울기 X
tilty	Number	false	기울기 Y
tiltz	Number	false	기울기 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"
}