Table of Contents
V5
이 API는 ZENTRA Cloud 2.0에 저장된 환경 측정 데이터와 장치 데이터를 프로그래밍 방식으로 액세스할 수 있는 유연하고 개발자 친화적인 인터페이스를 제공합니다.
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 일정에서 허용된 시간보다 빨리 도착하면 알고리즘은 다음 호출 타임스탬프를 계산합니다. 클라이언트는 다음 요청이 수락될 때까지 이 시간 동안 기다려야 합니다.
시작하는 방법
데이터 접근 제어
기기 데이터 접근 권한은 조직을 통해 제어됩니다. 사용자 계정은 해당 기기가 속한 조직의 구성원이어야 하며, 조직 내에서의 역할은 편집자 또는 관리자여야 합니다.
계정 생성
시작하기 가이드를 따라주세요:
API 키는 어디에서 찾을 수 있나요?
API 토큰 키는 사용자별로 제공됩니다. API 키는 ZENTRA Cloud 사용자 계정의 통합 (Integrations) 섹션에서 확인할 수 있습니다. 토큰 ID를 복사하거나 다시 생성할 수 있습니다.
한번 시도해 보세요
매개변수
끈 (길) | 기기의 고유 식별자입니다. 예시: |
끈 (질문) | 로그를 검색하고 날짜별로 표시하는 순서입니다. 사용 가능한 값: 기본값: |
(질문) | ISO 날짜 및 시간 문자열입니다. 시간대가 지정되지 않은 시작 날짜 및 시간은 UTC 시간대로 간주됩니다. 사용자는 날짜/시간과 타임스탬프를 동시에 입력해서는 안 되며, 둘 중 하나만 입력해야 합니다. 예시: 또는 예시: |
(질문) | ISO 날짜 및 시간 문자열입니다. 시간대가 지정되지 않은 종료 날짜 및 시간은 UTC 시간대로 간주됩니다. 사용자는 날짜/시간과 타임스탬프를 동시에 입력해서는 안 되며, 둘 중 하나만 입력해야 합니다. 예시: 또는 예시: |
(질문) | 1970년 1월 1일 00:00 UTC 이후 경과된 초를 나타내는 유닉스 타임스탬프입니다. 사용자는 날짜와 시간, 타임스탬프를 모두 입력해서는 안 되며, 둘 중 하나만 입력해야 합니다. 예시: |
(질문) | 1970년 1월 1일 00:00 UTC 이후 경과된 초를 나타내는 유닉스 타임스탬프입니다. 사용자는 날짜와 시간, 타임스탬프를 모두 입력해서는 안 되며, 둘 중 하나만 입력해야 합니다. 예시: |
(질문) | 다음 페이지네이션 세트를 가져오는 데 필요한 문자열입니다. |
정수 (질문) 최대값: 1000 | 반환할 데이터 포인트 수입니다. 기본값: 예시: |
부울 (질문) | 곧 출시됩니다! 최신 데이터 포인트를 반환하며, datetime 및 timestamp 매개변수를 대체합니다. 기본값: 예시: |
(질문) | 곧 출시됩니다! 통과한 필드에 대한 자세한 정보를 제공합니다. 예시: |
끈 (질문) | 데이터가 반환될 단위입니다. 사용 가능한 값: 기본값: 예시: |
How did we do?
통합
