본문으로 건너뛰기

6개의 게시물개의 게시물이 "api" 태그를 포함

모든 태그 보기

연령 확인 API 응답의 짧은 URL 필드

연령 확인 생성 응답(POST /age-verification/perform-access-age-verification 및 기타 perform-* 연령 확인 엔드포인트)에 이제 id, **url**과 함께 **shortUrl**이 포함됩니다.

새로운 기능

  • 짧은 링크: shortUrl은 전체 url과 동일한 확인 경험으로 리다이렉트하는 더 짧은 링크입니다. 쿼리 문자열이 길어 부적합할 때(예: QR 코드, 사용자가 다른 기기에서 확인을 마치는 경우) 사용하세요.
  • 전체 URL은 그대로: 세션 JWT는 여전히 전체 urltoken 쿼리 매개변수에 있습니다. 해당 URL을 임의로 짧게 만들거나 다시 만들지 마세요.
  • 불투명한 값: shortUrl은 불투명한 문자열로 취급하고, 반환된 그대로 표시·인코딩하세요. 경로나 쿼리 레이아웃은 나중에 바뀔 수 있으므로 고정 형식에 의존하지 마세요.

더 알아보기

플랫폼 연령 시그널 문서

Apple iOS, Google Play, Xbox, Meta Horizon 및 k-ID의 연령 데이터가 k-ID에 어떻게 전달되는지, 연령 게이트를 건너뛸 수 있는 경우, 그리고 검증된 시그널과 검증되지 않은 시그널이 고위험 권한 및 연령 보증과 어떻게 연관되는지 설명하는 플랫폼 연령 시그널에 대한 종단간 문서를 게시했습니다.

새로운 기능

CDK — 플랫폼 연령 시그널

  • 플랫폼 연령 시그널 — 빠른 통합 경로, API 맵, 권장 요청 순서, POST /age-gate/check에서 플랫폼 시그널 처리 방식, 지원 플랫폼 및 검증된 선언 유형, 검증됨/검증되지 않음 시그널 동작.
  • 플랫폼 시그널 세부 정보 — 플랫폼별 필드 형태, 각 네이티브 시그널 획득 방법, 엔드포인트별 안내(get-requirements, check, get-default-permissions, session/get, get-platform-age-range, session/upgrade), 유효성 검사, 연령 충돌 및 k-id 시그널 규칙.

개념 및 관련 문서

  • 연령 시그널 — 플랫폼 연령 시그널이 다른 시그널 유형과 어떻게 맞물리는지, PlatformAgeSignal 통합 세부 정보를 찾을 위치.
  • 고위험 기능을 위한 연령 보증권한verifiedAgeThreshold와 연령 게이트에서 검증된 플랫폼 시그널에 대한 상호 연결된 동작.

API 참조(OpenAPI)

세션 업그레이드, AgeVerification, platformAgeSignal 설명을 위 문서와 일치하도록 검증된 플랫폼 시그널 표현으로 맞추었습니다.

문서

Account System Product

Account System Product를 출시했습니다. 조직의 중앙 계정 또는 플랫폼 프로덕트가 단일 API 키와 선택적 헤더를 사용하여 조직 내 다른 프로덕트를 대신해 인증 챌린지 및 세션을 생성할 수 있는 기능입니다.

새로운 기능

Account System Product

Compliance Studio에서 프로덕트를 Account System Product로 활성화하면, Kid-Target-Product-Id 헤더에 대상 프로덕트 ID를 넣어 같은 조직의 다른(비 계정 시스템) 프로덕트를 대신해 특정 k-ID API를 호출할 수 있습니다. Account System Product의 API 키를 사용하므로 대상별 키 관리나 로테이션이 필요 없습니다.

지원 엔드포인트:

보호자는 대상 프로덕트의 설정(고지, 권한, 브랜딩)만 보게 됩니다. Account System Product와 대상 프로덕트 모두 각 이벤트에 대한 웹훅을 받으며, onBehalfOfProductIdinitiatedByProductId로 크로스 프로덕트 플로우를 구분할 수 있습니다.

Account System Product는 다중 프로덕트 승인과 함께 사용할 수 있습니다. Account System Product를 대상의 필수 프로덕트로 설정하면 보호자가 한 번의 플로우에서 둘 다 승인할 수 있습니다.

문서

추가 법적 링크 및 Check age gate options

추가 법적 링크(Developer Details)와 Check age gate API의 options 매개변수에 대한 문서를 추가했습니다. 동의 플로우에서 플랫폼별 법적 문서(예: Xbox, PlayStation, Steam)를 표시할 수 있습니다.

