---
title: "V5"
description: "이 API는 ZENTRA Cloud 2.0에 저장된 환경 측정 데이터와 장치 데이터를 프로그래밍 방식으로 액세스할 수 있는 유연하고 개발자 친화적인 인터페이스를 제공합니다."
url: "https://docs.zentracloud.io/l/ko/article/zjky832943-v-5"
category: "v5.0"
updated_at: "2026-01-31T19:28:27Z"
language: "ko"
---

# V5

V5 버전이 곧 출시될 예정입니다!

### API 개요

ZENTRA Cloud v5 API는 METER Group에서 개발한 최신 데이터 인터페이스로, 환경 및 장치 데이터에 더욱 빠르고 안정적으로 접근할 수 있도록 설계되었습니다.

#### 환경 및 장치 데이터

v5는 환경 시계열 데이터와 장치 메타데이터에 대한 통합 액세스를 제공합니다. 더욱 깔끔하고 직관적인 구조로 기존 시스템을 마이그레이션하거나 새로운 데이터 파이프라인을 구축하는 경우에도 통합 복잡성을 줄여줍니다.

#### 성장을 위해 설계되었습니다

v5 API는 ZENTRA Cloud 2.0의 핵심 동력이며 대용량 디바이스 네트워크와 엔터프라이즈급 워크플로우를 지원합니다. 최신 기능과 확장 가능한 아키텍처를 통해 v5 기반 애플리케이션은 미래 지향적인 최고의 성능을 제공합니다.

#### 속도 제한

GCRA(Generic Cell Rate Algorithm)는 정밀하고 버스트 가능한 속도 제한 알고리즘입니다. 각 클라이언트의 "이론적 도착 시간"(TAT)을 추적하고, 설정된 속도에 따라 "너무 일찍" 도착하지 않는 한 요청을 허용합니다. GCRA는 공정성과 정밀한 버스트 제어가 요구되는 통신, API 게이트웨이 및 분산 시스템에서 널리 사용됩니다.

v5는 순간 최대 통화량이 5회이며, 정상 작동 시에는 분당 1회 통화가 가능합니다.

#### v5에서 GCRA 작동 방식

- 초기 버스트 허용량: 클라이언트는 유휴 상태였던 경우 지연 없이 최대 5건의 즉시 요청을 할 수 있습니다. 이것이 허용된 버스트 용량입니다.
- 정상 상태 처리 속도: 최대 처리 용량이 소진된 후에는 추가 요청이 분당 1건의 정상 처리 속도로 제한됩니다.
- 버스트 재설정 동작: 버스트 제한 × 60초(5개 버스트의 경우 300초) 동안 요청이 없으면 버스트 허용량이 완전히 재설정됩니다.
- 이 유휴 기간이 지나면 클라이언트는 5개의 버스트 요청을 즉시 모두 수행할 수 있는 기능을 다시 갖게 됩니다.
- 조기 요청 처리: 요청이 GCRA 일정에서 허용된 시간보다 빨리 도착하면 알고리즘은 다음 호출 타임스탬프를 계산합니다. 클라이언트는 다음 요청이 수락될 때까지 이 시간 동안 기다려야 합니다.

### 시작하는 방법

#### 데이터 접근 제어

기기 데이터 접근 권한은 조직을 통해 제어됩니다. 사용자 계정은 해당 기기가 속한 조직의 구성원이어야 하며, 조직 내에서의 역할은 편집자 또는 관리자여야 합니다.

#### 계정 생성

시작하기 가이드를 따라주세요:

- [계정 생성 및 조직 설정](https://docs.zentracloud.com/l/en/article/4rzmtkxn5i-logging-in-and-setting-up-an-organization)
- [데이터 로거 추가](https://docs.zentracloud.com/l/en/article/mzu9p6hk88-add-data-logger)

#### API 키는 어디에서 찾을 수 있나요?

API 토큰 키는 사용자별로 제공됩니다. API 키는 ZENTRA Cloud 사용자 계정의 통합 [(Integrations)](https://app.zentracloud.io/profile/integrations) 섹션에서 확인할 수 있습니다. 토큰 ID를 복사하거나 다시 생성할 수 있습니다.

#### 한번 시도해 보세요

[https://api.zentracloud.io/](https://api.zentracloud.io/)

#### 매개변수

`device_id`

끈

(길)

기기의 고유 식별자입니다.

예시: `z6-12345`

`direction`

끈

(질문)

로그를 검색하고 날짜별로 표시하는 순서입니다. 사용 가능한 값: `ascending` , `descending` .

기본값: `descending`

`start_datetime`

(질문)

ISO 날짜 및 시간 문자열입니다. 시간대가 지정되지 않은 시작 날짜 및 시간은 UTC 시간대로 간주됩니다.

사용자는 날짜/시간과 타임스탬프를 동시에 입력해서는 안 되며, 둘 중 하나만 입력해야 합니다.

예시: `2025-10-20T17:15+00:00`

또는

예시: `1737367200000`

`end_datetime`

(질문)

ISO 날짜 및 시간 문자열입니다. 시간대가 지정되지 않은 종료 날짜 및 시간은 UTC 시간대로 간주됩니다.

사용자는 날짜/시간과 타임스탬프를 동시에 입력해서는 안 되며, 둘 중 하나만 입력해야 합니다.

예시: `2025-10-20T17:15+00:00`

또는

예시: `1737367200000`

`start_timestamp`

(질문)

1970년 1월 1일 00:00 UTC 이후 경과된 초를 나타내는 유닉스 타임스탬프입니다.

사용자는 날짜와 시간, 타임스탬프를 모두 입력해서는 안 되며, 둘 중 하나만 입력해야 합니다.

예시: `1763445086`

`end_timestamp`

(질문)

1970년 1월 1일 00:00 UTC 이후 경과된 초를 나타내는 유닉스 타임스탬프입니다.

사용자는 날짜와 시간, 타임스탬프를 모두 입력해서는 안 되며, 둘 중 하나만 입력해야 합니다.

예시: `1763445086`

`next_token`

(질문)

다음 페이지네이션 세트를 가져오는 데 필요한 문자열입니다.

`limit`

정수

(질문)

최대값: 1000

반환할 데이터 포인트 수입니다.

기본값: `1000`

예시: `2`

`latest`

부울

(질문)

곧 출시됩니다!

최신 데이터 포인트를 반환하며, datetime 및 timestamp 매개변수를 대체합니다.

기본값: `false`

예시: `true`

`expand`

(질문)

곧 출시됩니다!

통과한 필드에 대한 자세한 정보를 제공합니다.

예시: `settings`

`units`

끈

(질문)

데이터가 반환될 단위입니다. 사용 가능한 값: `metric` , `imperial`

기본값: `metric`

예시: `imperial`
