Login

Description

차량 소유자에게 로그인 창을 출력합니다.

Endpoint

GET https://security-api.pleos.ai/v1/auth/login

Request

curl

curl -X GET "https://security-api.pleos.ai/v1/auth/login?clientId={client_id}&brand={brand}&redirectUrl={redirect_url}&state={state}"

Query Params

파라미터	타입	설명	필수 여부
clientId	string	Pleos Playground > My Project에서 확인한 클라이언트 ID를 입력합니다.	Required
brand	string	차량 브랜드(hyundai/kia/genesis)	Required
redirectUrl	string	Pleos Playground > My Project에서 Vehicle Data API 사용 신청 시 입력한 OAuth 로그인 > 로그인 리다이렉트 URL을 입력합니다.	Required
state	string	애플리케이션에서 생성한 상태 값 사이트 간 요청 위조(cross-site request forgery) 공격을 방지하기 위해 사용하는 값 특수문자 사용 시, Base64 혹은 URL Encoding 필수	Required

정보

redirectUrl은 Vehicle Data API 사용 신청 시 입력한 로그인 리다이렉트 URL과 동일한 값을 사용해야 합니다.
API > API 신청 내역 화면에서 리다이렉트 URL을 확인할 수 있습니다.

Responses

성공

200

{
  HTTP/1.1 302 Found
  Content-Length: 0
  Location: https://www.example.com/auth/hyundai?code=a1a2a3a4-1010-2020-xyz1-2166063cb6af.2222b4b4-adde-4c73-8dc3-bc95ebc3935a&state=app_login
}

필드	타입	설명
code	string	로그인 인증 성공 시 발급된 인증 코드. 사용자 토큰 발급에 사용
state	string	애플리케이션에서 요청한 상태 토큰 값. 쿼리 파라미터로 입력한 state 값과 같은 값입니다.

실패

N/A