API Reference · 플레이 로그

플레이 로그 갱신

진행 중인 플레이의 중간 상태(점수·진행도·메타데이터)를 업데이트합니다. finish/abort 전에 임의 횟수 호출 가능합니다.

PATCH/api/v1/campaigns/{campaign_id}/playlogs/{play_log_id}

요청 파라미터

campaign_id (path, uuid, required) — 캠페인 식별자.
play_log_id (path, uuid, required) — 플레이 식별자.
score (body, number, optional) — 현재 점수.
progress (body, number, optional) — 진행도 (0.0 ~ 1.0).
metadata (body, object, optional) — 자유 형식 부가 정보.

요청예시

shell

curl -X PATCH \
  "https://added.blomics.net/api/v1/campaigns/{campaign_id}/playlogs/{play_log_id}" \
  -H "Authorization: Bearer {provider_secret}" \
  -H "Content-Type: application/json" \
  -d '{ "score": 1200, "progress": 0.6 }'

응답 필드

play_log_id (uuid)
score (number, nullable)
progress (number, nullable)
updated_at (ISO 8601)

응답예시

json

{
  "play_log_id": "0193a1b2-3c4d-5e6f-7890-abcdef012345",
  "score": 1200,
  "progress": 0.6,
  "updated_at": "2026-05-02T10:05:00.000Z"
}

에러처리

400 INVALID_PARAM — body 형식 오류.
401 UNAUTHORIZED — 인증 실패.
404 NOT_FOUND — 플레이 로그 없음 또는 소유권 위반.
409 PLAY_LOG_CLOSED — 이미 finish/abort 된 플레이.
500 INTERNAL_ERROR — 서버 오류.