새로운 기능

추가 법적 링크 (Developer Details)

Compliance Studio의 프로덕트 Developer Details 탭에서 동의 플로우에 표시되는 선택적 추가 법적 링크를 추가할 수 있습니다.

  • 제목링크: 현지화된 표시 제목과 URL(메인 법적 문서와 동일한 언어 옵션).
  • 변형 ID: Check age gate API 호출 시 사용하는 식별자(예: xbox-tos, playstation-privacy-policy). 항상 표시가 꺼져 있으면 필수입니다.
  • 항상 표시: 켜짐(기본값)이면 동의 플로우에서 링크가 항상 표시됩니다. 꺼짐이면 게임이 options에서 해당 변형 ID로 연령 게이트 API를 호출할 때만 표시됩니다.

게임이 여러 플랫폼에서 배포되고 플랫폼마다 다른 법적 문서 URL이 필요한 경우 사용하세요.

Check age gate API — options 매개변수

POST /api/v1/age-gate/check 요청 본문에서 선택적 options 개체를 지원합니다.

  • termsOfServiceDocument: 이용약관 변형 ID(구성된 추가 법적 링크와 일치해야 함).
  • privacyPolicyDocument: 개인정보 처리방침 변형 ID(구성된 추가 법적 링크와 일치해야 함).
  • additionalLegalLinks: 이용약관 및 개인정보 처리방침과 함께 표시할 추가 법적 문서의 변형 ID 배열(각 ID는 구성된 추가 법적 링크와 일치해야 함).

챌린지가 생성되면 동의 화면에 프로덕트 기본 Privacy Policy 및 Terms of Service 대신 요청된 법적 링크가 표시됩니다.

문서

Age Gate Widget 리디렉션 URL 지원

Age Gate Widget 엔드포인트에 redirectUrl을 선택적 매개변수로 추가했습니다.

새로운 기능

Age Gate Widget API 업데이트

/widget/generate-age-gate-url 엔드포인트는 이제 options 객체 내에서 선택적 redirectUrl 매개변수를 지원합니다. 이를 통해 Age Gate Widget이 완료된 후 리디렉션할 URL을 지정할 수 있으며, 이는 엔드투엔드 위젯 엔드포인트와 유사합니다.

redirectUrl 매개변수는 HTTP/HTTPS URL 또는 사용자 정의 프로토콜 스키마를 사용하는 모바일 딥링크를 지원합니다.

업데이트된 API

Widget.ExitReview 명확화 및 API 업데이트

연령 확인 및 VPC 흐름에 대한 위젯 UI를 언제 닫을지 명확히 하고 MegaWidgetOptions 스키마에 redirectUrl 지원을 추가했습니다.

새로운 기능

Widget.ExitReview 명확화

연령 확인 및 VPC 흐름에 대한 UI를 언제 닫을지 결정하는 신호로 Widget.ExitReview를 사용해야 함을 명확히 하기 위해 문서를 업데이트했습니다.

업데이트된 문서:

  • 연령 확인 가이드 - 확인 UI를 닫기 위해 Widget.ExitReview를 수신하는 방법에 대한 지침 추가
  • VPC 가이드 - VPC 위젯 UI를 닫기 위해 Widget.ExitReview를 수신하는 방법에 대한 지침 추가
  • CDK 임베디드 흐름 - 위젯 UI를 닫기 위해 Widget.ExitReview를 수신하는 방법에 대한 지침 추가

모든 언어 버전(영어, 일본어, 간체 중국어, 한국어)이 이 명확화로 업데이트되었습니다.

API 업데이트

MegaWidgetOptions의 redirectUrl

MegaWidgetOptions 스키마에 연령 확인 요청 스키마와 일관된 redirectUrl 지원이 포함되었습니다. 이를 통해 엔드투엔드 위젯을 사용할 때 리디렉션 URL을 지정할 수 있습니다.

업데이트된 스키마:

  • MegaWidgetOptions#/components/schemas/RedirectUrl에 대한 참조가 있는 redirectUrl 필드가 포함되었습니다

이 변경 사항은 모든 OpenAPI 사양 파일(영어, 일본어, 간체 중국어, 한국어)에서 사용할 수 있습니다.

문서 개선

프로덕트 이미지 사양

Compliance Studio의 프로덕트 이미지에 대한 권장 종횡비 및 해상도를 추가했습니다:

  • 로고: 1:1 (정사각형), 512×512px
  • 배너: 3:1 (가로), 2430×810px