전화 번호로 인증 시작

post/oauth2/login/phone/request

사용자 전화 번호로 인증을 시작하고 전화 번호로 확인 코드를 보냅니다. 코드는 3분 동안만 사용할 수 있습니다.

이 호출은 전화 번호로 인증 완료 호출에만 사용합니다.

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

애플리케이션에서 사용자가 전화 번호를 입력할 수 있도록 인증 양식을 엽니다.
사용자가 전화 번호를 입력합니다.
애플리케이션이 이 요청을 엑솔라 로그인 서버로 전송합니다. a. send_link 매개변수가 true인 경우 이 요청 후에 확인 코드 가져오기 요청을 전송하여 SMS에 확인 코드와 링크가 포함되도록 해야 합니다. b. send_link 매개변수가 false이거나 전달되지 않으면 SMS에 확인 코드만 포함됩니다.
엑솔라 로그인 서버가 SMS를 전송하고 확인 코드의 ID를 반환합니다.
사용자가 확인 코드를 입력할 수 있도록 애플리케이션이 필드를 표시합니다.
사용자가 받은 확인 코드를 입력하거나 링크를 따라 이동합니다.
애플리케이션이 전화 번호로 인증 완료 요청을 엑솔라 로그인 서버로 전송합니다.
사용자가 인증된 것으로 간주됩니다.

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

phone_number required	string^\+(\d){5,25}$ 전화번호.
link_url	string <uri> 사용자를 상태 인증 페이지로 리디렉션하는 URL입니다.매개변수 `send_link`가 `true`인 경우 필수입니다.
send_link	boolean SMS에서 확인 코드와 함께 링크를 전송했는지 여부를 표시합니다. 로그인에 확인 코드 대신 링크를 사용할 수 있습니다. 매개변수에 `true` 값이 있으면 SMS로 링크가 전송됩니다.

Responses

200

확인

400

잘못된 요청

404

찾을 수 없음

422

처리할 수 없는 엔터티

429

요청이 너무 많음

Request samples

application/json

{"link_url": "http://example.com",
"phone_number": "string",
"send_link": true
}

Response samples

application/json

{"operation_id": "string"
}