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

1. ThingPlug API로 API로 디바이스 리스트 조회하기

예를 들어 1000개의 LoRa 디바이스를 조회하는 ThingPlug API는 아래와 같습니다.

GET /ThingPlug?division=searchDevice&function=myDevice&startIndex=1&countPerPage=1000 HTTP/1.1
Host: thingplugtest.sktiot.com:9443
X-M2M-RI: 00000004702c1ffffe1d79da_23455
X-M2M-Origin: 00000004702c1ffffe1d79da
ukey: dG5janFndjNibzZ**************ERjd296V0poMFY0TTJ4UQ==

2. 디바이스 정보 확인

응답 메시지 중 <device> 부터 </device>까지가 하나의 LoRa 디바이스에 대한 정보로 볼 수 있습니다. 총 1000개의 디바이스를 조회했지만, 실제 등록된 디바이스가 2개뿐이기 때문에 위와 같이 2개의 디바이스만 조회가 되었습니다. 등록된 전체 디바이스의 수는 <total_list_count>로 확인할 수 있습니다.

조회된 디바이스의 정보를 살펴보면, <device_Id>는 LoRa 디바이스의 고유 ID로 사용되고 있는 LTID입니다. <device_Name>, <device_type>, <category_Id>, <location_Addr> 등 입력되어 있는 정보는 LoRa 디바이스를 ThingPlug에 등록할 때 포탈에 등록한 정보입니다. 따라서 LoRa 디바이스의 실제 응용 분야, 위치 등과 다를 수 있습니다.

3. 조회 범위를 초과한 경우의 응답

만약, ThingPlug에 디바이스가 등록되어 있지 않거나, startIndex가 조회 범위를 초과한 경우, 아래와 같이 “조회된 정보가 없습니다.”라는 응답을 확인할 수 있습니다.

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으로 조회를 요청 했을 때에는 조회 가능한 디바이스 인덱스가 없기 때문에 “조회된 정보가 없습니다” 메시지를 응답하게 됩니다.