Rozdíly
Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
cs:mervis-scada:50-api [2021/04/15 10:33] m.chlupac [api/checkCredentials] |
cs:mervis-scada:50-api [2024/05/08 10:42] |
||
---|---|---|---|
Řádek 1: | Řádek 1: | ||
- | ====== API ====== | ||
- | |||
- | Mervis SCADA nabízí otevřené REST-like API postavené na JSON a XML formátech dat. Pro kompletní popis API kontaktujte naši [[cs: | ||
- | |||
- | ===== Přehled základních API metod ===== | ||
- | |||
- | ^Function^Description| | ||
- | |||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^api/ | ||
- | ^/ | ||
- | |||
- | |||
- | ===== Příklad ===== | ||
- | |||
- | ====api/ | ||
- | |||
- | **Request** | ||
- | |||
- | * URL: https:// | ||
- | * Method: POST | ||
- | |||
- | **Request** | ||
- | |||
- | <code javascript> | ||
- | {" | ||
- | </ | ||
- | |||
- | **Response** | ||
- | |||
- | <code xml> | ||
- | <?xml version=" | ||
- | < | ||
- | </ | ||
- | |||
- | * Získaný token **t** je třeba použít místo dvojice jméno/ | ||
- | |||
- | ====api/ | ||
- | |||
- | **Request** | ||
- | |||
- | * URL: / | ||
- | * Method: POST | ||
- | * Umožňuje stahovat historii pro více datových bodů | ||
- | * V ukázkách je vždy za dvěma lomítky uvedený typ property | ||
- | * V sekci credentials lze místo " | ||
- | * " | ||
- | * " | ||
- | * položky " | ||
- | |||
- | |||
- | <code javascript> | ||
- | { | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | } | ||
- | }, | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | } | ||
- | } | ||
- | ] | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | } | ||
- | </ | ||
- | |||
- | **Response** | ||
- | |||
- | * Dokud je v odpovědi v sekci " | ||
- | * " | ||
- | * Values | ||
- | * v - hodnota | ||
- | * ts - začátek platnosti hodnoty | ||
- | * gt - konec platnosti hodnoty | ||
- | * i - interval, pokud je jiný než uvedená hodnota u celé série | ||
- | * Meta | ||
- | * type - typ uložených hodnot - double, string, datetime | ||
- | * unit - jednotky | ||
- | * interval - informace o periodě, v jaké by měly být hodnoty v databázi uloženy. Slouží k identifikaci chybějících záznamů. | ||
- | |||
- | <code javascript> | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | ] | ||
- | }, | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | }, | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | ] | ||
- | } | ||
- | ] | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | } | ||
- | |||
- | |||
- | </ | ||
- | |||
- | **Funkční demo** | ||
- | <code javascript> | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | } | ||
- | }, | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | } | ||
- | } | ||
- | ] | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | } | ||
- | } | ||
- | |||
- | </ | ||
- | ==== [Deprecated] api/ | ||
- | |||
- | **Request** | ||
- | |||
- | * URL: / | ||
- | * Method: POST | ||
- | |||
- | <code javascript> | ||
- | { | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | </ | ||
- | |||
- | **Response** | ||
- | |||
- | <code xml> | ||
- | <?xml version=" | ||
- | < | ||
- | <hist projId=" | ||
- | < | ||
- | < | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | |||
- | |||
- | </ | ||
- | |||
- | |||
- | ====api/ | ||
- | |||
- | **Request** | ||
- | |||
- | * URL: / | ||
- | * Method: POST | ||
- | * Content-Type: | ||
- | |||
- | Atribut **i** nastavuje **interval** ([[https:// | ||
- | |||
- | V **cred** lze použít i ověření pomocí jména a hesla, ale využití **tokenu** nabízí vyšší výkon. | ||
- | |||
- | Všechny časové údaje jsou očekávány v UTC. | ||
- | |||
- | <code xml> | ||
- | <?xml version=" | ||
- | < | ||
- | xmlns: | ||
- | xmlns: | ||
- | projId=" | ||
- | dpId=" | ||
- | <n2:cred t=" | ||
- | < | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | <hv ts=" | ||
- | < | ||
- | </hv> | ||
- | </ | ||
- | </ | ||
- | |||
- | **Response** | ||
- | |||
- | * 200 OK | ||
- | |||
- | ====api/ | ||
- | |||
- | **Request** | ||
- | |||
- | * URL: / | ||
- | * Method: POST | ||
- | * Content-Type: | ||
- | |||
- | <code xml> | ||
- | <?xml version=" | ||
- | < | ||
- | xmlns: | ||
- | xmlns: | ||
- | xmlns: | ||
- | <n1:cred t=" | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | </ | ||
- | </ | ||
- | < | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | |||
- | **Response** | ||
- | |||
- | <code xml><? | ||
- | < | ||
- | |||
- | ====api/ | ||
- | |||
- | Nejvhodnější způsob vyčtení aktuálních hodnot datových bodů (property " | ||
- | |||
- | **Request** | ||
- | |||
- | * URL: / | ||
- | * Method: POST | ||
- | |||
- | <code javascript> | ||
- | { | ||
- | " | ||
- | " | ||
- | }, | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | " | ||
- | } | ||
- | ] | ||
- | } | ||
- | |||
- | </ | ||
- | |||
- | **Response** | ||
- | |||
- | <code xml><? | ||
- | <values xmlns: | ||
- | < | ||
- | <v projId=" | ||
- | < | ||
- | <d id=" | ||
- | < | ||
- | <p n=" | ||
- | < | ||
- | </p> | ||
- | </ | ||
- | </d> | ||
- | <d id=" | ||
- | < | ||
- | <p n=" | ||
- | < | ||
- | </p> | ||
- | </ | ||
- | </d> | ||
- | </ | ||
- | </v> | ||
- | </ | ||
- | </ | ||
- | |||
- | |||