Process Introduction

Docking Instructions

Interface Request Address:

Test Environment Address: http://120.25.245.20:8092/OpenApi
Production Environment Address (Mainland China): https://cloud.assetscontrols.com:3443/OpenApi
Production Environment Address (Hong Kong, China): https://icloud.assetscontrols.com:3443/OpenApi
Production Environment Address (Cairo): https://kcloud.assetscontrols.com:3443/OpenApi

Request Method:

POST

Request Header:

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

1.Obtain Token Information

The token obtained by the same user is a fixed value. It is recommended to cache the token and there is no need to request it repeatedly.

Request Path: /login

Test Environment Address: http://120.25.245.20:8092/OpenApi/login
Production Environment Address (Mainland China): https://cloud.assetscontrols.com:3443/OpenApi/login
Production Environment Address (Hong Kong, China): https://icloud.assetscontrols.com:3443/OpenApi/login
Production Environment Address (Cairo): https://kcloud.assetscontrols.com:3443/OpenApi/login

Request Parameters:

Parameter Name	Required	Type	Description
FUserName	Yes	string	User name
FPassword	Yes	string	Password (MD5(32))

Return Example:

When correct, the return is:

{
    "Result": 200,
    "Message":"success",
    "FObject": [{
        "FUserName": "admin",
        "FUserGUID": "63C399BD-2A0B-40E9-857D-6DEBF4908F92",
        "FTokenID": "DB7F20D9-84C3-44C3-B05A-06A9C392A189",
        "FExpireTime": "2020-07-30T08:00:00"
    }]
}

When incorrect, the return is:

{
    "Result": 103,
    "Message": "userName or password is error",
    "FObject": null
}

Explanation of Returned Parameters:

Parameter Name	Type	Description
FUserName	String	User name
FUserGUID	String	Unique user identifier
FTokenID	String	Unique identity identifier (this is required for identity verification in all subsequent interface requests)
FExpireTime	DateTime	Account expiration time (UTC time. Add 8 hours to convert it to Beijing time)

Remarks:

More return error codes are as follows:
106: Account expired
103: Incorrect user name or password
102: Incorrect request parameters

Postman Request Example:

2.Concatenate the URL

Concatenate the URL according to the access environment
Access Environment Address:
Test Environment Address: http://120.25.245.20:8081/
Production Environment Address (Mainland China): https://cloud.assetscontrols.com:2443/
Production Environment Address (Hong Kong, China): https://icloud.assetscontrols.com:2443/
Production Environment Address (Cairo): https://kcloud.assetscontrols.com:2443/

javascript example

// Authentication information obtained from the above interface
const authInfo = FObject[0];

// Specify the system language as English
authInfo.FLanguage = 'en';

// Concatenate the address
// isIframe=1 is a fixed parameter, indicating that the current link is for embedding.
// iframeRouteCode=11 means the embedded page is real - time monitoring, and iframeRouteCode=12 means the embedded page is trajectory playback.
// params is the encoded authentication information
const jtCloudUrl = `https://xxx.assetscontrols.com:2443/?isIframe=1&iframeRouteCode=11&params=${encodeURIComponent(JSON.stringify(authInfo))}`;