API Reference · 플레이 로그

플레이 로그 중단

사용자 이탈·실패 등으로 플레이를 중단 처리합니다. 보상 매칭은 트리거되지 않으며, 통계만 갱신됩니다.

POST/api/v1/campaigns/{campaign_id}/playlogs/{play_log_id}/abort

요청 파라미터

campaign_id (path, uuid, required) — 캠페인 식별자.
play_log_id (path, uuid, required) — 플레이 식별자.
reason (body, string, optional) — 중단 사유 코드 (예: USER_LEFT, TIMEOUT, ERROR).
aborted_at (body, ISO 8601, optional) — 중단 시각. 생략 시 서버 시각.
metadata (body, object, optional) — 디버깅용 부가 정보.

요청예시

shell

curl -X POST \
  "https://added.blomics.net/api/v1/campaigns/{campaign_id}/playlogs/{play_log_id}/abort" \
  -H "Authorization: Bearer {provider_secret}" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "USER_LEFT" }'

응답 필드

play_log_id (uuid)
status (string) — ABORTED.
reason (string, nullable)
aborted_at (ISO 8601)

응답예시

json

{
  "play_log_id": "0193a1b2-3c4d-5e6f-7890-abcdef012345",
  "status": "ABORTED",
  "reason": "USER_LEFT",
  "aborted_at": "2026-05-02T10:08:00.000Z"
}

에러처리

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