MSA Grid RESTful API Скачать руководство пользователя страница 1

Страница: 1 / 53

Grid RESTful API Start-up Guide

Start-up Guide

Grid

RESTful API

MSAsafety.com

Document Revision: 2.A

T18663

APPLICABILITY & EFFECTIVITY

Effective for all systems manufactured after August 2021.

Содержание Grid RESTful API

Страница 1: ...Grid RESTful API Start up Guide 0 Start up Guide Grid RESTful API MSAsafety com Document Revision 2 A T18663 APPLICABILITY EFFECTIVITY Effective for all systems manufactured after August 2021...

Страница 2: ...MSA Safety 1991 Tarob Court Milpitas CA 95035 Website www MSAsafety com U S Support Information 1 408 964 4443 1 800 727 4377 Email smc support msasafety com EMEA Support Information 31 33 808 0590 Em...

Страница 3: ...e 3 Assumptions The following items should be complete before moving forward with Grid RESTful API setup Install preferred RESTful client program Setup a Grid account Login to a computer with access t...

Страница 4: ...ul API Start up Guide 4 Quick Start Guide 1 Open the preferred RESTful client 2 Authenticate with www FieldPoP io rest login 3 Test the API a Set up a sample b Run the sample 4 Run GET device data log...

Страница 5: ...2 6 Firmware Methods 41 2 6 1 GetDeviceFirmwareVersions 41 2 6 2 UpgradeFirmware 42 3 Additional Information 43 3 1 General Notes 43 3 1 1 How to Obtain an IIoT Device ID DeviceID Parameter Value 43 3...

Страница 6: ...id RESTful API acts as a RESTful server using HTTPS The API will support authentication read operations and write operations including Read HTTP GET o data logs recorded on the Grid o event logs recor...

Страница 7: ...happn_token rest method fieldpop api deviceDataLog happn_token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9 ImlkfGNiMmQ0N Dg5LTAyNTQtNGJlYy1hZWNiLThkZDM3NDY0NjA3Mnx0eXBlfHRpbWVzdGFtcHxpc0VuY3J5cHRlZHxvcmlnaW5...

Страница 8: ...SF9HU1QvfGlzVG9rZW58dXNlcm5hbWV8ZWdnZ XJzamVuc0BnbWFpbC5jb21eMHxKNjZCOFBGR3wwfDBeXiQwfDF8MnxIfDN8SXw0fC0yfDV8Nnw3fCQ4fCQ5fEp8QXwtM11 8QnwkOXxLfEF8LTNdXXxDfER8RXwtMXxGfEddIg ihjURRHILcXp iTl4FvjjAma1sI...

Страница 9: ...poch JSON Response Object containing time series data Example GET URL rest method fieldpop api deviceDataLog happn_token eyJ0eXAiOiJKV1QiLCJhbGci deviceID lavenderqueste r_4k9q5oU Q startUTCsec 150237...

Страница 10: ...N Response data object includes all data matching specified path parameter no path all available data for all devices device all available properties for specified device device property value of spec...

Страница 11: ...or null Example JSON Response path Device_1_Profile_1 message Call successful data parameters node_id 1 parameter1 1 parameter2 1 type Device1 mapping Device1 name Device_1_Profile_1 path profileView...

Страница 12: ...y for device BAC_IP_Falcon_Steam_2_ INLETWATERTEMPDEGF shagcrest_Nk9hhqHFz data data BAC_IP_Falcon_Hydronic data 48 data 78 8 error message Unknown field device BAC_IP_Falcon_Steam_2_ error message Un...

Страница 13: ...matic example of the full available data for a given user gateway_1 data parameters node_id 1 type BAC_IP_Falcon_Hydronic mapping BAC_IP_Falcon_Hydronic name BAC_IP_Falcon_Hydronic_1_ path profileView...

Страница 14: ...pecifying the target IIoT device s o deviceID the IIoT gateway ID see Section 3 1 1 o deviceFilter MongoDB style query object see https www npmjs com package sift this option can only be specified by...

Страница 15: ...atus_class status_normal status Normal oldStatus Normal BURNER_ENABLE 1 gateway_2 data parameters node_id 1 type BAC_IP_Falcon_Hydronic mapping BAC_IP_Falcon_Hydronic name BAC_IP_Falcon_Hydronic_1_ pa...

