Rozdíly
Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
Obě strany předchozí revize Předchozí verze Následující verze | Předchozí verze Následující verze Obě strany příští revize | ||
cs:mervis-scada:50-api [2018/11/02 07:33] m.chlupac |
cs:mervis-scada:50-api [2024/04/16 11:25] v.musilek [api/set/executeActions] |
||
---|---|---|---|
Řádek 28: | Řádek 28: | ||
^api/ | ^api/ | ||
^api/ | ^api/ | ||
+ | ^/ | ||
===== Příklad ===== | ===== Příklad ===== | ||
- | ====api/get/history==== | + | ==== api/checkCredentials |
**Request** | **Request** | ||
- | * URL: /api/get/history?format=xml | + | * URL: https://scada.mervis.info/ |
* Method: POST | * Method: POST | ||
+ | |||
+ | |||
+ | <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> | <code javascript> | ||
{ | { | ||
- | " | + | " |
- | "t":" | + | " |
+ | }, | ||
+ | " | ||
+ | "commonSeriesParameters": | ||
+ | "from": "2018-12-01T00: | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | } | ||
+ | }, | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | ] | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | **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> | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
}, | }, | ||
- | " | + | " |
- | " | + | " |
- | " | + | " |
- | " | + | " |
- | " | + | |
" | " | ||
" | " | ||
Řádek 58: | Řádek 274: | ||
<code xml> | <code xml> | ||
+ | <?xml version=" | ||
< | < | ||
- | <hist projId=" | + | <hist projId=" |
< | < | ||
< | < | ||
- | <hv ts="2017-05-08T22:26:53.32684Z" gt="2017-05-08T22:31:53.465467Z"> | + | <hv ts="2018-11-02T21:26:08.7936747Z" gt="2018-11-03T20:35:08.8060769Z"> |
- | < | + | < |
</hv> | </hv> | ||
- | <hv ts="2017-05-08T22:36:53.283875Z"> | + | <hv ts="2018-11-03T20:41:09.0100479Z" |
- | < | + | < |
</hv> | </hv> | ||
- | <hv ts="2017-05-08T22:41:53.435042Z"> | + | <hv ts="2018-11-05T11:40:04.0077949Z" |
- | < | + | < |
</hv> | </hv> | ||
- | <hv ts="2017-05-08T22:46:53.711496Z" gt="2017-05-08T23:36:53.776657Z"> | + | <hv ts="2018-11-05T17:28:03.4133447Z" gt="2018-11-05T19:40:03.0246122Z"> |
- | < | + | < |
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
</hv> | </hv> | ||
- | |||
</ | </ | ||
</ | </ | ||
Řádek 82: | Řádek 322: | ||
</ | </ | ||
- | ====api/v2/get/ | + | |
+ | ====api/set/ | ||
**Request** | **Request** | ||
- | * URL: /api/v2/get/ | + | * URL: /api/set/history? |
+ | * 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 ts=" | ||
+ | < | ||
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
+ | </ | ||
+ | <hv ts=" | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Response** | ||
+ | |||
+ | * 200 OK | ||
+ | |||
+ | ====api/ | ||
+ | |||
+ | * URL: / | ||
+ | * Method: POST | ||
+ | * Content-Type: | ||
+ | |||
+ | ===DoubleValue=== | ||
+ | |||
+ | **Request** | ||
+ | |||
+ | <code xml> | ||
+ | <?xml version=" | ||
+ | < | ||
+ | xmlns: | ||
+ | xmlns: | ||
+ | xmlns: | ||
+ | <n1:cred t=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Response** | ||
+ | |||
+ | <code xml><? | ||
+ | < | ||
+ | |||
+ | ===PlanningCalendar=== | ||
+ | |||
+ | * v requestu je atribut " | ||
+ | * pokud je kalendář číslený místo " | ||
+ | |||
+ | **Request** | ||
+ | |||
+ | <code xml> | ||
+ | <?xml version=" | ||
+ | < | ||
+ | xmlns: | ||
+ | xmlns: | ||
+ | <n1:cred t=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | <n2:ch cmd=" | ||
+ | <n2:def start=" | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Response** | ||
+ | |||
+ | <code xml><? | ||
+ | < | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ====api/ | ||
+ | |||
+ | Nejvhodnější způsob vyčtení aktuálních hodnot datových bodů (property " | ||
+ | |||
+ | **Request** | ||
+ | |||
+ | * URL: / | ||
* Method: POST | * Method: POST | ||
<code javascript> | <code javascript> | ||
- | { | + | { |
- | " | + | " |
- | | + | "t": "xxxxxx" //token |
- | " | + | }, |
- | "p":" | + | " |
- | " | + | " |
- | | + | " |
- | "projId":" | + | " |
- | " | + | " |
- | " | + | |
- | | + | |
- | " | + | } |
- | " | + | ] |
- | "historyState":"" | + | |
- | "providersDps": | + | |
- | { | + | |
- | "m_Item1":" | + | |
- | "m_Item2":" | + | |
- | }, | + | |
- | | + | |
- | | + | |
- | " | + | |
- | } | + | |
- | ] | + | |
- | } | + | |
} | } | ||
+ | |||
</ | </ | ||
**Response** | **Response** | ||
- | <code xml> | + | <code xml><? |
- | <?xml version=" | + | <values |
- | <globalResponse | + | <vals> |
- | <result code=" | + | <v projId="ba1a92f7-f213-4a72-90e4-f7142b50274b" |
- | <data n1: | + | |
- | <n1: | + | <d id="e089dde2-a097-4e0d-8012-c8cf3dc62694" |
- | <n1: | + | |
- | <n1: | + | <p n=" |
- | <n2:pl> | + | |
- | <n2:p n=" | + | </p> |
- | <n3:hist projId="5abf8ca0-94ba-48df-8d3c-7ebe87a12fd0" | + | |
- | <n3:errMsg></ | + | </d> |
- | < | + | <d id="1089dde2-a097-4e0d-8012-c8cf3dc62696" |
- | <n3:hv ts="2018-10-23T16: | + | |
- | <n4:v>11979</n4:v> | + | <p n=" |
- | </n3:hv> | + | |
- | </n3:vals> | + | </ |
- | </n3:hist> | + | |
- | </n2:p> | + | </d> |
- | <n2:p n="Output" | + | |
- | <n3:hist projId="5abf8ca0-94ba-48df-8d3c-7ebe87a12fd0" | + | </v> |
- | <n3: | + | </vals> |
- | <n3: | + | </values></ |
- | <n3:hv ts="2018-10-24T12:48:42.1926956Z" | + | |
- | <n4:v>12702</n4:v> | + | |
- | </n3:hv> | + | |
- | </ | + | |
- | </ | + | |
- | </n2:p> | + | |
- | </n2:pl> | + | |
- | </n1: | + | |
- | </n1: | + | |
- | </n1: | + | |
- | </data> | + | |
- | </globalResponse> | + | |
- | </ | + | |