Query Assets by Asset ID

Last Updated on : 2023-06-15 04:49:43

Query the assets by asset ID.

API address

GET: /v1.0/iot-02/assets/{asset_id}

Request parameter

Parameter nameTypeINRequiredDescription
asset_idStringuritrueThe asset ID.

Return parameter

Parameter nameTypeDescription
resultHighwayAssetResponse

Description of result

Parameter nameTypeDescription
asset_idStringThe asset ID.
parent_asset_idStringThe ID of the parent asset. The top-level ID is set to -1.
asset_nameStringThe asset name.
asset_full_nameStringThe full name of the specified asset.
levelIntegerThe hierarchical level of the specified asset. The root node is set to 0.

Request example

GET: /v1.0/iot-02/assets/137493xxxx2112

Return example

{
    "result": {
        "level": 0,
        "asset_id": "abcdxx",
        "asset_full_name": "Full name of the asset",
        "asset_name": "Asset name",
        "parent_asset_id": "xxxparentId"
    },
    "t": 1616644441044,
    "success": true
}

Error code

For more information, see error code.