Create Access Token

Description

Vehicle Data API를 호출하기 위해 필요한 액세스 토큰을 발급받습니다.
액세스 토큰의 유효기간은 1시간입니다.
액세스 토큰이 만료된 이후에는 Refresh Access Token을 호출하여 액세스 토큰을 갱신합니다.

Endpoint

POST https://api.pleos.ai/v1/auth/token

Request

curl

curl -X POST "https://api.pleos.ai/v1/auth/token" \
  -H "Content-Type: application/json" \
  -H "Brand: hyundai" \
  -d '{
    "clientId": "<YOUR_CLIENT_ID>",
    "clientSecret": "<YOUR_CLIENT_SECRET>",
    "code": "<AUTHORIZATION_CODE>",
    "redirectUrl": "https://www.example.com/auth/hyundai"
  }'

Header

파라미터	타입	설명	필수 여부
Content-Type	string	application/json	Optional
Brand	string	차량 브랜드(hyundai/kia/genesis)	Required

Body Parameters

파라미터	타입	설명	필수 여부
clientId	string	Pleos Playground > My Project에서 확인한 클라이언트 ID를 입력합니다.	Required
clientSecret	string	Pleos Playground > My Project에서 확인한 클라이언트 시크릿를 입력합니다.	Required
code	string	로그인 성공 시 리다이렉트 URL(redirectUrl)로 반환된 authorization code(code)를 입력합니다.	Required
redirectUrl	string	Pleos Playground > My Project에서 Vehicle Data API 사용 신청 시 입력한 OAuth 로그인 > 로그인 리다이렉트 URL을 입력합니다.	Required

Response

성공

200

{
  "data": {
    "accessToken": "<ACCESS_TOKEN>",
    "refreshToken": "<REFRESH_TOKEN>"
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

data 필드	타입	설명
accessToken	string	Vehicle Data API에 액세스할 수 있는 토큰입니다. 액세스 토큰 발급 후 1시간 동안 유효합니다.
refreshToken	string	토큰 갱신에 사용되는 값입니다. 리프레시 토큰은 90일 동안 유효하며, 1회만 사용 가능합니다.

실패

4002

{
  "error": {
    "code": "4002",
    "message": "Invalid request parameters",
    "details": [],
    "timestamp": "2025-09-01T12:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

[에러 코드]

실패 시 에러 코드에 대한 상세한 설명은 에러 코드를 참조합니다.