Jednotné přístupové rozhraní

Univerzální REST API

Systém implementuje univerzální REST API, které zajišťuje konzistentní interakci mezi různými systémy, aplikacemi a zařízeními. Abstrahuje implementační detaily a poskytuje standardizovaný způsob přístupu k datům a funkcím systému.

Služba REST API má následující vlastnosti v oblasti práce s daty:

• Jednotnost: Všechny požadavky a odpovědi dodržují stejný formát.
• Škálovatelnost: Podporuje velké množství zařízení a uživatelů.
• Bezpečnost: Zajišťuje autentizaci, autorizaci a šifrování dat.
• Dokumentace: Disponuje přehlednou dokumentací pro vývojáře.

Služba výrazně zjednodušuje další práci s daty:

• Zjednodušená integrace: Různé systémy a zařízení spolu mohou komunikovat prostřednictvím jednotného rozhraní.
• Hardwarová abstrakce: Aplikace nezávisí na konkrétních zařízeních ani protokolech.
• Centralizovaná správa: Všechny požadavky na data procházejí jediným vstupním bodem.
• Flexibilita: Nové funkce lze snadno přidávat a stávající upravovat.

Příklad požadavku na univerzální REST API

Požadavek na data:

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

Odpověď:

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

Přínosy univerzálního REST API

Služba REST API je výkonný nástroj, který vytváří jednotné rozhraní pro přístup k datům.

Umožňuje vám:

• Abstrahovat od konkrétních zařízení a technologií.
• Zajistit konzistenci a snadné použití.
• Zjednodušit integraci nových systémů a zařízení.

Dotazovací jazyk

Na tomto jednotném rozhraní pro přístup k datům systém staví dotazovací jazyk, díky kterému mohou uživatelé a aplikace komunikovat s databází za účelem získávání, úprav nebo správy informací. Univerzální dotazovací jazyk zajišťuje konzistenci, snadné použití a výkonné možnosti manipulace s daty.

Dotazovací jazyk poskytuje následující možnosti:

• Zjednodušená manipulace s daty: Uživatelé mohou získávat data bez psaní složitého kódu.
• Standardizace: Jednotný jazyk pro všechny operace s daty.
• Flexibilita: Možnost spouštět jednoduché i složité dotazy.
• Integrace: Snadno se integruje s různými systémy a aplikacemi.

Příklady dotazovacích jazyků používaných v systému

SQL (Structured Query Language)

DBMS PostgreSQL používá k práci s daty dotazovací jazyk SQL. Podporuje základní operace manipulace s daty.

Příklad SQL dotazu pro získání dat:

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

REST rozhraní s parametry

Univerzální REST API implementuje v rámci interakce s daty REST rozhraní s parametry. To umožňuje API používat k filtrování dat parametry dotazu.

Například:

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

Dotazovací rozhraní Active Record

Framework Ruby on Rails implementuje Active Record (Active Record Query Interface), který umožňuje dotazovat se na databáze bez použití SQL.

Zde je příklad dotazu Active Record pro získání dat:

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