화면 모드
요청·응답 형식
요청 본문은 JSON(Content-Type: application/json, UTF-8)이에요. 응답은 항상 같은 모양이에요.
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는 바뀔 수 있어요. → 오류 코드 server_time은 서버 시각(epoch 초)이에요. 일일 보상처럼 기기 시계를 믿으면 안 되는 판단에 쓰세요.- 문의할 때는
trace_id를 함께 보내 주세요. 응답 헤더X-Trace-Id에도 있어요. - 시각 값은 모두 **epoch 초(UTC)**예요.
- ID 값(
player_id,purchase_id,reward_id등)은 문자열로 다루세요. - 요청에
X-Request-Id(8~64자 영숫자·-)를 보내면 그 값이trace_id가 돼요.