Refresh Access Token

Description

발급받은 액세스 토큰을 갱신합니다.

Endpoint

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

Request

curl

curl -X POST "https://security-api.pleos.ai/v1/auth/token-refresh" \
  -H "Content-Type: application/json" \
  -H "Brand: hyundai" \
  -d '{
    "clientId": "abc14400-1111-3eac-b364-xxxxxxxxxxxx",
    "clientSecret": "o40srr1jr4vl91c8pjn4j9s8lp4sqxxxxxxxxxxxx",
    "refreshToken": "T9F38OE6PA8CT9V52F30KKKSRA6T5SRDA400"
  }'

Header Params

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

Body Params

파라미터	타입	설명	필수 여부
clientId	string	Pleos Playground > My Project에서 확인한 클라이언트 ID를 입력합니다.	Required
clientSecret	string	Pleos Playground > My Project에서 확인한 클라이언트 시크릿을 입력합니다.	Required
refreshToken	string	Create Access Token 의 응답 값으로 받은 refreshToken 갑을 입력합니다. 이 값은 발급 후 180일간 유효합니다.	Required

Response

성공

200

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

필드	타입	설명
accessToken	string	Vehicle Data API에 액세스할 수 있는 토큰입니다. 액세스 토큰 발급 후 1시간 동안 유효합니다.
refreshToken	string	토큰 갱신에 사용되는 값입니다. refreshToken은 180일 동안 유효합니다.

실패

4002

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

[에러 코드]

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