플레이 기록과 회원 조회
게임 서버가 Basic 인증으로 호출합니다. 요청에는 User-Agent를 포함합니다.
판 기록 전송#
POST https://www.playus.app/v1/publisher/sessions
{"items":[{"id":"run:123","sub":"pu_ExamplePlayer123","startedAt":"2026-10-21T00:00:00Z","endedAt":"2026-10-21T00:01:30Z","durationSec":90,"result":"clear","score":1200,"stage":"1-3","mode":"solo","platform":"web","meta":{"level":3}}]}
| 필드 | 설명 |
|---|---|
| id | 필수. 앱 안에서 유일한 판 ID. 1~120자, key와 같은 허용 문자 |
| sub | 필수. 해당 앱의 PLAYUS 가명 |
| startedAt | 필수. 해석 가능한 날짜 문자열. ISO 8601 권장 |
| endedAt | 선택. 종료 시각 |
| durationSec | 선택. 초 단위, 서버에서 0~86400 범위 정수로 보정 |
| result / score | 선택. 결과(20자), 유한한 점수(정수로 저장) |
| stage / mode / platform | 선택. 40 / 20 / 20자까지 저장 |
| meta | 선택. JSON 메타데이터, 직렬화 기준 2KB 이하 |
items는 1~100건입니다. 같은 id를 다시 보내면 기존 판의 종료 정보 등 선택 필드를 갱신합니다. 재전송 때 유지할 필드도 함께 보내세요. 처음 저장된 시작 시각과 회원 연결은 바뀌지 않습니다.
{"items":[{"id":"run:123","status":"recorded"}]}
실패 항목은 status=rejected와 reason을 반환합니다. 입력 오류, unknown_sub를 구분합니다. HTTP 200에서도 각 항목을 확인하세요.
회원 상태와 오늘 보상 조회#
GET https://www.playus.app/v1/publisher/players/:sub
{"sub":"pu_ExamplePlayer123","nickname":"Player","active":true,"today":{"grantedMb":5,"capMb":50,"remainingMb":45}}
capMb=0은 상한 없음 또는 보상 비활성 설정에서 나타날 수 있습니다. remainingMb=0만으로 지급 불가를 단정하지 말고 앱 설정과 보상 API 결과를 확인하세요. 연결이 없는 sub는 404입니다.
판 기록 전송 자체는 MB 지급을 만들지 않습니다. 보상은 별도의 rewards API를 호출하세요. meta에 이메일, 전화번호, 토큰이나 개인 식별 정보를 넣지 않습니다.