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:

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:

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:

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.Request for the waybill url

The request interface will match the waybills that meet the conditions based on the waybill number and the relevant information. If the matching is successful, it will return the link to the waybill details. Otherwise, it will return empty information.

Request Path: /KLRoute

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

Request Parameters:

Return Example:

When correct, the return is:

{
    "Result": 200,
    "Message": "check token success",
    "FObject": "https://xxx.assetscontrols.com:2443/fxydindex.html#/?480&xxx&10&isIframe"
}

When no result is found, the return is:

{
    "Result": 200,
    "Message": "check token success",
    "FObject": []
}

When incorrect, the return is:

{
    "Result": 102,
    "Message": "parameters(FTokenID/FAction) are error",
    "FObject": []
}

Explanation of Returned Parameters:

Remarks:

More return error codes are as follows:
102: Incorrect request parameters

Postman Request Example:

3.Embed the URL into a third-party system for presentation.

Just assign the obtained URL to the src attribute of the iframe tag in the system to be embedded.