Maʼlumotlarni yuklab olish tartibi
Birlamchi autentifikatsiya
Birlamchi autentifikatsiya Autentifikatsiya kichik boʻlimida tavsiflangan.
Birlamchi autentifikatsiya uchun mavjud foydalanuvchining elektron pochtasi va paroli ishlatiladi. Buning uchun POST soʻrovini yuborish kerak, masalan:
bashcurl -i --header "Content-Type: application/json" \ --request POST \ --data '{"email":"api-user@example.com","password":"Str0ngPas$"}' \ https://api.vadsro.eu/api/v1/auth/sign_inIsteʼmolchilar roʻyxatini yuklab olish
Isteʼmolchilar roʻyxatini yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ --data '{"page":"2"}' \ https://api.vadsro.eu/api/v1/customersMaʼlumotlar sahifama-sahifa yuklab olinadi (
"total_pages": 8— sahifalarning umumiy soni,"current_page": 2— joriy sahifa).Maʼlumotlarni sahifa raqami boʻyicha siklik yuklab olishni tashkil etish kerak:
json{"data":[ { "id":13, "name":"Example National Sports Federation", "subdivision_type_name":"Unit Owner", "inn":"1000000042", "contact_number":"+49-30-5550100" }, ... ], "total_pages":8, "current_page":2, "next_page":3 }Maʼlumotlarni keyingi yuklab olish (qiymatlar arxivlarini yuklab olish) uchun quyidagi parametrlar kerak boʻladi:
"id": 13("customer_id": "13") — tizimdagi isteʼmolchining identifikatori (noyob kaliti).
Hisob tugunlari roʻyxatini yuklab olish
Hisob tugunlari (metering unit) roʻyxatini yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ --data '{"page":"2"}' \ https://api.vadsro.eu/api/v1/stationsMaʼlumotlar sahifama-sahifa yuklab olinadi (
"total_pages": 9— sahifalarning umumiy soni,"current_page": 2— joriy sahifa).Maʼlumotlarni sahifa raqami boʻyicha siklik yuklab olishni tashkil etish kerak.
json{"data":[ { "id":18, "name":"Example Beverages Production GmbH", "equipment_type_id":1, "equipment_brand_name":"BK", "phone":"+49-30-5550101", "equipment_id":61, "customer_id":14 } ... ], "total_pages":9, "current_page":2, "next_page":3 }Maʼlumotlarni keyingi yuklab olish (qiymatlar arxivlarini yuklab olish) uchun quyidagi parametrlar kerak boʻladi:
"equipment_id": 61— hisob asbobining identifikatori.
Maʼlumotlarni moslashtirish (maʼlumotnomalar) uchun:
"customer_id": 14— isteʼmolchi identifikatori;"equipment_type_id": 1— hisob asbobi konfiguratsiyasi turining identifikatori.
Obyekt xususiyatlarini yuklab olish
Hisob tuguni xususiyatlarini yuklab olish uchun yoʻlida tugun identifikatori koʻrsatilgan GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ https://api.vadsro.eu/api/v1/stations/134/characteristicsid— hisob tugunlari roʻyxatini yuklab olishda olingan hisob tuguni identifikatori.Hisob asboblari turlarini yuklab olish
Hisob asboblari turlarini yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ --data '{"page":"1"}' \ https://api.vadsro.eu/api/v1/equipment_typesMaʼlumotlarni quyidagi parametrlar boʻyicha siklik yuklab olishni tashkil etish kerak:
page— sahifa raqami.
Kanallarni yuklab olish
Kanallarni hisob asbobi turiga bogʻlangan holda yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ --data '{"equipment_type_id": "2", "page":"1"}' \ https://api.vadsro.eu/api/v1/channel_archive_typesMaʼlumotlarni quyidagi parametrlar boʻyicha siklik yuklab olishni tashkil etish kerak:
equipment_type_id— qurilma konfiguratsiyasi turining identifikatori;page— sahifa raqami.
Qurilma xabarlarini yuklab olish
Hisob asbobi turi uchun xabarlar (hodisa/xato kodlari) maʼlumotnomasini yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ "https://api.vadsro.eu/api/v1/message_equipment_types?equipment_type_id=11&page=1"Filtr parametrlari soʻrov satrida uzatiladi:
equipment_type_id— hisob asbobi turining identifikatori;archive_type_id— arxiv turining identifikatori (ixtiyoriy, tanlanmani toraytirish uchun);page— sahifa raqami.
Koʻrsatkichlar arxivlarini yuklab olish
Koʻrsatkichlar arxivlarini yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ --data '{"archive_type": "hourly", "equipment_id":"25", "fp_end":"2021-02-20", "fp_start":"2021-02-01", "page":"1"}' \ https://api.vadsro.eu/api/v1/channel_dataMaʼlumotlarni quyidagi parametrlar boʻyicha siklik yuklab olishni tashkil etish kerak:
equipment_id— hisob asbobining identifikatori;archive_type— arxiv turi (maʼlumotnomaga qarang);fp_start— vaqt oraligʻining boshi;fp_end— vaqt oraligʻining oxiri;page— sahifa raqami.
Davr uchun arxivni yuklab olish
Davr uchun arxivni yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ --data '{"archive_type": "hourly", "equipment_id":"25", "fp_end":"2021-02-20", "fp_start":"2021-02-01", "page":"1", "channel_consolidation": "1"}' \ https://api.vadsro.eu/api/v1/channel_dataMaʼlumotlarni quyidagi parametrlar boʻyicha siklik yuklab olishni tashkil etish kerak:
equipment_id— hisob asbobining identifikatori;archive_type— arxiv turi (maʼlumotnomaga qarang);fp_start— vaqt oraligʻining boshi;fp_end— vaqt oraligʻining oxiri;page— sahifa raqami;channel_consolidation: 1— unifikatsiyalangan yuklab olish parametri.
Hisoblagich konfiguratsiyasini yuklab olish
Hisoblagich konfiguratsiyasini yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ --data '{"archive_type": "settings", "equipment_id":"25", "page":"1"}' \ https://api.vadsro.eu/api/v1/channel_dataMaʼlumotlarni quyidagi parametrlar boʻyicha siklik yuklab olishni tashkil etish kerak:
equipment_id— hisob asbobining identifikatori;archive_type = “settings”;page— sahifa raqami.
Oxirgi aloqa seansi sanasini yuklab olish
Hisob tugunining oxirgi aloqa seansi (communication session) sanasini yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ --data '{ "id": "1816"}' https://api.vadsro.eu/api/v1/stations/last_seance_event_timeMaʼlumotlarni yuklab olishni quyidagi parametr boʻyicha tashkil etish kerak:
id— hisob tugunining identifikatori.
Aloqa seanslarini yuklab olish
Telemetriya aloqa seanslarini yuklab olish uchun GET soʻrovini yuborish kerak, masalan:
bashcurl -i --header "access-token: *********************" \ --header "token-type: Bearer" \ --header "client: **********************" \ --header "uid: api-user@example.com" \ --request GET \ --header "Content-Type: application/json" \ "https://api.vadsro.eu/api/v1/seances?telemetry_id=85&fp_start=2021-11-02&fp_end=2021-11-30&page=1"Maʼlumotlarni quyidagi parametrlar boʻyicha siklik yuklab olishni tashkil etish kerak:
telemetry_id— telemetriya blokining identifikatori;fp_start— vaqt oraligʻining boshi;fp_end— vaqt oraligʻining oxiri;page— sahifa raqami.
Ushbu sahifa foydali boʻldimi?
Fikr-mulohazangiz uchun rahmat!