HTTP Server로 개발하기
등록된 디바이스 리스트 조회하기
ThingPlug를 통해서 계정에 등록된 LoRa 디바이스의 리스트를 조회할 수 있습니다.
LoRa 디바이스가 ThingPlug에 등록되면 등록된 순서에 따라 인덱스가 1부터 할당됩니다.
디바이스 리스트를 조회할 때, 원하는 인덱스(startIndex) 조회하려는 디바이스의 개수(countPerPage)를 입력해 원하는 디바이스의 정보를 조회할 수 있습니다.


1. ThingPlug API로 API로 디바이스 리스트 조회하기
예를 들어 1000개의 LoRa 디바이스를 조회하는 ThingPlug API는 아래와 같습니다.
Description | 계정에 등록된 LoRa 디바이스 목록을 조회합니다. |
---|---|
Requirements | ukey: 사용자 인증키 startIndex: 디바이스의 시작 인덱스 countPerPage: 디바이스의 개수 |
Request |
---|
|
Response |
|
2. 디바이스 정보 확인
응답 메시지 중 <device> 부터 </device>까지가 하나의 LoRa 디바이스에 대한 정보로 볼 수 있습니다. 총 1000개의 디바이스를 조회했지만, 실제 등록된 디바이스가 2개뿐이기 때문에 위와 같이 2개의 디바이스만 조회가 되었습니다. 등록된 전체 디바이스의 수는 <total_list_count>로 확인할 수 있습니다.
xml 소스코드 뷰어 |
---|
|
조회된 디바이스의 정보를 살펴보면, <device_Id>는 LoRa 디바이스의 고유 ID로 사용되고 있는 LTID입니다. <device_Name>, <device_type>, <category_Id>, <location_Addr> 등 입력되어 있는 정보는 LoRa 디바이스를 ThingPlug에 등록할 때 포탈에 등록한 정보입니다. 따라서 LoRa 디바이스의 실제 응용 분야, 위치 등과 다를 수 있습니다.
3. 조회 범위를 초과한 경우의 응답
만약, ThingPlug에 디바이스가 등록되어 있지 않거나, startIndex가 조회 범위를 초과한 경우, 아래와 같이 “조회된 정보가 없습니다.”라는 응답을 확인할 수 있습니다.
xml 소스코드 뷰어 |
---|
|
4. 계정에 등록된 모든 디바이스 조회하기
LoRa 디바이스의 개통이 많아지면서 ThingPlug에 등록되어 있는 디바이스의 수를 파악하기 어려울 때에는 startIndex와 countPerPage를 조정하며 모든 디바이스를 조회할 수 있습니다.
예를 들어 1010개의 LoRa 디바이스가 등록되어 있다고 하면, 아래와 같이 3회의 API 요청을 통해 모든 디바이스를 조회할 수 있습니다.
최초에 startIndex=1, countPerPage=1000 으로 조회합니다. 응답으로 인덱스 번호 1~1000 까지 1000개의 디바이스 정보를 확인할 수 있습니다.
그 후 startIndex=1001, countPerPage=1000으로 조회하게 되면 인덱스 번호로 1001번부터 2000까지의 디바이스를 조회 요청합니다. 하지만 남아있는 디바이스가 10개(1001~1010)이기 때문에 나머지 10개의 디바이스 정보만 확인할 수 있습니다.
마지막으로 startIndex=2001, countPerPage=1000으로 조회를 요청 했을 때에는 조회 가능한 디바이스 인덱스가 없기 때문에 “조회된 정보가 없습니다” 메시지를 응답하게 됩니다.