본문으로 건너뛰기

인증

Vehicle Data API는 OAuth 2.0 기반의 토큰 인증 방식을 사용합니다. 내 차량 조회를 위한 API를 사용하려면 내 차량 API 키의 인증 정보를 기반으로 액세스 토큰(access token)을 발급받아야 하며, 이 토큰을 이후 모든 요청의 Authorization 헤더에 포함해야 합니다.

Authorization: Bearer <access_token>

STEP 1. 내 차량 API 키 확인​

개인 사용자(Private Users)는 사업자 사용자(Business Users)와 API 키를 확인하는 메뉴가 다릅니다. Pleos Playground의 내 차량 데이터 API 화면에서 클라이언트 ID와 클라이언트 시크릿을 확인합니다.

내 차량 API 키의 발급·재발급·폐기 방법은 내 차량 API 키 발급과 내 차량 API 키 관리를 참조합니다.

위험

클라이언트 ID와 클라이언트 시크릿은 액세스 토큰 발급에 필요한 인증 정보입니다. 외부에 노출되지 않도록 주의해야 합니다.

STEP 2. 액세스 토큰 요청​

Create Access Token을 호출하여 액세스 토큰을 발급받습니다.

curl
curl -X POST "https://api.pleos.ai/v1/auth/personal-token" \
  -H "Content-Type: application/json" \
  -H "Brand: hyundai" \
  -d '{
    "clientId": "<YOUR_CLIENT_ID>",
    "clientSecret": "<YOUR_CLIENT_SECRET>"
  }'
  • clientId: Pleos에서 발급받은 내 차량 API 키의 클라이언트 ID
  • clientSecret: Pleos에서 발급받은 내 차량 API 키의 클라이언트 시크릿
주의

액세스 토큰의 유효 기간이 만료되면 Create Access Token을 다시 호출하여 새로 발급받습니다.