4. System 服务
通过 client.system() 访问。V5 中仅提供健康检查一项功能。
4.1 方法
| 方法 | 返回类型 | HTTP | 端点 |
|---|---|---|---|
ping() | SystemPingResponseV5 (或 null) | GET | /api/v5/ping |
4.2 SystemPingResponseV5 DTO
| 字段 | 类型 | 说明 |
|---|---|---|
ping | boolean | 服务器响应可用性 (true = 正常) |
version | String | 服务器版本 (例如: "5.0") |
4.3 使用示例
import plantpulse.api.v5.dto.response.SystemPingResponseV5;
SystemPingResponseV5 ping = client.system().ping();
if (ping == null) {
System.err.println("서버 응답 없음 — 네트워크 또는 인증 확인");
return;
}
System.out.println("서버 가용: " + ping.isPing());
System.out.println("서버 버전: " + ping.getVersion());
在 connect() 完成后立即调用 ping() 进行健康检查是较为合适的做法。
后续步骤
- Site 服务 — 注册第一个站点