Skip to main content
Table of Contents

V5

この API は、ZENTRA Cloud 2.0 に保存された環境測定データおよびデバイスデータにプログラムでアクセスするための、柔軟で開発者に優しいインターフェースを提供します。

Travis Bates
Updated by Travis Bates

V5はまもなく利用可能になります!

APIの概要

ZENTRA Cloud v5 API は、METER Group の最新世代のデータ インターフェイスであり、環境データとデバイス データへのより高速で一貫したアクセスを提供するように設計されています。

環境およびデバイスデータ

v5は、環境時系列データとデバイスメタデータへの統合アクセスを提供します。よりクリーンで直感的な構造により、既存システムの移行や新しいデータパイプラインの構築など、統合の複雑さを軽減します。

成長のために構築

v5 APIはZENTRA Cloud 2.0の基盤となり、大容量デバイスネットワークとエンタープライズ規模のワークフローをサポートします。最新機能と拡張可能なアーキテクチャにより、v5を基盤として構築することで、将来を見据えた最も高性能なアプリケーション基盤を構築できます。

レート制限

ジェネリックセルレートアルゴリズム（GCRA）は、高精度でバースト可能なレート制限アルゴリズムです。各クライアントの「理論上の到着時間」（TAT）を追跡し、設定されたレートに対して「早すぎる」到着でない限り、リクエストを許可します。GCRAは、公平性と高精度なバースト制御が求められる通信、APIゲートウェイ、分散システムで広く利用されています。

v5 のバースト制限は 5 で、定常状態レートは 1 分あたり 1 回の呼び出しです。

GCRA v5 の仕組み

  • 初期バースト許容量：クライアントはアイドル状態の場合、最大5件の即時リクエストを遅延なく送信できます。これが許容バースト容量です。
  • 定常レート: バースト容量が消費された後、追加のリクエストは 1 分あたり 1 リクエストの定常レートに制限されます。
  • バースト リセット動作: burst_limit × 60 秒 (5 バーストの場合は 300 秒) に等しい期間、要求が行われない場合、バースト許容量は完全にリセットされます。
  • このアイドル期間が過ぎると、クライアントは 5 つのバースト要求すべてを直ちに実行できるようになります。
  • 早期リクエストの処理：GCRAスケジュールで許可されているよりも早くリクエストが到着した場合、アルゴリズムはタイムスタンプの次回呼び出し時刻を計算します。クライアントは、次のリクエストが受け入れられるまで、この時間だけ待機する必要があります。

始め方

データアクセス制御

デバイスデータへのアクセスは組織によって制御されます。ユーザーアカウントはデバイスが所属する組織のメンバーであり、その組織における役割は編集者または管理者である必要があります。

アカウントを作成する

以下のスタートガイドに従ってください:

APIキーを見つける場所

APIトークンキーはユーザーごとに提供されます。APIキーは、ZENTRA Cloudユーザーアカウントの「統合」セクションにあります。トークンIDをコピーするか、再生成することができます。

試してみる

パラメータ

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 からの秒数を表す Unix タイムスタンプ。

ユーザーは日付時刻とタイムスタンプの両方を入力するのではなく、どちらか一方だけを入力する必要があります。

例: 1763445086

end_timestamp

（クエリ）

1970 年 1 月 1 日 00:00 UTC からの秒数を表す Unix タイムスタンプ。

ユーザーは日付時刻とタイムスタンプの両方を入力するのではなく、どちらか一方だけを入力する必要があります。

例: 1763445086

next_token

（クエリ）

次のページ区切りセットを取得するために必要な文字列。

limit

整数

（クエリ）

最大: 1000

返されるデータポイントの数。

デフォルト値: 1000

例: 2

latest

ブール値

（クエリ）

近日公開！

最新のデータポイントを返し、datetime および timestamp パラメータに優先します。

デフォルト値: false

例: true

expand

（クエリ）

近日公開！

渡されたフィールドに関する詳細情報を提供します。

例: settings

units

弦

（クエリ）

データが返される単位。使用可能な値: metric 、 imperial

デフォルト値: metric

例: imperial

How did we do?

統合

Contact