Skip to content

Platform API

This section introduces the EMQX Platform API functionality and how to create and manage the platform API key for secure access control.

API Function

Currently, the EMQX Platform supports TLS certificate management, deployment management, and project management API. More platform-level APIs will be supported in the future.

APIDeployment TypeDescription
TLS Certificate ManagementEMQX Dedicated v5 deployment
EMQX v4 (4.4.x) deployment created under the Platform account
Manage the lifecycle of TLS certificates for a specified deployment.
Deployment ManagementEMQX Dedicated v5 deployment
EMQX v4 (4.4.x) deployment created under the Platform account
Query deployment status, start, stop, and create deployment.
Project ManagementN/AQuery project list

Create and Manage Platform API Key

Platform API Keys provide access management at the Platform level. You can create and manage Platform API Keys under a Root User or Administrator account. Accounts with other roles cannot create or manage Platform API Keys.

  1. Log in to the EMQX Platform with your account.

  2. Click the User icon in the upper right corner and select Platform API Key to access the Platform API Key page.

    platform_key

  3. Click Create New Key. Enter a description in the API Key Description. Click Create Platform API Key.

  4. Select the Functionality Scope and Project Scope according to your needs. The API can be used within the selected projects. Click Next.

  5. Store the API key and secret safely. Click Confirm and Return.

Now you have created the Platform API key. You can click the key to modify the API info and scope. You can also delete the API key by clicking the delete icon on the page.