메뉴 건너뛰기

Heitu Doc

센서 데이터 조회

데이터 조회

Heitu 시스템에 저장된 센서 데이터를 조회하여 사용자의 필요에 맞춰 외부 프로그램에서 이용할 수 있습니다.

원하는 기간을 설정하여 해당 기간 동안의 센서 데이터만 조회할 수 있으며 조회 결과는 JSON 형태로 전달됩니다.

요청 URL

 

URL 매서드
https://heitu.1778tech.com/api GET
https://heitu.1778tech.com/api?cmd={cmd}&user_id={user_id}&apikey={apikey}&device_id={device_id}&start_time={start_time}&end_time={end_time}

인수

센서 데이터 조회를 위하여 입력해야 하는 값입니다.

인수 명 형식 설명 필수 여부
cmd 문자열 read O
user_id 이메일주소 사용자ID
(예: [email protected])
O
apikey 문자열 발급 받은 API key O
device_id 문자열 조회할 장치 ID O
start_time 날짜 및 시간
YYYY-MM-DD 또는
YYYY-MM-DD hh:mm:ss
조회 시작 기간
(예: 2020-12-04 또는 2020-12-04 08:00:00)
X
end_time 날짜 및 시간
YYYY-MM-DD 또는
YYYY-MM-DD hh:mm:ss
조회 종료 기간
(예: 2020-12-04 또는 2020-12-04 08:00:00)
X
 참고
- start_time을 입력하고 end_time을 입력하지 않으면 start_time일부터 오늘까지의 데이터를 조회합니다.
- start_time을 입력하지 않으면 센서의 현재 데이터를 조회합니다.

응답

응답은 JSON 형식으로 data, reslut_code의 두 개의 항목으로 구성되며, 각각에 대한 내용은 다음과 같습니다.

항목명
data 조회 요청한 데이터
result_code 응답 코드

응답코드

오류코드 설명
200 정상적인 응답
205 날씨 정보 수신 성공
300 입력한 인수의 오류 발생
302 인수의 값이 잘못됨
306 접근 경로 오류등 기타 오류
307 입력한 인수의 형식이 잘못됨
309 권한 없음
위로