API డాక్యుమెంటేషన్

    నీ ప్లాట్‌ఫారమ్‌లో ABRP శక్తివంతమైన EV రూటింగ్ మరియు ప్లానింగ్ సామర్థ్యాలను అమలు చేయి. మా సమగ్ర API సూట్ వాహన-అవగాహన రూటింగ్, టెలిమెట్రీ మరియు డీప్ లింకింగ్ ఫీచర్ల అప్రయత్న అమలును అనుమతిస్తుంది.

    APIలు మరియు అమలు

    నీ ప్లాట్‌ఫారమ్‌లో EV రూటింగ్, టెలిమెట్రీ మరియు డీప్ లింకింగ్ అమలు చేయడానికి మా API సూట్‌కు ప్రవేశించు.

    ప్లానింగ్ API

    v2 - సిఫారసు చేయబడింది
    v1 - లెగసీ

    సమగ్ర EV ప్లానింగ్ సామర్థ్యాలతో వాహన-అవగాహన రూటింగ్

    మా ప్లానింగ్ API సొగసైన రూట్ ప్లానింగ్‌ను అందిస్తుంది, అది ABRP నిరంతర మెరుగుదలలతో అభివృద్ధి చెందుతుంది. ఇందులో ఇంధన వినియోగ మోడలింగ్, ఛార్జింగ్ ఆప్టిమైజేషన్, రియల్-టైమ్ ట్రాఫిక్ అమలు మరియు వాతావరణ-అవగాహన ప్లానింగ్ ఉంటాయి.

    API REST ఆర్కిటెక్చర్‌ను ఉపయోగిస్తుంది, JSON అవుట్‌పుట్‌తో మరియు లెగసీ (v1) మరియు ఆధునిక (v2) ఎండ్‌పాయింట్లకు మద్దతు ఇస్తుంది. అమలు ప్లానింగ్ మరియు వినియోగ వాల్యూమ్ ఆధారంగా సెటప్ ఖర్చులు మరియు ప్రతి ప్లాన్ ధర మారవచ్చు.

    టెలిమెట్రీ API

    లైవ్ ట్రాకింగ్ మరియు కార్ మోడలింగ్ కోసం రియల్-టైమ్ వాహన డేటా

    టెలిమెట్రీ 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>"
    }
    యూజర్ సమాచారం

    టోకెన్ వచ్చాక యూజర్ సమాచారం తెలుసుకోవడానికి "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 ఆధారిత అమలు

    ముందే కాన్ఫిగర్ చేసిన రూట్లు, వాహన ఎంపికలు మరియు ప్లానింగ్ పారామీటర్లతో ABRP ప్రారంభించే కస్టమ్ URLలను సృష్టించు. API అమలు లేకుండా యాప్‌లు, వెబ్‌సైట్లు లేదా నావిగేషన్ సిస్టమ్‌లలో ఎంబెడ్ చేయడానికి అద్భుతం.

    డీప్ లింక్స్ మూలం/గమ్యం నిరూపకాలు, వేపాయింట్లు, కార్ మోడల్స్, స్టేట్ ఆఫ్ ఛార్జ్ మరియు యూజర్ ప్రాధాన్యతలతో సహా విస్తృత URL పారామీటర్లకు మద్దతు ఇస్తాయి. బేస్ URL: https://abetterrouteplanner.com