API Key 관리

채널은 데이터를 기록하거나 조회할 수 있는 API를 제공합니다. IoT 디바이스에서는 해당 API를 사용하여 채널에 데이터를 등록하거나 조회할 수 있습니다.

데이터 기록을 위한 API Key

채널에 데이터를 기록하는 목적으로 사용됩니다. 데이터 기록은 기본적으로 채널 소유자만 가능하므로 API Key가 노출되지 않도록 주의가 필요합니다. Key가 노출 또는 손상된 것으로 생각되면 재생성 버튼을 클릭하여 새로운 Key로 변경합니다.

※주의 : API Key 재생성시 기존 Key를 사용중인 디바이스 및 어플리케이션의 접근이 차단되어 오작동의 원인이 될 수 있음

데이터 조회를 위한 API Key

채널에 수집된 데이터에 접근할 수 있는 권한을 부여하기 위해 사용합니다. 공개 채널은 Key가 필요하지 않으나, 공유 또는 비공개 채널은 Key가 필요합니다. 목적에 따라 여러개의 Key를 추가하여 사용할 수 있으나, 기 발급된 Key를 제거할 경우 외부 디바이스 또는 어플리케이션에서 사용중일 경우 오류의 원인이 되므로 유의가 필요합니다. 첫번째 Key는 공유를 위하여 삭제가 불가능합니다.

API 요청 예시

채널 피드 쓰기

채널에 한건의 데이터를 기록합니다.

채널 피드 읽기

채널에 기록된 최근 n개의 데이터를 조회합니다.

채널 필드 읽기

채널의 n번 필드에 기록된 최근 n개의 데이터를 조회합니다.

API를 이용한 디바이스 데이터 연동

아두이노와 같이 HTTP 통신을 지원하는 디바이스에서 VlabON 채널 API를 이용하여 데이터를 등록하거나 조회할 수 있습니다. 관련 예시는 다음 페이지에서 설명합니다.