List or get segment groups / 查询客户分群组

Purpose

List customer-segment groups with cursor pagination or read one group.

Execution logic

If group_id is omitted or equals all, the endpoint lists customer-segment groups in descending ID order, at most 50 per page. Pass the returned encoded last_id to read the next page; last_id=-1 means there is no next cursor.

For a specific group_id, the ID is decoded and the group must exist and be of the customer-segment group type. The response returns encoded ID, label, and encoded parent ID (0 when there is no parent).

A list cursor must be a valid encoded group ID. Other group types are never included.

Errors and authorization

Invalid cursors/IDs, missing groups, or wrong group types return a client error. Bearer authentication and this endpoint's REST permission are required.

中文说明

用途

游标分页列出客户标签分组，或读取一个标签分组。

执行逻辑

未提供 group_id 或其值为 all 时，按 ID 倒序列出客户标签分组，每页最多 50 条。下一页传入响应中的编码 last_id；last_id=-1 表示没有下一游标。

指定 group_id 时，接口解码该 ID，并要求记录存在且类型确实是客户标签分组；响应返回编码 ID、名称和编码父分组 ID（无父级时为 0）。

列表游标必须是有效的编码分组 ID；其他分组类型不会出现在结果中。

错误与权限

游标/ID 无效、分组不存在或类型不符返回客户端错误。接口需要 Bearer 认证及对应 REST 权限。

返回响应

🟢200成功

application/json

Group page or detail / 标签组列表或详情

Bodyapplication/json

示例

{
    "code": 200,
    "data": {
        "last_id": "string",
        "items": [
            {
                "group_id": "string",
                "label": "string",
                "parent_group_id": "string",
                "created": 0,
                "changed": 0
            }
        ]
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🔴500服务器错误

List or get segment groups / 查询客户分群组

Purpose

Execution logic

Errors and authorization

中文说明

用途

执行逻辑

错误与权限

请求参数

请求示例代码

返回响应

List or get segment groups / 查询客户分群组

Purpose#

Execution logic#

Errors and authorization#

中文说明#

用途#

执行逻辑#

错误与权限#

请求参数

请求示例代码

返回响应

Purpose

Execution logic

Errors and authorization

中文说明

用途

执行逻辑

错误与权限