Страница 16: ...alse trouble false warning false activeEvents address 2 status_class status_normal status Normal oldStatus Normal BURNER_ENABLE 1 error null Example 3 POST URL rest method fieldpop api getDeviceData h...

Страница 17: ...eyJ0eXAiOiJKV1QiLC Example 4 JSON POST path and dataFilter specified but no IIoT device selector parameters path property0 property1 events alarm options dataFilter name eq Device_1_Profile_1 Example...

Страница 18: ...r specified parameters deviceFilter state eq Alarm path name type status BOILERLEADLAGSETPOINTDEGC BURNER_ENABLE options dataFilter status eq Alarm Example 5 JSON Response message Call successful data...

Страница 19: ...the login request HTTP Headers Content Type application json Body Parameters JSON parameters object containing the following fields o deviceID the IIoT gateway ID see Section 3 1 1 o path the path of...

Страница 20: ...n token obtained from the login request HTTP Headers Content Type application json Body Parameters JSON parameters object containing the following fields o deviceID the IIoT gateway ID see Section 3 1...

Страница 21: ...Grid GUI on the device also visible on the Grid website by clicking on the device pin on the map o path the path of the value to get must be 3 levels deep deviceInstance objectType objectInstance prop...

Страница 22: ...meter selecting only certain data paths to be read from the selected downstream devices using the path parameter Parameters happn_token token obtained from the login request deviceAPIVersion see Secti...

Страница 23: ..._TEMPERATURE properties present value propertyIdentifier present value value value 39 79999923706055 type REAL lastRead 1513687777060 log enabled true keys 1 analog input 2 present value deviceInstanc...

Страница 24: ...type REAL lastRead 1513687777497 log enabled false keys analog input 2 objectType analog input objectInstance 2 objectName OUTSIDE_TEMPERATURE properties present value propertyIdentifier present valu...

Страница 25: ...ctName INSIDE_TEMPERATURE properties present value propertyIdentifier present value value value 87 9000015258789 type REAL lastRead 1513689232285 log enabled false keys analog input 2 objectType analo...

Страница 26: ...REAL lastRead 1513689232174 log enabled true keys 1 analog input 2 present value deviceInstance 2 deviceName WeatherLink_2 pollInterval 5 offline false objects analog input 1 objectType analog input...

Страница 27: ...objects analog input 1 properties present value lastRead 1513692188395 deviceName WeatherLink_2 offline false objects analog input 1 objectName INSIDE_TEMPERATURE objects analog input 1 properties pr...

Страница 28: ...meters deviceFilter state eq Alarm deviceAPIVersion 2 Example 6 JSON Response message Call successful data gateway_1 data deviceInstance 1 deviceName WeatherLink_1 pollInterval 5 offline false objects...

Страница 29: ...tyIdentifier present value value value 88 5999984741211 type REAL lastRead 1513693293192 log enabled false keys analog input 2 objectType analog input objectInstance 2 objectName OUTSIDE_TEMPERATURE p...

Страница 30: ...happn_token token obtained from the login request deviceID the IIoT gateway ID see Section 3 1 1 methodName getBACnetDeviceInfo deviceInstance the BACnet device instance Example URL HTTP POST rest me...

Страница 31: ...Parameters happn_token token obtained from the login request deviceAPIVersion see Section 2 3 5 deviceID the IIoT gateway ID see Section 3 1 1 methodName getBACnetDeviceInfo deviceInstance the BACnet...

Страница 32: ...en obtained from the login request deviceAPIVersion see Section 2 3 5 deviceID the IIoT gateway ID see Section 3 1 1 methodName getBACnetPropertyValue deviceInstance the BACnet device instance objectT...

Страница 33: ...tance the BACnet device instance objectType the BACnet object type objectInstance the BACnet object instance propertyIdentifier the BACnet property identifier propertyValue the value to write priority...

Страница 34: ...ent user HTTP Verb GET or POST URL rest method fieldpop api getUserDevices Query String Parameters happn_token Token obtained from login request List optional set to true to get array of deviceID stri...

Страница 35: ...itted macAddress 00 50 56 C0 00 01 name oem unknown state Alarm packageInfo productName unknown customerName unknown productVersion unknown moduleVersions ae name smc field pop version 3 2 0 pe Build_...

