테스트

k-ID 통합을 테스트하는 것은 라이브 전에 올바르게 작동하는지 확인하는 데 필수적입니다. 이 가이드는 k-ID 플랫폼에서 사용할 수 있는 테스트 전략 및 도구를 다룹니다.

테스트 모드 및 라이브 모드

k-ID는 테스트 및 프로덕션을 위한 두 가지 환경을 제공합니다:

테스트 모드

테스트 모드 Test Mode 를 사용하면 개발자가 실제 데이터나 프로덕션 시스템에 영향을 주지 않고 통합을 테스트할 수 있습니다. 테스트 모드 API 키를 사용하는 경우 요청이 https://game-api.test.k-id.com의 테스트 환경으로 전송됩니다. 이 환경은 라이브 시스템을 시뮬레이션하도록 설계되었지만 모의 데이터로 작동합니다.

라이브 모드

라이브 모드 Live Mode 는 프로덕션에 사용됩니다. 라이브 모드 API 키를 사용하는 경우 요청이 https://game-api.k-id.com의 프로덕션 환경으로 전송됩니다. 이 환경은 실제 데이터를 처리하고 라이브 시스템과 상호 작용합니다.

참고: 프로덕션 데이터에 의도하지 않은 영향을 피하기 위해 항상 의도한 모드에 대해 올바른 API 키와 엔드포인트를 사용하고 있는지 확인하세요.

대화형 API 참조로 테스트

k-ID API를 호출하는 코드를 작성하기 전에 문서에 내장된 대화형 API 참조를 사용하여 엔드포인트를 직접 테스트할 수 있습니다. 제품의 개발자 설정 페이지로 이동하여 Compliance Studio에서 테스트 API 키를 가져옵니다.

API 테스트 설정

API 참조의 모든 엔드포인트 페이지로 이동합니다(예: /age-gate/check 엔드포인트).
기본 URL 선택: 요청 인터페이스의 기본 URL 필드 위에 마우스를 올려 편집 버튼을 표시합니다. 편집 버튼을 클릭하고 테스트 환경(https://game-api.test.k-id.com/api/v1/)을 선택합니다.
요청 인증: "Bearer Token" 필드에 테스트 API 키를 붙여넣습니다.
요청 본문 구성: 필요에 따라 요청 본문 값을 수정합니다. 테스트의 경우 다음을 사용합니다:
```
{
    "jurisdiction": "US-CA",
    "dateOfBirth": "2005-04-15"
}
```
요청 전송: "Send API Request"를 클릭하여 API 호출을 완료합니다.
응답 보기: 응답이 요청 인터페이스 아래에 표시되어 API의 요청에 대한 응답을 보여줍니다.

이제 k-ID에 대한 성공적인 호출을 완료했습니다! 대화형 참조 사용에 대한 자세한 내용은 대화형 참조 가이드를 참조하세요.

신뢰할 수 있는 성인 동의 테스트

Family Connect에서 부모 경험을 보려면 동의 Challenge를 생성해야 합니다. 이를 위해 대화형 참조를 사용하여 /age-gate/check에 대한 또 다른 호출을 수행하되, 이번에는 미국 관할권에서 디지털 동의 연령 미만의 아동 연령을 사용합니다.

다음을 사용합니다:

{
    "jurisdiction": "US-CA",
    "dateOfBirth": "2015-04-15"
}

이렇게 하면 다음과 같은 응답이 생성됩니다:

{
    "challenge": {
        "challengeId": "<guid>",
        "childLiteAccessEnabled": false,
        "oneTimePassword": "<one time password>",
        "type": "CHALLENGE_PARENTAL_CONSENT",
        "url": "https://family.k-id.com/authorize?otp=<one time password>"
    },
    "status": "CHALLENGE"
}

그런 다음 브라우저에서 url 필드의 URL로 이동할 수 있습니다. 이메일 주소를 요청받은 다음 게임 플레이에 대한 동의를 부여할 수 있는 Family Connect로 연결되는 링크가 포함된 이메일을 받습니다. 브라우저에서 동의 흐름을 완료하면 이전에 제공된 challengeId 필드로 challenge/get-status API를 호출할 수 있습니다. 응답은 다음과 같습니다:

{
    "approverEmail": "email@example.com",
    "sessionId": "<guid>",
    "status": "PASS"
}

이제 k-ID Session을 성공적으로 생성했습니다! /session/get에 sessionId 필드를 매개변수로 제공하여 볼 수 있습니다.

{
    "ageStatus": "DIGITAL_MINOR",
    "dateOfBirth": "2015-04-15",
    "etag": "<guid>",
    "jurisdiction": "US",
    "permissions": [],
    "sessionId": "<guid>",
    "kuid": "<guid>",
    "status": "ACTIVE"
}

테스트 모드 및 라이브 모드​

테스트 모드​

라이브 모드​

대화형 API 참조로 테스트​

API 테스트 설정​

신뢰할 수 있는 성인 동의 테스트​