Τεκμηρίωση API

Ενσωμάτωσε τις ισχυρές δυνατότητες διαδρομολόγησης και προγραμματισμού EV του ABRP στην πλατφόρμα σου. Η λύση μας σε API επιτρέπει ομαλή ενσωμάτωση διαδρομών ευαίσθητων στο όχημα, τηλεμετρία και deep links.

API & ενσωμάτωση

Πρόσβαση στη σουίτα API για να ενσωματώσεις διαδρομολόγηση EV, τηλεμετρία και deep links στην πλατφόρμα σου.

Planning API

v2 - Προτεινόμενο

v1 - Legacy

Διαδρομολόγηση ευαίσθητη στο όχημα με ολοκληρωμένο σχεδιασμό EV

Το Planning API προσφέρει προηγμένο σχεδιασμό που εξελίσσεται μαζί με τις βελτιώσεις του ABRP. Περιλαμβάνει μοντελοποίηση κατανάλωσης, βελτιστοποίηση φόρτισης, ενσωμάτωση κίνησης σε πραγματικό χρόνο και σχεδιασμό με επίγνωση καιρού.

Το API χρησιμοποιεί αρχιτεχνική REST με έξοδο JSON και υποστηρίζει και legacy (v1) και νεότερα (v2) endpoints. Τα έξοδα εγκατάστασης και η τιμολόγηση εξαρτώνται από τις ανάγκες ενσωμάτωσης και τον όγκο χρήσης.

Τεκμηρίωση Planning API v2 Τεκμηρίωση Planning API v1 (Legacy)

Telemetry API

Δεδομένα οχήματος σε πραγματικό χρόνο για παρακολούθηση και μοντελοποίηση

Το Telemetry API μεταφέρει σε πραγματικό χρόνο δεδομένα οχήματος για ζωντανή παρακολούθηση ταξιδιών, ανάλυση κατανάλωσης και συνεχή βελτίωση των μοντέλων μας, ώστε να ακριβολογούμε περισσότερο στην ενέργεια και τις διαδρομές.

Διατίθενται δωρεάν κλειδιά API. Για υποβολή δεδομένων απαιτούνται tokens χρήστη, μέσω OAuth2 (συνιστάται) ή χειροκίνητα για δοκιμές.

Τεκμηρίωση Telemetry Διαχείριση κλειδιών Telemetry API

OAuth2 API

Ασφαλής ταυτοποίηση και εξουσιοδότηση χρηστών

Το OAuth2 προσφέρει ασφαλή και εύχρηστο τρόπο ταυτοποίησης με την Iternio. Θα χρειαστείς API key και URL ανακατεύθυνσης μαζί με το όνομα εφαρμογής.

Ροή εξουσιοδότησης

Το πρώτο αίτημα επιστρέφει HTML όπου ο χρήστης συνδέεται και εγκρίνει την εφαρμογή. Ανοίγοντας τον προεπιλεγμένο browser, η σύνδεση μπορεί να αποθηκευτεί για ταχύτερη διαδικασία.

https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>

Επιτρεπόμενα scopes:

get_telemetry: Ανάκτηση της πιο πρόσφατης τηλεμετρίας χρήστη
set_telemetry: Αποστολή νέων ενημερώσεων τηλεμετρίας στο όχημα
get_plan: Λήψη του πιο πρόσφατου πλάνου σε συμπυκνωμένη μορφή (επικοινώνησε μαζί μας για λεπτομέρειες)
vehicle_history: Ιστορικά ταξίδια και συνδέσεις φόρτισης (επικοινώνησε μαζί μας για λεπτομέρειες)

Απάντηση στο redirect URI σου:

https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>

Ανάκτηση token

Μετά τον κωδικό εξουσιοδότησης, πάρε το token για αποθήκευση και επαναχρησιμοποίηση.

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>"
}

Στοιχεία χρήστη

Με το token, χρησιμοποίησε το endpoint «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>"
}

Deep Links

Ενσωμάτωση μέσω URL για προκαθορισμένο προγραμματισμό

Φτιάξε URL που ανοίγουν το ABRP με ήδη ρυθμισμένες διαδρομές, όχημα και παραμέτρους. Ιδανικό για ενσωμάτωση σε εφαρμογές ή sites χωρίς πλήρες API.

Τα deep links υποστηρίζουν πληθώρα παραμέτρων: συντεταγμένες, σημεία, μοντέλα, SoC και προτιμήσεις. Βασικό URL: https://abetterrouteplanner.com

Τεκμηρίωση Deep Links