> For the complete documentation index, see [llms.txt](https://yoolee741.gitbook.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yoolee741.gitbook.io/overview.md).

# 개요 (Overview)

본 API 문서는 GEMS 기기에서 수집된 모든 데이터와 각 기기의 상세 정보를 조회하기 위해 작성되었습니다. 본 문서에 포함된 API는 총 2개로 구성되어 있으며, 각각의 기능은 건물에 설치된 GEMS 장비 각각에 대한 정보 조회 리스트 API와 GEMS를 통해 수집된 모든 데이터 조회 API 입니다.

## 참고 및 문의사항

**API Key 요청**

* 요청에 필요한 **API key (ex. x-api-key)** 는 **생성 후 전달주시면** 해당 키를 사용해 API 호출 요청하겠습니다. 

**API 호출 주기**

* **API 호출 주기를 5분으로 설정**해도 서버 부하 측면에서 괜찮은지 문의드립니다.
* 호출 주기에 대한 권장사항이 있다면 알려주시기 바랍니다.

**데이터 형태**

* GEMS에서 **수집되는 전체 데이터의 타입 및 형식을 사전에 전달**받을 수 있을지 문의드립니다. 

{% content-ref url="/pages/ADc9pkcsU4Hlkn1UnApu" %}
[API Requests](/reference/api-requests.md)
{% endcontent-ref %}