ABRP LogoABRP
    ABRP іске қосыңыз

    API құжаттамасы

    ABRP қуатты EV бағдарлау және жоспарлау мүмкіндіктерін платформаңызға біріктіріңіз. Біздің жан-жақты API жинағы көлікке бағдарлауды, телеметрияны және терең байланыстыру мүмкіндіктерін үздіксіз біріктіруге мүмкіндік береді.

    API және интеграция

    EV маршрутизациясын, телеметрияны және платформаңызға терең байланыстыруды біріктіру үшін API жиынтығына қол жеткізіңіз.

    Жоспарлау API

    v2 - Ұсынылады
    v1 - Мұра

    EV жоспарлаудың жан-жақты мүмкіндіктері бар көлікті бағдарлау

    Біздің Жоспарлау API интерфейсі ABRP үздіксіз жақсартуларымен дамитын күрделі маршрутты жоспарлауды қамтамасыз етеді. Мүмкіндіктерге қуат тұтынуды модельдеу, зарядтауды оңтайландыру, нақты уақыттағы трафикті біріктіру және ауа райын болжайтын жоспарлау кіреді.

    API JSON шығысы бар REST архитектурасын пайдаланады және бұрынғы (v1) және заманауи (v2) соңғы нүктелерді қолдайды. Орнату шығындары мен жоспардың бағасы интеграция қажеттіліктері мен пайдалану көлеміне байланысты өзгереді.

    v2 Жоспарлау құжаттамасы v1 Жоспарлау құжаттамасы (бұрынғы)

    Telemetry API

    Тікелей бақылау және автокөлікті модельдеуге арналған нақты уақыттағы көлік деректері

    Telemetry API нақты уақыттағы жолды бақылау, тұтынуды талдау және автомобиль үлгілерін үздіксіз жақсарту үшін көлік деректерін нақты уақытта жіберуге мүмкіндік береді. Бұл энергияны болжауды және маршруттау дәлдігін нақтылауға көмектеседі.

    Тегін API кілттері біріктіру үшін қол жетімді. Пайдаланушы таңбалауыштары деректерді жіберу үшін қажет және біздің OAuth2 ағыны (ұсынылады) арқылы немесе тестілеу және әзірлеу үшін таңбалауышты қолмен іздеу арқылы алуға болады.

    Телеметриялық құжаттама Telemetry API кілттерін басқарыңыз

    OAuth2 API

    Қауіпсіз пайдаланушы аутентификациясы және авторизациясы

    OAuth2 Iternio көмегімен пайдаланушыларды анықтау және аутентификациялаудың қауіпсіз және ыңғайлы әдісін ұсынады. OAuth2 орнату үшін сізге 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>"
}
    Пайдаланушы туралы ақпарат

    Белгішені алғаннан кейін пайдаланушы ақпаратын алу үшін "мен" соңғы нүктесін пайдаланыңыз:

    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 негізіндегі интеграция

    Алдын ала конфигурацияланған маршруттар, көлік таңдаулары және жоспарлау параметрлері бар ABRP іске қосатын реттелетін URL мекенжайларын жасаңыз. API интеграциясынсыз қолданбаларға, веб-сайттарға немесе навигациялық жүйелерге ендіру үшін тамаша.

    Терең сілтемелер URL параметрлерінің кең ауқымын қолдайды, оның ішінде бастапқы/баратын жер координаттары, жол нүктелері, көлік үлгілері, заряд күйі және пайдаланушы қалаулары. Негізгі URL: https://abetterrouteplanner.com

    Deep Links құжаттамасы