콘솔 및 QR 코드 흐름을 위한 위젯 ID와 위젯 상태

end-to-end 및 연령 게이트 위젯이 이제 widgetId를 반환하므로, 콘솔에 표시된 QR 코드를 스캔한 휴대폰처럼 플레이어가 다른 기기에서 완료한 흐름의 결과를 서버에서 알 수 있습니다. 지금까지 이 결과는 DOM 이벤트나 리디렉션으로만 돌아왔고, 콘솔은 둘 다 받을 수 없었습니다.

새로운 기능

• 위젯 URL 응답의 widgetId. /widget/generate-e2e-url과 /widget/generate-age-gate-url이 url, shortUrl과 함께 widgetId를 반환합니다. 플레이어와 연결해 저장하세요.
• 위젯 상태 엔드포인트. GET /widget/get-status는 위젯 하나의 결과를 반환합니다: PENDING, PASS, IN_CHALLENGE, FAILED, PROHIBITED, EXPIRED. POST /widget/get-status는 한 번에 최대 100개 위젯을 읽습니다. 위젯이 한 번 PASS를 보고하면 이후에도 계속 PASS를 보고합니다.
• Challenge.StateChange의 widgetId. 이 위젯들에서 시작된 챌린지는 이제 webhook에 widgetId를 포함합니다.

호환성

모든 변경은 추가 사항이며, 기존 필드의 의미는 그대로입니다. OpenAPI 명세에서 클라이언트를 생성한다면 /widget/generate-e2e-url과 /widget/generate-age-gate-url의 응답 타입 이름이 각각 GenerateE2EUrlResponse와 GenerateAgeGateUrlResponse로 바뀌며, 기존 형태에 widgetId가 추가됩니다.

문서

• 서버에서 위젯 결과 가져오기: 상태, 폴링, webhook.
• Challenge.StateChange 이벤트 참조