ABRP LogoABRP
    ABRP 열기

    API 문서

    ABRP의 강력한 EV 라우팅과 경로 계획 기능을 여러분의 플랫폼에 통합하세요. 차량 맞춤형 라우팅, 텔레메트리, 딥 링크까지 포괄적인 API로 매끄럽게 연동할 수 있어요.

    API 및 통합

    EV 라우팅, 텔레메트리, 딥 링크를 플랫폼에 통합할 수 있는 다양한 API를 사용해 보세요.

    Planning API

    v2(권장)
    v1(레거시)

    차량 맞춤형 라우팅과 종합적인 EV 경로 계획 기능

    Planning API는 ABRP의 지속적인 개선과 함께 발전하는 정교한 경로 계획 기능을 제공해요. 에너지 소비 모델, 충전 최적화, 실시간 교통 연동, 날씨 기반 계획 등을 지원해요.

    API는 REST 아키텍처와 JSON 출력을 사용하며 레거시(v1)와 최신(v2) 엔드포인트를 모두 지원해요. 초기 설정 비용과 계획당 요금은 통합 요구 사항과 사용량에 따라 달라져요.

    v2 Planning 문서 v1 Planning 문서 (레거시)

    Telemetry API

    실시간 추적과 차량 모델링을 위한 실시간 차량 데이터

    Telemetry API로 차량 데이터를 실시간 전송해 주행 추적, 소비 분석, 차량 모델의 지속적인 개선이 가능해요. 에너지 예측과 라우팅 정확도를 높이는 데 도움이 돼요.

    통합용 무료 API 키를 제공해요. 데이터 전송에는 사용자 토큰이 필요하며, OAuth2 흐름(권장)이나 테스트·개발용 수동 토큰 발급으로 받을 수 있어요.

    Telemetry 문서 텔레메트리 API 키 관리

    OAuth2 API

    안전한 사용자 인증 및 권한 부여

    OAuth2는 Iternio 사용자를 식별하고 인증하는 안전하고 편리한 방법이에요. 설정하려면 API 키와 함께 리디렉션 URL, 애플리케이션 이름이 필요해요.

    인증 흐름

    첫 번째 호출은 사용자가 로그인하고 앱을 승인하는 HTML 페이지를 반환해요. 사용자의 기본 브라우저에서 열면 로그인 상태가 캐시되어 절차가 간단해질 수 있어요.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    허용되는 범위:
    • get_telemetry: 사용자의 최신 텔레메트리 가져오기
    • set_telemetry: 차량에 새 텔레메트리 업데이트 전송하기
    • get_plan: 최신 플랜을 압축된 형식으로 가져오기 (자세한 내용은 문의해 주세요)
    • vehicle_history: 과거 주행 및 충전 세션 가져오기 (자세한 내용은 문의해 주세요)
    리디렉션 URI에서의 응답:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    토큰 가져오기

    인증 코드를 받으면 토큰을 가져오고, 필요에 따라 저장해 다시 사용할 수 있어요.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    응답 형식:
    {
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}
    사용자 정보

    토큰을 받은 후에는 "me" 엔드포인트로 사용자 정보를 가져올 수 있어요.

    https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>
    응답 형식:
    {
  "user_id": <the numeric ID of the user>,
  "full_name": "<Full name of the user>",
  "email": "<Email of user>",
  "vehicle_id": <The numeric ID of the vehicle, if part of the scope>,
  "vehicle_name": "<The vehicle name>",
  "vehicle_typecode": "<The vehicle typecode>"
}

    딥 링크

    사전 구성된 경로 계획을 위한 URL 기반 통합

    출발지, 목적지, 차량 선택, 계획 매개변수가 미리 설정된 맞춤 URL로 ABRP를 실행할 수 있어요. API 통합 없이 앱, 웹사이트, 내비게이션에 넣기에 좋아요.

    딥 링크는 출발지·목적지 좌표, 경유지, 차종, 충전 상태, 사용자 설정 등 다양한 URL 매개변수를 지원해요. 기본 URL: https://abetterrouteplanner.com

    딥 링크 문서