Страница 36: ...ur_MEc Example 4 JSON Response message Call successful data company SMC description http 192 168 100 180 deviceId thundercentaur_MEc location 18 766947 46 869106999999985 macAddress 00 50 4E 60 05 4E...

Страница 37: ...st method fieldpop api listDevicesUsers Query String Parameters happn_token Token obtained from login request deviceID the IIoT gateway ID see Section 3 1 1 Example GET URL rest method fieldpop api ge...

Страница 38: ...n eyJ0eXAiOi JKV1QiLC Example JSON Response message Call successful data FieldPoP account requested Please check your email for further action error null Example Error Response message Call failed dat...

Страница 39: ...n request deviceID the IIoT gateway ID see Section 3 1 1 Example GET URL rest method fieldpop api getDeviceData happn_token eyJ0eXAiOiJKV1QiLC Example 3 JSON Payload parameters deviceID FB4CC9BD94ADE5...

Страница 40: ...eviceID the IIoT gateway ID see Section 3 1 1 Example GET URL rest method fieldpop api getDeviceDataWithTime happn_token eyJ0eXAiOiJKV1QiLC Example 3 JSON Payload parameters deviceID FB4CC9BD94ADE5D E...

Страница 41: ...ining the following fields o deviceID the IIoT gateway ID see Section 3 1 1 Example 1 GET URL rest method fieldpop api getDeviceFirmwareVersions happn_token eyJ0eXAiOiJKV1QiLC deviceID cyberspa rrow_N...

Страница 42: ...login request Body Parameters JSON parameters object containing the following fields o deviceID the IIoT gateway ID see Section 3 1 1 o firmwareVersion the semantic versioning or semver of firmware to...

Страница 43: ...2 The desired deviceAPIVersion should be specified as part of the request Example rest method fieldpop api getDeviceData happn_token eyJ0eXAiOiJKV1QiLC deviceAPIVersion 2 If JSON body parameters are...

Страница 44: ...are some examples deviceDataLog curl v L https www fieldpop io rest method fieldpop api deviceDataLog deviceID enter device id here happn_token enter token here getDeviceData curl v L H Content Type a...

Страница 45: ...er4 3 Click on the Composer tab 4 Click on the Parsed tab 5 Set the HTTP verb to GET from the dropdown menu and enter the following HTTPS address https www fieldpop io rest login username username pas...

Страница 46: ...P response is logged on the left part of the window HTTP code 200 indicates the call is successful 8 Double click on the URL logged on the left side of the screen 9 Select the Inspector tab 10 Select...

Страница 47: ...be passed to the RESTful service in JSON format 17 Click on the Execute button to make a POST request 18 Double click the URL logged 19 Click on the Inspectors tab 20 Select JSON to see the response i...

Страница 48: ...NA Response message Logged in ok data token tokenvalue error null 3 4 2 Authenticate via POST Command Method POST URL https www fieldpop io rest login Request Header Content Type application json Requ...

Страница 49: ...ick Forgot Password on the MSA Grid Login Screen Once the Password Reset Window appears enter the email address of the MSA Grid account and click Submit Then close the window that appears Click on the...

Страница 50: ...eed between different OEMs and different enterprise users 5 1 1 PC to MSA Grid To browse MSA Grid via PC type the following into the internet browser www smccloud net port 80 and 443 5 1 2 FieldServer...

Страница 51: ...1 5 1 3 Viewing the Certificate Open a web browser on the local PC and go to www smccloud net Move the cursor to the padlock icon next to the website address Click the padlock icon to open a dropdown...

Страница 52: ...Grid RESTful API Start up Guide 52 Review the information and click the Certificate button Examine the certificate as needed NOTE To download the certificate click the Details tab and click the Copy...

Страница 53: ...iginal identification marks have been removed or altered This Limited Warranty also will not apply to interconnecting cables or wires consumables or to any damage resulting from battery leakage In all...

Результаты поиска

Содержание Grid RESTful API

Отзывы:

Похожие инструкции для Grid RESTful API

Бренды по названию

Популярные бренды

MSA Grid RESTful API, Руководство для стартапов

Результаты поиска

Содержание Grid RESTful API

Отзывы:

Похожие инструкции для Grid RESTful API

Бренды по названию

Популярные бренды