Create Access Token

Description

Client ID/Secret으로 access token을 발급합니다. 발급된 access token으로 Vehicle Data API를 호출할 수 있습니다. Access token이 만료되면 이 문서를 참고하여 access token을 새로 발급받으세요.

주의

• 내 차량 API 키를 재발급한 경우, 기존 Key로 발급받은 access token은 무효화됩니다.
• 내 차량 API 키를 폐기한 경우, 모든 토큰이 무효화되며 재발급할 수 없습니다.

Endpoint

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

Request

curl

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

Header

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

Body Parameters

파라미터	타입	설명	필수 여부
clientId	string	Pleos에서 발급된 clientId	Required
clientSecret	string	Pleos에서 발급된 clientSecret	Required

Response

성공

200

{
  "data": {
    "accessToken": "<ACCESS_TOKEN>"
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2026-07-03T10:00:00+09:00",
    "requestId": "835bdbd4-1105-4a8c-b438-fa0873d1b246"
  }
}

필드	타입	설명
data.accessToken	string	Vehicle Data API 호출용 토큰

실패

40001

{
  "error": {
    "code": "40001",
    "message": "Invalid Parameters",
    "requestId": "835bdbd4-1105-4a8c-b438-fa0873d1b246",
    "details": [
      {
        "field": "identifier",
        "issue": "공백일 수 없습니다."
      }
    ],
    "timestamp": "2026-07-03T10:00:00+09:00"
  }
}

[에러 코드]

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