Tài liệu API
Tích hợp khả năng lập kế hoạch và định tuyến EV mạnh mẽ của ABRP vào nền tảng của bạn. Bộ API toàn diện của chúng tôi cho phép tích hợp liền mạch các tính năng định tuyến, telemetry và liên kết sâu nhận biết phương tiện.
API & Tích hợp
Truy cập bộ API của chúng tôi để tích hợp định tuyến EV, telemetry và liên kết sâu vào nền tảng của bạn.
Planning API
Định tuyến nhận biết phương tiện với khả năng lập kế hoạch EV toàn diện
API lập kế hoạch của chúng tôi cung cấp khả năng lập kế hoạch tuyến đường phức tạp phát triển cùng với những cải tiến liên tục của ABRP. Các tính năng bao gồm lập mô hình tiêu thụ năng lượng, tối ưu hóa sạc, tích hợp giao thông theo thời gian thực và lập kế hoạch nhận biết thời tiết.
API sử dụng kiến trúc REST với đầu ra JSON và hỗ trợ cả điểm cuối cũ (v1) và hiện đại (v2). Chi phí thiết lập và giá mỗi gói thay đổi tùy theo nhu cầu tích hợp và khối lượng sử dụng của bạn.
Telemetry API
Dữ liệu xe thời gian thực để theo dõi trực tiếp và lập mô hình xe
Telemetry API cho phép truyền dữ liệu xe theo thời gian thực để theo dõi hành trình trực tiếp, phân tích mức tiêu thụ và cải tiến liên tục các mẫu xe của chúng tôi. Điều này giúp chúng tôi tinh chỉnh các dự đoán năng lượng và độ chính xác định tuyến.
Khóa API miễn phí có sẵn để tích hợp. Cần có mã thông báo người dùng để gửi dữ liệu và có thể nhận được thông qua luồng OAuth2 (được khuyến nghị) của chúng tôi hoặc truy xuất mã thông báo thủ công để thử nghiệm và phát triển.
API OAuth2
Bảo mật xác thực và ủy quyền người dùng
OAuth2 cung cấp một cách an toàn và thuận tiện để xác định và xác thực người dùng bằng Iternio. Để thiết lập OAuth2, bạn cần có khóa API và phải cung cấp URL chuyển hướng cũng như tên ứng dụng.
Luồng ủy quyền
Cuộc gọi đầu tiên trả về một trang HTML nơi người dùng có thể đăng nhập và phê duyệt ứng dụng của bạn. Nếu được mở trong trình duyệt mặc định của người dùng, thông tin đăng nhập của họ có thể được lưu vào bộ đệm để đơn giản hóa quy trình.
https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>get_telemetry: Truy xuất dữ liệu telemetry mới nhất của người dùngset_telemetry: Đẩy các bản cập nhật telemetry mới cho xeget_plan: Nhận gói mới nhất ở dạng cô đọng (liên hệ với chúng tôi để biết chi tiết)vehicle_history: Lấy lịch sử lái xe và phiên sạc (liên hệ để biết chi tiết)
https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>Truy xuất mã thông báo
Khi bạn nhận được mã ủy quyền, hãy truy xuất mã thông báo có thể được lưu trữ và sử dụng lại khi cần.
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>"
}Thông tin người dùng
Sau khi nhận được mã thông báo, hãy sử dụng điểm cuối "me" để lấy thông tin người dùng:
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>"
}Liên kết sâu
Tích hợp dựa trên URL để lập kế hoạch tuyến đường được định cấu hình trước
Tạo các URL tùy chỉnh khởi chạy ABRP với các tuyến đường, lựa chọn phương tiện và thông số lập kế hoạch được định cấu hình sẵn. Hoàn hảo để nhúng vào ứng dụng, trang web hoặc hệ thống điều hướng mà không cần tích hợp API.
Liên kết sâu hỗ trợ nhiều thông số URL bao gồm tọa độ điểm xuất phát/đích, điểm tham chiếu, mẫu ô tô, trạng thái tính phí và tùy chọn của người dùng. URL cơ sở: https://abetterrouteplanner.com