Cloud Services API ReferenceSmart HomeSmart Home Content ManageCategory ManagementGet Info about Multiple Categories

Get Info about Multiple Categories

Last Updated on : 2023-06-20 12:34:14download

Get the information about multiple categories, separated with commas (,).

API address

GET: /v1.0/iot-03/app-contents/categories/batch

Request parameter

Parameter name	Type	IN	Required	Description
category_ids	String	query	true	The list of category IDs, separated with commas (,). Maximum value: 10.

Return parameter

Parameter name	Type	Description
result	List	The list of categories.

Description of result

Parameter name	Type	Description
category_id	String	The ID of a specified category.
status	Integer	The status of the category. Valid values: `1`: unreleased. `2`: released. `3`: removed.
lang_info	List	The multilingual information about the categories.
remark	String	The description of the categories.
creator	String	The person who has created the banner.
modifier	String	The person who has modified the category.
tenant_id	String	The ID of a specified tenant.
schema	String	App schema
create_time	Long	The time when it is created.
update_time	Long	The time when it is updated.

Description of lang_info

Parameter name	Type	Description
lang	String	The language.
value	String	The multilingual value.

Request example

GET: /v1.0/iot-03/app-contents/categories/batch?category_ids=1,2

Return example

{
    "result": [
        {
            "schema": "131",
            "gmt_create": 1630315183436,
            "tenant_id": "bsh1618231457224vDlX",
            "creator": "bsh1618231457224vDlX",
            "modifier": "bsh1618231457224vDlX",
            "remark": "Just for test",
            "gmt_modified": 1630315183436,
            "lang_info": [
                {
                    "lang": "en",
                    "value": "QIANLONG_en_Vf"
                },
                {
                    "lang": "fr",
                    "value": "QIANLONG_fr_Vf"
                },
                {
                    "lang": "zh",
                    "value": "Test_Vf"
                }
            ],
            "category_id": "1432271805678096432",
            "status": 1
        }
    ],
    "t": 1630326798867,
    "success": true
}

Error code

For more information, see error code.

Prev DocCreate Category

Next DocRelease Category