Procedura de descărcare a datelor

  • Autentificarea inițială

    Autentificarea inițială este descrisă în subsecțiunea 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.
Ultima actualizare:

A fost utilă această pagină?

Tastați pentru a căuta în documentație

↑↓ pentru navigare
Esc