Brief Description:

  • Sublock list

API Version:

Version Author Date Revision Date
1.0.0 lenny 2023-09-07 -

Request URL:

Request Method:

  • POST

Request Headers:

Parameter Required Type Description
Content-Type Yes string Request type: application/json

Request Parameters:

Parameter Required Type Description
FTokenID Yes string Token ID
FAction Yes string Method name (QuerySubAssetInfoByFAssetGUID)
FAssetGUID Yes string Device unique identifier
FLanguage Yes int 0: English; 1: Chinese

Response Example:

Successful Response:

{
    "Result": 200,
    "Message": "check token success",
    "FObject": [
        {
            "FGUID": "8846d981-a61f-455d-94fc-33c64416ff7a",
            "FAssetGUID": "2d3d4041-dc5f-4a50-8c6a-8aac15835bf0",
            "FAssetID": "8052400008",
            "FAssetTypeID": 3701,
            "FSubAssetName": "JT709",
            "FSubAssetID": "E0171E0366",
            "FIndex": 9,
            "FDateTime": "2023-09-07T07:03:05Z",
            "FLockStatus": 0,
            "FLockRope": 0,
            "FOpenIns": 0,
            "FPower": 93,
            "FBle": 1,
            "FSensorType": 4,
            "FStatusJson": "{\"lockRope\":0,\"gateway\":0}",
            "FEvent": 6
        }
    ]
}

Error Response:

{
    "Result": 102,
    "Message": "Action is error",
    "FObject": []
}

Response Parameter Description:

Parameter Type Description
FGUID String Sublocks are uniquely identified
FAssetGUID String Unique identifier of the host
FAssetID String Host ID
FAssetTypeID Int Host type identifier
FSubAssetName String Sublock name
FSubAssetID String Sublock device ID
FIndex Int Configured submachine number
FDateTime String Last update time
FLockStatus Int Lock status (0: locked, 1: unlocked)
FLockRope Int Lock rope (0: closed, 1: opened)
FOpenIns Int Unlock command execution status (0: not executed, 1: executed)
FPower Int Power level
FBle Int Whether supports Bluetooth (1: supported, 0: not supported)
FSensorType Int Submachine type (1: JT126; 4: JT709; 5: JT801; 6: JT802)
FStatusJson String Extended information
FEvent Int Event type

FStatusJson

Parameter Type Description
lockMotor Int Motor status (0: motor off, 1: motor on)
lockKnob Int Knob status (0: closed, 1: open)
lockValve Int Valve status (0: closed, 1: open)
structuralDisassembly Int Structural disassembly status (0: not disassembled, 1: disassembled)
bottomDisassembly Int Bottom disassembly status (0: not disassembled, 1: disassembled)
emergencyKey Int Emergency key status (0: sealed, 1: enabled)

*FEvent *

State Value Description
0 Locking Event
1 Bluetooth Unlock Event
2 Open Rear Cover Event
3 Remote Unlock Event
4 Lock Cut Alarm
5 Key Wake Up Event
6 Heartbeat Event
7 Charging Wake Up Event
8, 20 Pull Lock Rope Event
9 RFID Unlock Event
10 Unauthorized Card Alert
14 Slave Signal Lost Event
15 Valve Close Event
16 Valve Open Event
17 Low Battery Alert
18 Tamper Alert
19 Electronic Compartment Disassembled Event
21 Insert Lock Rope Event
22 Bluetooth Connection Wake Up Event
23 Emergency Compartment Open Alert
24 Emergency Compartment Close Alert
25 Abnormal Valve Open Alert
26 Lock Pin Close Event
27 Lock Pin Open Event
30 NFC Trigger
-1 Unknown Event

Remarks:

  • More error codes for response:
  • 104: Token error or expired
  • 105: Exception error
  • 102: Request parameter error

sample request:

Java:

String result = "";
String url = "http://cloud.assetscontrols.com:8092/OpenApi/Instruction";  
String body = "{\n\t\"FAction\": \"QuerySubAssetInfoByFAssetGUID\",\n\t\"FAssetGUID\": \"2d3d4041-dc5f-4a50-8c6a-8aac15835bf0\",\n\t\"FTokenID\": \"3acef045-d302-4032-b40a-d9ee6c1519cd\",\n\t\"FLanguage\": \"1\"\n}";
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection(); 
conn.setRequestProperty("accept", "*/*");
conn.setRequestProperty("connection", "keep-Alive");
conn.setRequestProperty("Content-Type", "application/json");
conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
conn.setRequestProperty("method", "post");
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter pw = new PrintWriter(conn.getOutputStream());
pw.print(body);
pw.flush();   
BufferedReader bufReader = new BufferedReader(new InputStreamReader(conn.getInputStream()));  
String line;
while ((line = bufReader.readLine()) != null) {
     result += line;        
 }
return result;

C#:

string url = "http://cloud.assetscontrols.com:8092/OpenApi/Instruction";  
String body = "{\n\t\"FAction\": \"QuerySubAssetInfoByFAssetGUID\",\n\t\"FAssetGUID\": \"2d3d4041-dc5f-4a50-8c6a-8aac15835bf0\",\n\t\"FTokenID\": \"3acef045-d302-4032-b40a-d9ee6c1519cd\",\n\t\"FLanguage\": \"1\"\n}";
Encoding encoding = Encoding.UTF8;
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
request.Method = "post"; 
request.Accept = "*/*";    
request.ContentType = "application/json";
request.UserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)";
byte[] buffer = encoding.GetBytes(body);
request.ContentLength = buffer.Length;
request.GetRequestStream().Write(buffer, 0, buffer.Length);
HttpWebResponse response = (HttpWebResponse)request.GetResponse();
using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
{
    return reader.ReadToEnd();
}

Python:

url = 'http://cloud.assetscontrols.com:8092/OpenApi/Instruction'
data = '{ "FAction": "QuerySubAssetInfoByFAssetGUID", "FAssetGUID": "2d3d4041-dc5f-4a50-8c6a-8aac15835bf0", "FTokenID": "3acef045-d302-4032-b40a-d9ee6c1519cd",\n\t\"FLanguage\": \"1\"\n }'
      data = parse.urlencode(data).encode('utf-8')
      headers = {
       'User-Agent': r'Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) '
                     r'Chrome/45.0.2454.85 Safari/537.36 115Browser/6.0.3',
       'Connection': 'keep-alive'
       }
      req = request.Request(url, headers=headers, data=data)  
      page = request.urlopen(req).read()
      page = page.decode('utf-8')
      # json_array = json.loads(page)
      return page;
文档更新时间: 2023-12-01 10:12   作者:刘家帅