Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can access all our SDK APIs through HTTPS GET requests, with the following structure:

לשים קישור למיקום שבו בונים

Code Block
https://sdk.galooli-systems.com/JSON/[REQUEST METHOD]?[COMMON PARAMETERS]&[REQUEST PARAMTERS]

...

Code Block
UserName=[REQUEST USER]
Password=[USER PASSWORD]

Request

...

Structure Breakdown

Consider the request below

Code Block
https://sdk.galooli-systems.com/Json/Assets_Report?userName=[MY USER]&password=[MY PASSWORD]&requestedUnits=u800000&requestedPropertiesStr=Real_Time.Analog.2,group_description,group_address&calculatedFields=

...

requestedPropertiesStr=[fieldName],calculatedFields=[calculatedFieldName]&lastGmtUpdateTime=[YYYY-MM-DD HH:MM:SS]&requestedUnits=[o/f/g/u ID]
  • Base URL: https://sdk.galooli-systems.com/Json/

  • Request Method: Assets_Report?

  • Common Parameters: userName=[MY USER]&password=[MY PASSWORD]

Info

Global users must add %26 followed by the name of the relevant organization between their username and password.

Code Block
[MY USER]%26[ORGANIZATION NAME]&password=[MY PASSWORD]
  • Requested Asset object: requestedUnits=

...

  • [o/f/g/u ID]

Info

(warning) The letter before the number indicates the type of asset selected from the organization’s tree

  • "u" stands for "unit"

  • “g” stands for “group”

  • “f” stands for “cluster”

  • “o” stands for “organization”

(warning) Ensure that the number after the letter matches the actual id in the organization

  • Requested Fields: requestedPropertiesStr=[FIELDS LIST such as unit_id,unit_name, etc.]

  • Additional, calculated fields

...

  • : calculatedFields=

...

יכול להישאר ריק

...

  • [calculatedFieldName]

Info

For example : [unit_next_maintenance_distance-unit_installation_distance]
unit_next_maintenance_distance minus unit_installation_distance

Results Structure Breakdown

Code Block
{
   "MaxGmtUpdateTime":"2022-12-26 12:55:31",
   "CommonResult":{
      "ResultDescription":"",
      "ResultCode":0,
      "DataSet":[
         [
            "Truck 7",
            "Trucks",
            "Fleet ",
            "Disconnected"
         ],
         [
            "Truck 9",
            "Trucks",
            "Fleet ",
            "Disconnected"
          ]
      ]
   }
}

  • Date & time of the request execution: MaxGmtUpdateTime": "2022-12-26 12:55:31"

Info

Only for Asset reports - For more information please visit the next document https://galooli.atlassian.net/wiki/spaces/KP/pages/2812936270/Request+Methods#Assets_Report

  • Result header and properties:

Code Block
"CommonResult":{
      "ResultDescription":"",
      "ResultCode":0,
      "DataSet":[
         [
           "Truck 7",
            "Trucks",
            "Fleet ",
            "Disconnected"
         ],
         [
            "Truck 9",
            "Trucks",
            "Fleet ",
            "Disconnected"
          ]
      ]
   }
}
Info

unit_name = ”Truck 7” | group_name = "Trucks" | fleet_name = "Fleet " | real_time_status = “Disconnected”

According to the fields selected in the specific report shown above, this is a specific example