> For the complete documentation index, see [llms.txt](https://kopens.gitbook.io/plantpulse-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kopens.gitbook.io/plantpulse-platform/developer/api-manual/system-service.md).

# 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 사용 예시

```java
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());
```

`ping()`은 `connect()` 가 완료된 직후 헬스체크 용도로 호출하기 좋습니다.

## 다음 단계

* [Site 서비스](/plantpulse-platform/developer/api-manual/site-service.md) — 첫 사이트 등록