---
url: https://developers.webzenk.kr/api/format.md
---
# 요청·응답 형식

요청 본문은 JSON(`Content-Type: application/json`, UTF-8)입니다. 응답은 항상 같은 모양입니다.

::: code-group

```json [성공]
{ "ok": true, "data": { }, "server_time": 1795055466 }
```

```json [실패]
{
  "ok": false,
  "error": { "code": "VERSION_CONFLICT", "message": "version mismatch for 'save'", "details": { "current_version": 3 } },
  "trace_id": "08ff8730afadaf78",
  "server_time": 1795055466
}
```

:::

* 오류는 HTTP 상태와 \*\*`error.code`\*\*로 판단하세요. `message`는 바뀔 수 있습니다. → [오류 코드](./errors)
* `server_time`은 서버 시각(epoch 초)입니다. 일일 보상처럼 기기 시계를 믿으면 안 되는 판단에 쓰세요.
* 문의할 때는 `trace_id`를 함께 보내 주세요. 응답 헤더 `X-Trace-Id`에도 있습니다.
* 시각 값은 모두 \*\*epoch 초(UTC)\*\*입니다.
* ID 값(`player_id`, `purchase_id`, `reward_id` 등)은 **문자열**로 다루세요.
* 요청에 `X-Request-Id`(8~64자 영숫자·`-`)를 보내면 그 값이 `trace_id`가 됩니다.
