API機能と管理

EMQX CloudのAPIは、プラットフォームAPIとデプロイメントAPIの2種類に分類され、いずれもRESTfulに準拠しています。プラットフォームAPIはプラットフォームレベルの機能の制御および管理に使用され、デプロイメントAPIはデプロイメントレベルの機能管理に使用されます。本章では、プラットフォームAPIおよびデプロイメントAPIへのアクセス方法と使用方法を紹介します。

APIの呼び出し

プラットフォームAPIおよびデプロイメントAPIのページには、APIアクセスアドレスの取得方法が記載されています。APIにはHTTPS経由でアクセスし、ネットワーク上で送信されるすべてのデータがTLSで暗号化されていることを確認してください。

認証

HTTP APIはBasic認証を使用しており、IDとパスワードはプラットフォームAPIの場合はKeyとSecret、デプロイメントAPIの場合はApp IDとApp Secretである必要があります。そのため、プラットフォームAPIキーの作成またはデプロイメントAPIキーの作成が必要です。すべてのSecretは作成時に一度だけ表示され、安全に保管してください。

HTTPステータスコード

以下のHTTPステータスコードはプラットフォームAPIおよびデプロイメントAPIの両方に適用されます。呼び出しが成功するとインターフェースは200を返し、レスポンスはJSON形式で返されます。

ステータスコード一覧：

ステータスコード	説明
200	成功。返されるJSONデータに詳細情報が含まれます。
400	クライアントのリクエストが無効（リクエストボディやパラメータの誤りなど）。
401	クライアント認証に失敗（認証情報が無効な可能性があります）。
404	リクエストされたパスが見つからない、または対象オブジェクトが存在しない。
422	プロパティの誤り。
500	サーバーがリクエスト処理中に内部エラーが発生。