새로운 세션 및 권한 가이드 및 문서 업데이트
세션 및 권한 관리를 위한 포괄적인 가이드를 추가하고 중요한 설명을 추가하여 핵심 개념 문서를 업데이트했습니다.
새로운 기능
새로운 가이드: 세션 및 권한 관리
새로운 빠른 시작 가이드를 추가했습니다: 세션 및 권한 관리. 이 가이드는 다음에 대한 단계별 지침을 제공합니다:
- Webhook 및 세션 비교를 사용한 권한 변경 감지
- 세션 삭제 및 취소 처리
- 플레이어에게 권한 변경 사항 전달
- 권한 업그레이드 흐름 구현
- Challenge가 세션과 어떻게 관련되는지 이해
이 가이드는 부모가 설정을 수정하거나 플레이어가 연령 상승하는 등 시간이 지나면서 권한 변경에 대응해야 하는 통합에 필수적입니다.
문서 업데이트
세션 문서
세션 개념 페이지에 중요한 설명을 추가했습니다:
- 세션 ID 지속성: 플레이어는 프로덕트당 정확히 하나의 세션을 가집니다. 세션 ID는 권한 변경을 통해 유지되지만, 세션이 취소되고 동의 흐름이 다시 완료되면 새로운 세션 ID가 생성됩니다.
- 세션 삭제 동작: 삭제된 세션은 오류 코드
NOT_FOUND로 HTTP 400을 반환합니다(404가 아님). 이것은 의도적인 것입니다—삭제된 세션은 존재하지 않았던 것처럼 처리해야 합니다. - 연령 상승 변경: 연령 상승 이벤트는 Webhook 알림을 트리거하지 않습니다. 이러한 변경 사항을 감지하려면 세션 비교를 사용해야 합니다.
권한 문서
권한 개념 페이지를 다음 내용으로 강화했습니다:
managedBy필드 변경:managedBy가 시간이 지나면서 변경될 수 있음을 명확히 했습니다(예: 플레이어가 연령 상승할 때GUARDIAN에서PLAYER로).- 플레이어 관리 권한: 플레이어가
/session/upgradeAPI를 통해PLAYER관리 권한을 활성화하도록 요청하면 Challenge를 생성하지 않고 자동으로 활성화됩니다. - 권한 업그레이드 콘텐츠: 권한 업그레이드 문서를 더 쉽게 찾을 수 있도록 권한 페이지에 통합했습니다.
변경 사항
통합된 문서
- 권한 업그레이드 개념 페이지를권한 페이지에 통합했습니다. 모든 참조를 새 위치로 업데이트했습니다.
다음 단계
- 새로운세션 및 권한 관리 가이드를 검토하세요
- 통합이 세션 삭제를 올바르게 처리하는지 확인하세요(
NOT_FOUND로 HTTP 400)
이러한 업데이트에 대한 질문이 있거나 통합에 대한 지원이 필요한 경우 지원 팀에 문의하세요.