--- title: Procedura de descărcare a datelor weight: 1 section: 'Guides' --- import Alert from '@/components/docs/Alert.astro'; import Steps from '@/components/docs/Steps.astro'; ### Autentificarea inițială La descărcarea datelor este important ca cererea să fie pregătită corect, cu parametrii de intrare specificați corect. Antetul cererii trebuie să conțină `header "Content-Type: application/json"` (un exemplu de apel este descris în detaliu în subsecțiunea [„Autentificare”](/ro/api/v1#autentificare)). Autentificarea inițială este descrisă în subsecțiunea [Autentificare](/ro/api/v1#autentificare). Pentru autentificarea inițială se folosesc adresa de e-mail și parola unui utilizator existent. În acest scop, trimiteți o cerere POST, de exemplu: ```bash curl -i --header "Content-Type: application/json" \ --request POST \ --data '{"email":"api-user@example.com","password":"Str0ngPas$"}' \ https://api.vadsro.eu/api/v1/auth/sign_in ``` ### Descărcarea listei consumatorilor Pentru a descărca lista consumatorilor, trimiteți o cerere GET, de exemplu: ```bash curl -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/customers ``` Datele se descarcă pagină cu pagină (`"total_pages": 8` – numărul total de pagini, `"current_page": 2` – pagina curentă). Descărcați datele ciclic, pagină cu pagină: ```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 } ``` Pentru a descărca ulterior datele (arhivele de valori), sunt necesari următorii parametri: - `"id": 13` (`"customer_id": "13"`) – identificatorul (cheia unică) al consumatorului în sistem. ### Descărcarea listei punctelor de măsurare Pentru a descărca lista punctelor de măsurare, trimiteți o cerere GET, de exemplu: ```bash curl -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/stations ``` Datele se descarcă pagină cu pagină (`"total_pages": 9` – numărul total de pagini, `"current_page": 2` – pagina curentă). Descărcați datele ciclic, pagină cu pagină. ```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 } ``` Pentru a descărca ulterior datele (arhivele de valori), sunt necesari următorii parametri: - `"equipment_id": 61` – identificatorul dispozitivului de măsurare. Pentru armonizarea datelor (nomenclatoare): - `"customer_id": 14` – identificatorul consumatorului; - `"equipment_type_id": 1` – identificatorul tipului de configurație al dispozitivului de măsurare. ### Descărcarea caracteristicilor amplasamentului Pentru a descărca caracteristicile unui punct de măsurare, trimiteți o cerere GET cu identificatorul acestuia în cale, de exemplu: ```bash curl -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/characteristics ``` Parametrul `id` este identificatorul punctului de măsurare, obținut la descărcarea listei punctelor de măsurare. ### Descărcarea tipurilor de dispozitive de măsurare Pentru a descărca tipurile de dispozitive de măsurare, trimiteți o cerere GET, de exemplu: ```bash curl -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_types ``` Descărcați datele ciclic, după următorii parametri: - `page` – numărul paginii. ### Descărcarea canalelor Pentru a descărca canalele asociate tipului de dispozitiv de măsurare, trimiteți o cerere GET, de exemplu: ```bash curl -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_types ``` Descărcați datele ciclic, după următorii parametri: - `equipment_type_id` – identificatorul tipului de configurație al dispozitivului; - `page` – numărul paginii. ### Descărcarea mesajelor dispozitivelor Pentru a descărca nomenclatorul mesajelor (coduri de eveniment / de eroare) al unui tip de dispozitiv de măsurare, trimiteți o cerere GET, de exemplu: ```bash curl -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" ``` Parametrii de filtrare se transmit în șirul de interogare: - `equipment_type_id` – identificatorul tipului de dispozitiv de măsurare; - `archive_type_id` – identificatorul tipului de arhivă (opțional, pentru a restrânge setul de rezultate); - `page` – numărul paginii. ### Descărcarea arhivelor citirilor Pentru a descărca arhivele citirilor, trimiteți o cerere GET, de exemplu: ```bash curl -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_data ``` Descărcați datele ciclic, după următorii parametri: - `equipment_id` – identificatorul dispozitivului de măsurare; - `archive_type` – tipul arhivei (consultați nomenclatorul); - `fp_start` – începutul intervalului de timp; - `fp_end` – sfârșitul intervalului de timp; - `page` – numărul paginii. ### Descărcarea arhivei pentru o perioadă Pentru a descărca arhiva pentru o perioadă, trimiteți o cerere GET, de exemplu: ```bash curl -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_data ``` Descărcați datele ciclic, după următorii parametri: - `equipment_id` – identificatorul dispozitivului de măsurare; - `archive_type` – tipul arhivei (consultați nomenclatorul); - `fp_start` – începutul intervalului de timp; - `fp_end` – sfârșitul intervalului de timp; - `page` – numărul paginii; - `channel_consolidation: 1` – parametru pentru descărcarea unificată. ### Descărcarea configurației contorului Pentru a descărca configurația contorului, trimiteți o cerere GET, de exemplu: ```bash curl -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_data ``` Descărcați datele ciclic, după următorii parametri: - `equipment_id` – identificatorul dispozitivului de măsurare; - `archive_type = “settings”`; - `page` – numărul paginii. ### Descărcarea datei ultimei sesiuni de comunicație Pentru a descărca data ultimei sesiuni de comunicație a punctului de măsurare, trimiteți o cerere GET, de exemplu: ```bash curl -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_time ``` Descărcați datele după următorul parametru: - `id` – identificatorul punctului de măsurare. ### Descărcarea sesiunilor de comunicație Pentru a descărca sesiunile de comunicație ale modulului de telemetrie, trimiteți o cerere GET, de exemplu: ```bash curl -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" ``` Descărcați datele ciclic, după următorii parametri: - `telemetry_id` – identificatorul modulului de telemetrie; - `fp_start` – începutul intervalului de timp; - `fp_end` – sfârșitul intervalului de timp; - `page` – numărul paginii. După parcurgerea pașilor de mai sus, [încheiați sesiunea](/ro/api/v1#autentificare).