Tasemlit n API

    Skekkel asenkez d uɣleb n EV n ABRP deg uselkim-nnek. Tarrayt n API-nneɣ tettwakken asenkez i yemṣad d usnas, telemetrie d deep linking.

    API d usekcem

    Kcem ɣer tarbaεt n API-nneɣ akken ad tsekceḍ asenkez n EV, telemetrie d yiseɣwan iɣezfanen deg unagraw-inek.

    Planning API

    v2 - Yettwawṣa
    v1 - Aqdim

    Asenkez yemṣadan d tkerrust s wallal n uɣleb n EV ummid

    API n uɣleb-nneɣ yettaken aɣleb n ubrid uẓlay i yettwajemmaεen d ABRP. Imudimen n usqedec n tezmert, asefti n uččiṛ, asekcem n ucegḥem s wakud ilaqen, d uɣleb i yettḥasaben tagnawt.

    API yesseqdac taɣessa REST s tuffɣa JSON, yessefraw endpoints v1 (aqdim) d v2. Izwilen n usbeddi d ssuma n yal aɣawas ttemyaraǧan ɣef wayen i teḥwaǧeḍ d wadeg n usqedec.

    Telemetry API

    Isefka n tkerrust s wakud ilaqen i uḍfar d umudim

    API Telemetry yeǧǧa azuzzer n yisefka n tkerrust s wakud ilaqen i uḍfar n yibriden, asleḍ n usqedec, d usnerni n yimudimen-nneɣ. Aya yessazlay tismeɣwerin n tezmert d teseddi n usenkez.

    Tisura n API d baṭel llant. Iṭiqan n umseqdac heḍrurɣen i wuzuzer n yisefka, tzemreḍ ad ten-tawiḍ s OAuth2 (yettwawṣa) neɣ s ufus i ireyyiyen.

    OAuth2 API

    Asesteb d usireg n yimseqdacen iɣelsen

    OAuth2 yettak abrid iɣelsen yerna ishel i usesteb n yimseqdacen ɣer Iternio. Akken ad t-tsbeddeḍ, teḥwaǧeḍ tasarut n API d URL n usuɣal d yisem n usnas.

    Adfay n usireg

    Asiwel amezwaru yettarra-d asebter HTML anda umseqdac ad yeqqen u ad yeqbel asnas-inek. Ma yeldi-t deg yiminig-is amezwer, aqqan-is yezmer ad yettwasekles.

    https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>
    Imḍanen yettwasirgen:
    • get_telemetry: Awi telemetrie taneggarut n umseqdac
    • set_telemetry: Azen telemetrie tamaynut ɣer tkerrust
    • get_plan: Awi aɣawas aneggaru s talɣa tuzzigt (nermes-aɣ i telqayin)
    • vehicle_history: Awi amazray n yibriden d tɣimiyin n uččiṛ (nermes-aɣ i telqayin)
    Tiririt deg URI-inek n usuɣal:
    https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>
    Tukksa n uṭiqan

    Mi tewwiḍ tangalt n usireg, awi aṭiqan i tzemreḍ ad t-tskelseḍ u ad t-tsqedceḍ tikkelt nniḍen.

    https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>
    Amasal n tririt:
    {
      "access_token": "<the created token>",
      "token_type": "bearer",
      "state": "<your supplied state>"
    }
    Isallen n umseqdac

    Mi tesεiḍ aṭiqan, sqedec endpoint "me" akken ad tawiḍ isallen n umseqdac:

    https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>
    Amasal n tririt:
    {
      "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>"
    }

    Iseɣwan iɣezfanen

    Asekcem s URL i uɣleb n ubrid yettwaheyyan uqbel

    Snulfu-d URL tuẓlayin i d-yessekkaren ABRP s yibriden, tikerrusin d yiɣewwaṛen yettwaheyyan uqbel. Igerrez i usekcem deg yisnasen, ismal neɣ inagrawen n unavigasyon war asekcem n API.

    Iseɣwan iɣezfanen ssefrawen aṭas n yiɣewwaṛen n URL: tisismal n uɣalu/uniraf, iḥebsen, imudimen, addad n uččiṛ, d ismenyifen. URL n llsas: https://abetterrouteplanner.com