Jedinstveno sučelje za pristup

Univerzalni REST API

Sustav implementira univerzalni REST API koji osigurava dosljednu interakciju između različitih sustava, aplikacija i uređaja. Ovo sučelje skriva pojedinosti implementacije i omogućuje standardiziran pristup podacima i funkcijama sustava.

Kad je riječ o radu s podacima, usluga REST API ima sljedeće karakteristike:

• Ujednačenost: svi zahtjevi i odgovori imaju isti format.
• Skalabilnost: podržava velik broj uređaja i korisnika.
• Sigurnost: osigurava autentifikaciju, autorizaciju i šifriranje podataka.
• Dokumentacija: ima jasnu dokumentaciju za programere.

Usluga znatno pojednostavnjuje daljnji rad s podacima:

• Pojednostavnjena integracija: različiti sustavi i uređaji mogu komunicirati putem jedinstvenog sučelja.
• Apstrakcija hardvera: aplikacije ne ovise o konkretnim uređajima ni protokolima.
• Centralizirano upravljanje: svi zahtjevi za podacima prolaze kroz jedinstvenu ulaznu točku.
• Fleksibilnost: lako je dodati nove funkcije ili izmijeniti postojeće.

Primjer zahtjeva prema univerzalnom sučelju REST API

Zahtjev za podacima:

GET /api/v1/channel_data?equipment_id=1&archive_type=daily&channel_id=3

Odgovor:

[
  {
    "id": 123,
    "equipment_id": 1,
    "seance_id": 2,
    "channel_id": 3,
    "archive_type_id": 4,
    "value": 42.5,
    "event_time": 1739950861
  }
]

Prednosti univerzalnog sučelja REST API

Usluga REST API moćan je alat koji stvara jedinstveno sučelje za pristup podacima.

Omogućuje vam da:

• radite neovisno o konkretnim uređajima i tehnologijama;
• osigurate dosljednost i jednostavnost korištenja;
• pojednostavnite integraciju novih sustava i uređaja.

Jezik upita

Oslanjajući se na ovo jedinstveno sučelje za pristup podacima, sustav koristi jezik upita kako bi korisnici i aplikacije mogli raditi s bazom podataka – dohvaćati i mijenjati informacije ili upravljati njima. Univerzalni jezik upita osigurava dosljednost, jednostavnost korištenja i velike mogućnosti za manipulaciju podacima.

Jezik upita pruža sljedeće mogućnosti:

• Pojednostavnjena manipulacija podacima: korisnici mogu dohvaćati podatke bez pisanja složenog koda.
• Standardizacija: jedan jezik za sve operacije nad podacima.
• Fleksibilnost: mogućnost izvršavanja i jednostavnih i složenih upita.
• Integracija: lako se integrira s različitim sustavima i aplikacijama.

Primjeri jezika upita koji se koriste u sustavu

SQL (Structured Query Language)

Sustav za upravljanje bazama podataka (DBMS) PostgreSQL za rad s podacima koristi jezik upita SQL. Podržava osnovne operacije za manipulaciju podacima.

Primjer SQL upita za dohvaćanje podataka:

SELECT id, channel_id, value
FROM channel_data
WHERE equipment_id = 1 AND archive_type_id = 4;

Sučelje REST s parametrima

Univerzalni REST API u okviru rada s podacima implementira sučelje REST s parametrima. Zahvaljujući tome API može koristiti parametre upita za filtriranje podataka.

Na primjer:

GET /api/v1/channel_data?equipment_id=1&channel_id=101

Sučelje za upite Active Record

Programski okvir Ruby on Rails implementira Active Record (Active Record Query Interface), koji vam omogućuje da izvršavate upite nad bazama podataka bez korištenja jezika SQL.

U nastavku je primjer upita Active Record za dohvaćanje podataka:

ChannelDatum.where(equipment_id: 1, archive_type_id: 4)