Jednotné prístupové rozhranie

Univerzálne REST API

Systém implementuje univerzálne REST API, ktoré zabezpečuje konzistentnú interakciu medzi rôznymi systémami, aplikáciami a zariadeniami. Abstrahuje implementačné detaily a poskytuje štandardizovaný spôsob prístupu k údajom a funkciám systému.

Služba REST API má pri práci s údajmi tieto vlastnosti:

• Jednotnosť: Všetky požiadavky a odpovede majú rovnaký formát.
• Škálovateľnosť: Podporuje veľký počet zariadení a používateľov.
• Bezpečnosť: Zabezpečuje autentifikáciu, autorizáciu a šifrovanie údajov.
• Dokumentácia: Disponuje prehľadnou dokumentáciou pre vývojárov.

Služba výrazne zjednodušuje ďalšiu prácu s údajmi:

• Zjednodušená integrácia: Rôzne systémy a zariadenia môžu navzájom komunikovať cez jediné rozhranie.
• Abstrakcia hardvéru: Aplikácie nie sú závislé od konkrétnych zariadení ani protokolov.
• Centralizovaná správa: Všetky požiadavky na údaje prechádzajú jediným vstupným bodom.
• Flexibilita: Nové funkcie možno jednoducho pridávať a existujúce upravovať.

Príklad požiadavky univerzálneho REST API

Požiadavka na údaje:

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

Odpoveď:

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

Výhody univerzálneho REST API

Služba REST API je výkonný nástroj, ktorý vytvára jednotné rozhranie pre prístup k údajom.

Umožňuje vám:

• Abstrahovať od konkrétnych zariadení a technológií.
• Zaistiť konzistentnosť a jednoduché používanie.
• Zjednodušiť integráciu nových systémov a zariadení.

Dopytovací jazyk

Na základe tohto jednotného rozhrania pre prístup k údajom systém využíva dopytovací jazyk, vďaka ktorému môžu používatelia a aplikácie komunikovať s databázou pri získavaní, úprave či správe informácií. Univerzálny dopytovací jazyk zabezpečuje konzistentnosť, jednoduché používanie a výkonné možnosti manipulácie s údajmi.

Dopytovací jazyk poskytuje tieto možnosti:

• Zjednodušená manipulácia s údajmi: Používatelia môžu získavať údaje bez písania zložitého kódu.
• Štandardizácia: Jediný jazyk pre všetky operácie s údajmi.
• Flexibilita: Možnosť spúšťať jednoduché aj zložité dopyty.
• Integrácia: Jednoduchá integrácia s rôznymi systémami a aplikáciami.

Príklady dopytovacích jazykov používaných v systéme

SQL (Structured Query Language)

Systém na správu databáz PostgreSQL používa na prácu s údajmi dopytovací jazyk SQL. Podporuje základné operácie manipulácie s údajmi.

Príklad SQL dopytu na získanie údajov:

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

REST rozhranie s parametrami

Univerzálne REST API v rámci práce s údajmi implementuje REST rozhranie s parametrami. To umožňuje API filtrovať údaje pomocou parametrov dopytu.

Napríklad:

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

Dopytovacie rozhranie Active Record

Framework Ruby on Rails implementuje Active Record (dopytovacie rozhranie Active Record), ktoré umožňuje dopytovať databázy bez použitia SQL.

Tu je príklad dopytu Active Record na získanie údajov:

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