Interfața unificată de acces

Interfața REST API universală

Sistemul implementează o interfață REST API universală, care asigură o interacțiune coerentă între diferite sisteme, aplicații și dispozitive. Interfața face abstracție de detaliile de implementare și oferă o cale standardizată de acces la datele și funcțiile sistemului.

Serviciul REST API are următoarele caracteristici în lucrul cu datele:

• Uniformitate: toate cererile și răspunsurile respectă același format.
• Scalabilitate: acceptă un număr mare de dispozitive și de utilizatori.
• Securitate: asigură autentificarea, autorizarea și criptarea datelor.
• Documentație: dispune de o documentație clară pentru dezvoltatori.

Serviciul simplifică considerabil lucrul ulterior cu datele:

• Integrare simplificată: diferite sisteme și dispozitive pot interacționa printr-o singură interfață.
• Abstractizare hardware: aplicațiile nu depind de dispozitive sau protocoale concrete.
• Gestionare centralizată: toate cererile de date trec printr-un singur punct de intrare.
• Flexibilitate: funcțiile noi se adaugă, iar cele existente se modifică fără dificultate.

Exemplu de cerere către interfața REST API universală

Cererea de date:

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

Răspunsul:

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

Avantajele interfeței REST API universale

Serviciul REST API este un instrument puternic, care creează o interfață unificată de acces la date.

Acesta vă permite:

• să faceți abstracție de dispozitivele și tehnologiile concrete;
• să asigurați coerența și ușurința în utilizare;
• să simplificați integrarea noilor sisteme și dispozitive.

Limbajul de interogare

Pornind de la această interfață unificată de acces la date, sistemul folosește un limbaj de interogare prin care utilizatorii și aplicațiile pot interacționa cu baza de date pentru a obține, a modifica sau a gestiona informații. Un limbaj de interogare universal asigură coerență, ușurință în utilizare și posibilități extinse de manipulare a datelor.

Limbajul de interogare oferă următoarele posibilități:

• Manipulare simplificată a datelor: utilizatorii pot obține date fără să scrie cod complex.
• Standardizare: un singur limbaj pentru toate operațiile cu date.
• Flexibilitate: se pot executa atât interogări simple, cât și interogări complexe.
• Integrare: se integrează ușor cu diverse sisteme și aplicații.

Exemple de limbaje de interogare folosite în sistem

SQL (Structured Query Language)

Sistemul de gestiune a bazelor de date (DBMS) PostgreSQL folosește limbajul de interogare SQL pentru lucrul cu datele. Limbajul acceptă operațiile de bază de manipulare a datelor.

Exemplu de interogare SQL pentru obținerea datelor:

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

Interfața REST cu parametri

În lucrul cu datele, interfața REST API universală implementează o interfață REST cu parametri. Astfel, interfața API poate folosi parametri de interogare pentru filtrarea datelor.

De exemplu:

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

Active Record Query Interface

Cadrul de dezvoltare Ruby on Rails implementează Active Record (Active Record Query Interface), care vă permite să interogați bazele de date fără SQL.

Iată un exemplu de interogare Active Record pentru obținerea datelor:

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