API Փաստաթղթեր

    Ինտեգրեք ABRP-ի հզոր EV երթուղղման և պլանավորման հնարավորությունները ձեր հարթակում: Մեր համապարփակ API փաթեթը հնարավորություն է տալիս անխափան ինտեգրվել տրանսպորտային միջոցների մասին տեղեկացված երթուղային, հեռաչափության և խորը կապող գործառույթների:

    API-ներ և ինտեգրում

    Մուտք գործեք մեր API-ների փաթեթը՝ ձեր հարթակում ինտեգրելու EV երթուղին, հեռաչափությունը և խորը կապը:

    Պլանավորման API

    v2 - Առաջարկվում է
    v1 - ժառանգություն

    Տրանսպորտային միջոցների մասին տեղեկացված երթուղիներ՝ EV պլանավորման համապարփակ հնարավորություններով

    Մեր Պլանավորման API-ն ապահովում է երթուղու բարդ պլանավորում, որը զարգանում է ABRP-ի շարունակական բարելավումներով: Առանձնահատկությունները ներառում են էներգիայի սպառման մոդելավորում, լիցքավորման օպտիմիզացում, իրական ժամանակում երթևեկության ինտեգրում և եղանակին տեղեկացված պլանավորում:

    API-ն օգտագործում է REST ճարտարապետություն JSON ելքով և աջակցում է և՛ ժառանգական (v1) և՛ ժամանակակից (v2) վերջնական կետերին: Կարգավորման ծախսերը և մեկ պլանի գները տարբերվում են՝ կախված ձեր ինտեգրման կարիքներից և օգտագործման ծավալից:

    Telemetry API

    Իրական ժամանակում տրանսպորտային միջոցների տվյալներ ուղիղ հետևելու և ավտոմեքենայի մոդելավորման համար

    Telemetry API-ն հնարավորություն է տալիս իրական ժամանակում տրանսպորտային միջոցների տվյալների փոխանցումը ուղիղ ճանապարհորդության հետևելու, սպառման վերլուծության և մեր մեքենաների մոդելների շարունակական բարելավման համար: Սա օգնում է մեզ կատարելագործել էներգիայի կանխատեսումները և երթուղիների ճշգրտությունը:

    Անվճար API ստեղներ հասանելի են ինտեգրման համար: Օգտատիրոջ նշանները պահանջվում են տվյալների ներկայացման համար և կարելի է ձեռք բերել կամ մեր OAuth2 հոսքի միջոցով (խորհուրդ է տրվում) կամ ձեռքով նշանների որոնման միջոցով՝ փորձարկման և մշակման համար:

    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-ի վրա հիմնված ինտեգրում նախապես կազմաձևված երթուղու պլանավորման համար

    Ստեղծեք հատուկ URL-ներ, որոնք գործարկում են ABRP՝ նախապես կազմաձևված երթուղիներով, տրանսպորտային միջոցների ընտրությամբ և պլանավորման պարամետրերով: Կատարյալ է հավելվածներում, վեբկայքերում կամ նավիգացիոն համակարգերում առանց API-ի ինտեգրման ներդրման համար:

    Խորը հղումներն աջակցում են URL-ի պարամետրերի լայն շրջանակ, ներառյալ սկզբնաղբյուր/նպատակակետի կոորդինատները, ճանապարհային կետերը, մեքենաների մոդելները, լիցքավորման վիճակը և օգտագործողի նախասիրությունները: Հիմնական URL: https://abetterrouteplanner.com