EzyPlatform Statistics APIs
Updated at 1693409527000Terminology
- EzyPlatform Software: The EzyPlatform software that you install on your localhost or server.
- ezyplatform.com: The platform that allows you to download the EzyPlatform software and the provided plugins.
- Target or Target Type: Components of EzyPlatform software that you use, including:
- admin: The admin component running on port
9090
. - socket: The socket component running on ports
3005 (TCP)
,2208 (ws)
,2812 (wss)
,2611 (UDP)
. - web: The website component running on port
8080
.
Overview
ezyplatform.com does not collect any sensitive user information. However, to improve the quality of the EzyPlatform product, ezyplatform.com may collect the following statistical information:
- Whether a specific target is started or stopped.
- Whether a plugin is activated, deactivated, or deleted.
ezyplatform.com does not actively collect statistical data; it is called by the EzyPlatform product via API.
How to Block Sending Statistical Data
You can go to the settings section and set allow_send_statistics_data = false
.
General Information
- All statistical data is sent to https://ezyplatform.com.
- All APIs require the
platformKey
header, which is generated automatically by ezyplatform.com each time the EzyPlatform software calls it. This key is used to identify the EzyPlatform software. platformVersion
path variable: The version of the EzyPlatform software.
API for Statistical Start Admin
POST - /api/v1/platforms/{platformVersion}/targets/admin/start {data}
In which, data
is the data sent with the API, in the form of:
public class PlatformAdminStartRequest { private List<Project> projects; }
Containing a list of plugins installed in your EzyPlatform software. Project
has the following format:
public static class Project { private String projectName; private String projectVersion; private Map<ModuleType, PlatformInstallModuleStatus> modules; }
- projectName: The name of the plugin.
- projectVersion: The version of the plugin.
- modules: A map of
PlatformInstallModuleStatus
withModuleType
. - ModuleType: One of the constants:
THEME
,WEB_PLUGIN
,SOCKET_APP
,SOCKET_PLUGIN
, andADMIN_PLUGIN
. - PlatformInstallModuleStatus: One of the constants:
INSTALLED
,ACTIVATED
,DEACTIVATED
,DELETED
.
API for Statistical Start Web or Socket
POST - /api/v1/platforms/{platformVersion}/targets/{target}/start
Where target
is the target type
.
API for Statistical Stop Admin
POST - /api/v1/platforms/{platformVersion}/targets/admin/stop
API for Statistical Stop Web or Socket
POST - /api/v1/platforms/{platformVersion}/targets/{target}/stop
Where target
is the target type
.
API for Statistical Activate Plugin
POST - /api/v1/platforms/{platformVersion}/projects/{projectName}/{projectVersion}/activate {data}
Where:
- projectName: The name of the plugin.
- projectVersion: The version of the plugin.
- data: In the following format.
public class PlatformProjectActionRequest { private Set<ModuleType> moduleTypes; }
Containing a list of ModuleTypes to activate.
API for Statistical Deactivate Plugin
POST - /v1/platforms/{platformVersion}/projects/{projectName}/{projectVersion}/deactivate {data}
Where:
- projectName: The name of the plugin.
- projectVersion: The version of the plugin.
- data: In the format of
PlatformProjectActionRequest
containing a list ofModuleType
to deactivate.
API for Statistical Delete Plugin
POST - /api/v1/platforms/{platformVersion}/projects/{projectName}/{projectVersion}/delete {data}
Where:
- projectName: The name of the plugin.
- projectVersion: The version of the plugin.
- data: In the format of
PlatformProjectActionRequest
containing a list ofModuleType
to delete.