Postupak preuzimanja podataka

  • Početna autentifikacija

    Početna autentifikacija opisana je u pododeljku Autentifikacija.

    Za početnu autentifikaciju koriste se imejl adresa i lozinka postojećeg korisnika. U tu svrhu pošaljite POST zahtev, na primer:

    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

  • Preuzimanje liste potrošača

    Da biste preuzeli listu potrošača, pošaljite GET zahtev, na primer:

    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

    Podaci se preuzimaju po stranicama ("total_pages": 8 – ukupan broj stranica, "current_page": 2 – trenutna stranica).

    Potrebno je ciklično preuzimati podatke stranicu po stranicu:

    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
}

    Za dalje preuzimanje podataka (arhiva vrednosti) biće potrebni sledeći parametri:

    • "id": 13 ("customer_id": "13") – identifikator (jedinstveni ključ) potrošača u sistemu.

  • Preuzimanje liste mernih mesta

    Da biste preuzeli listu mernih mesta, pošaljite GET zahtev, na primer:

    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

    Podaci se preuzimaju po stranicama ("total_pages": 9 – ukupan broj stranica, "current_page": 2 – trenutna stranica).

    Potrebno je ciklično preuzimati podatke stranicu po stranicu.

    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
}

    Za dalje preuzimanje podataka (arhiva vrednosti) potrebni su sledeći parametri:

    • "equipment_id": 61 – identifikator mernog uređaja.

    Za usklađivanje podataka sa šifarnicima:

    • "customer_id": 14 – identifikator potrošača;
    • "equipment_type_id": 1 – identifikator tipa konfiguracije mernog uređaja.

  • Preuzimanje karakteristika objekta

    Da biste preuzeli karakteristike mernog mesta, pošaljite GET zahtev sa identifikatorom mernog mesta u putanji, na primer:

    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

    id je identifikator mernog mesta dobijen pri preuzimanju liste mernih mesta.

  • Preuzimanje tipova mernih uređaja

    Da biste preuzeli tipove mernih uređaja, pošaljite GET zahtev, na primer:

    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

    Potrebno je ciklično preuzimati podatke po sledećim parametrima:

    • page – broj stranice.

  • Preuzimanje kanala

    Da biste preuzeli kanale vezane za tip mernog uređaja, pošaljite GET zahtev, na primer:

    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

    Potrebno je ciklično preuzimati podatke po sledećim parametrima:

    • equipment_type_id – identifikator tipa konfiguracije uređaja;
    • page – broj stranice.

  • Preuzimanje poruka uređaja

    Da biste preuzeli šifarnik poruka (kodova događaja i grešaka) za tip mernog uređaja, pošaljite GET zahtev, na primer:

    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"

    Parametri filtera prosleđuju se kao parametri upita u URL-u:

    • equipment_type_id – identifikator tipa mernog uređaja;
    • archive_type_id – identifikator tipa arhive (opciono, sužava skup rezultata);
    • page – broj stranice.

  • Preuzimanje arhiva očitavanja

    Da biste preuzeli arhive očitavanja, pošaljite GET zahtev, na primer:

    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

    Potrebno je ciklično preuzimati podatke po sledećim parametrima:

    • equipment_id – identifikator mernog uređaja;
    • archive_type – tip arhive (pogledajte šifarnik);
    • fp_start – početak vremenskog intervala;
    • fp_end – kraj vremenskog intervala;
    • page – broj stranice.

  • Preuzimanje arhive za period

    Da biste preuzeli arhivu za period, pošaljite GET zahtev, na primer:

    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

    Potrebno je ciklično preuzimati podatke po sledećim parametrima:

    • equipment_id – identifikator mernog uređaja;
    • archive_type – tip arhive (pogledajte šifarnik);
    • fp_start – početak vremenskog intervala;
    • fp_end – kraj vremenskog intervala;
    • page – broj stranice;
    • channel_consolidation: 1 – parametar za objedinjeno preuzimanje.

  • Preuzimanje konfiguracije merila

    Da biste preuzeli konfiguraciju merila, pošaljite GET zahtev, na primer:

    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

    Potrebno je ciklično preuzimati podatke po sledećim parametrima:

    • equipment_id – identifikator mernog uređaja;
    • archive_type = “settings”;
    • page – broj stranice.

  • Preuzimanje datuma poslednje komunikacione sesije

    Da biste preuzeli datum poslednje komunikacione sesije mernog mesta, pošaljite GET zahtev, na primer:

    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

    Potrebno je preuzimati podatke po sledećem parametru:

    • id – identifikator mernog mesta.

  • Preuzimanje komunikacionih sesija

    Da biste preuzeli komunikacione sesije telemetrijskih modula, pošaljite GET zahtev, na primer:

    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"

    Potrebno je ciklično preuzimati podatke po sledećim parametrima:

    • telemetry_id – identifikator telemetrijskog modula;
    • fp_start – početak vremenskog intervala;
    • fp_end – kraj vremenskog intervala;
    • page – broj stranice.
Poslednje ažuriranje

Da li vam je ova stranica bila korisna?

Počnite da kucate za pretragu dokumentacije

↑↓ za kretanje
Esc