Jedinstveni interfejs za pristup

Univerzalni REST API

Sistem implementira univerzalni REST API koji obezbeđuje doslednu interakciju između različitih sistema, aplikacija i uređaja. Ovaj interfejs skriva detalje implementacije i omogućava standardizovan pristup podacima i funkcijama sistema.

Kada je reč o radu sa podacima, servis REST API ima sledeće karakteristike:

• Ujednačenost: Svi zahtevi i odgovori imaju isti format.
• Skalabilnost: Podržava veliki broj uređaja i korisnika.
• Bezbednost: Obezbeđuje autentifikaciju, autorizaciju i šifrovanje podataka.
• Dokumentacija: Ima jasnu dokumentaciju za programere.

Servis znatno pojednostavljuje dalji rad sa podacima:

• Pojednostavljena integracija: Različiti sistemi i uređaji mogu da komuniciraju preko jedinstvenog interfejsa.
• Apstrakcija hardvera: Aplikacije ne zavise od konkretnih uređaja ni protokola.
• Centralizovano upravljanje: Svi zahtevi za podacima prolaze kroz jedinstvenu ulaznu tačku.
• Fleksibilnost: Lako je dodati nove funkcije ili izmeniti postojeće.

Primer zahteva ka univerzalnom interfejsu REST API

Zahtev 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 interfejsa REST API

Servis REST API moćan je alat koji stvara jedinstven interfejs za pristup podacima.

Omogućava vam da:

• radite nezavisno od konkretnih uređaja i tehnologija;
• obezbedite doslednost i jednostavnost korišćenja;
• pojednostavite integraciju novih sistema i uređaja.

Jezik upita

Oslanjajući se na ovaj jedinstveni interfejs za pristup podacima, sistem koristi jezik upita kako bi korisnici i aplikacije mogli da rade sa bazom podataka – da preuzimaju i menjaju informacije ili da upravljaju njima. Univerzalni jezik upita obezbeđuje doslednost, jednostavnost korišćenja i velike mogućnosti za manipulaciju podacima.

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

• Pojednostavljena manipulacija podacima: Korisnici mogu da preuzimaju podatke bez pisanja složenog koda.
• Standardizacija: Jedan jezik za sve operacije sa podacima.
• Fleksibilnost: Mogućnost izvršavanja i jednostavnih i složenih upita.
• Integracija: Lako se integriše sa različitim sistemima i aplikacijama.

Primeri jezika upita koji se koriste u sistemu

SQL (Structured Query Language)

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

Primer SQL upita za preuzimanje podataka:

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

Interfejs REST sa parametrima

Univerzalni REST API u okviru rada sa podacima implementira interfejs REST sa parametrima. Zahvaljujući tome API može da koristi parametre upita za filtriranje podataka.

Na primer:

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

Interfejs za upite Active Record

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

U nastavku je primer upita Active Record za preuzimanje podataka:

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