API დოკუმენტაცია
ABRP-ის ძლიერი EV მარშრუტიზაციისა და დაგეგმვის შესაძლებლობების ინტეგრირება შენს პლატფორმაში. ჩვენი ყოვლისმომცველი API კომპლექტი საშუალებას იძლევა უპრობლემოდ ინტეგრირდეს ავტომობილის მცოდნე მარშრუტიზაცია, ტელემეტრია და ღრმა დამაკავშირებელი ფუნქციები.
API და ინტეგრაცია
წვდომა ჩვენს API-ების კომპლექტს, რათა ინტეგრირდეს EV მარშრუტიზაცია, ტელემეტრია და ღრმა კავშირი შენს პლატფორმაში.
დაგეგმვის API
სატრანსპორტო საშუალებების გაცნობიერებული მარშრუტი EV ყოვლისმომცველი დაგეგმვის შესაძლებლობებით
ჩვენი დაგეგმვის API უზრუნველყოფს მარშრუტის დახვეწილ დაგეგმვას, რომელიც ვითარდება ABRP-ის უწყვეტი გაუმჯობესებებით. ფუნქციებში შედის ენერგიის მოხმარების მოდელირება, დატენვის ოპტიმიზაცია, ტრაფიკის რეალურ დროში ინტეგრაცია და ამინდის გათვითცნობიერებული დაგეგმვა.
API იყენებს REST არქიტექტურას JSON გამომავალთან და მხარს უჭერს როგორც მოძველებულ (v1) ასევე თანამედროვე (v2) საბოლოო წერტილებს. დაყენების ხარჯები და თითო გეგმის ფასი განსხვავდება შენი ინტეგრაციის საჭიროებებისა და გამოყენების მოცულობის მიხედვით.
ტელემეტრიის 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: მიიღე ისტორიული დისკები და დატენვის სესიები (დეტალებისთვის დაგვიკავშირდი)
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