Xsolla-logo
  • 문서화
  • 계정 생성

이메일로 인증 시작

post/oauth2/login/email/request

사용자 이메일 주소로 인증을 시작하고 이메일 주소로 확인 코드를 보냅니다. 코드는 3분 동안만 사용할 수 있습니다.

이 호출은 이메일로 인증 완료 호출에만 사용합니다.

이 호출을 사용하는 워크플로:

  1. 애플리케이션에서 사용자가 이메일 주소를 입력할 수 있도록 인증 양식을 엽니다.
  2. 사용자가 이메일 주소를 입력합니다.
  3. 애플리케이션이 이 요청을 엑솔라 로그인 서버로 전송합니다. a. send_link 매개변수가 true인 경우 이 요청 후에 확인 코드 가져오기 요청을 전송하여 이메일에 확인 코드와 링크가 포함되도록 해야 합니다. b. send_link 매개변수가 false이거나 전달되지 않으면 이메일에 확인 코드만 포함됩니다.
  4. 엑솔라 로그인 서버가 이메일을 전송하고 확인 코드의 ID를 반환합니다.
  5. 사용자가 확인 코드를 입력할 수 있도록 애플리케이션이 필드를 표시합니다.
  6. 사용자가 받은 확인 코드를 입력하거나 링크를 따라 이동합니다.
  7. 수신한 ID와 함께 애플리케이션이 이메일로 인증 완료 요청을 엑솔라 로그인 서버로 전송합니다.
  8. 사용자가 인증된 것으로 간주됩니다.
Request
query Parameters
response_type
required
string

OAuth 2.0 프로토콜을 사용하도록 설정한 프로젝트에서 사용하는 권한 부여 유형입니다. 응답으로 사용자 인증 코드를 가져오려면 code여야 합니다. 사용자 인증을 완료하려면 수신한 코드를 JWT 생성하기 호출을 통해 JWT로 교환해야 합니다.

client_id
required
integer

애플리케이션 ID입니다. OAuth 2.0 클라이언트 생성하기를 수행한 후에 가져옵니다.

state
required
string

추가 사용자 확인에 사용되는 값입니다. 종종 CSRF 공격을 완화하는 데 사용됩니다. 이 값은 응답으로 반환됩니다. 8개 기호보다 길어야 합니다.

scope
string

범위는 OAuth 2.0에서 사용자 계정에 대한 애플리케이션의 액세스를 제한하는 메커니즘입니다.

가능한 매개변수:

  • offline. JWT 생성하기 호출에서 refresh_token을 사용하여 JWT가 만료되었을 때 이를 새로고침합니다.
  • playfab. PlayFab에 사용자 데이터를 저장하는 경우 JWT의 session_ticket 클레임에 SessionTicket을 작성합니다.

위에서 언급하지 않은 scope 매개변수의 고유한 값을 처리하는 경우 이 호출을 사용할 때 설정할 수 있습니다. 엑솔라 로그인 서버는 이러한 값을 처리하지 않지만 수신한 JWT에 값을 반환합니다.

redirect_uri
string

계정 확인, 인증 성공 또는 암호 재설정 확인 후 사용자를 리디렉션할 URL입니다. 이 매개 변수를 설정하려면 고객 성공 관리자에게 문의하거나 csm@xsolla.com로 이메일을 보내주십시오.

알림
프로젝트 설정에 리디렉션 URI가 두 개 이상 있는 경우 이 매개 변수가 필요합니다.
Request Body schema: application/json
email
required
string [ 1 .. 255 ] characters

사용자 이메일 주소입니다.

link_url
string <uri>

사용자를 상태 인증 페이지로 리디렉션하는 URL입니다.매개변수 send_linktrue인 경우 필수입니다.

send_link
boolean

이메일에 확인 코드와 함께 링크를 전송했는지 여부를 표시합니다.

로그인에 확인 코드 대신 링크를 사용할 수 있습니다.

매개변수에 true 값이 있으면 이메일로 링크가 전송됩니다.

Responses
200

확인

400

잘못된 요청

404

찾을 수 없음

422

처리할 수 없는 엔터티

429

요청이 너무 많음

Request samples
application/json
{}
Response samples
application/json
{
  • "operation_id": "string"
}