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 | 권한 없음 |