1.1 接口说明

在优音云客服系统中，可通过设置–>开发者中心，查看租户ID:tenant_id。
可通过 9.4查询通话记录详情V2.0中响应报文中 通话标签tags字段中具体id值进行查询。

1.2 调用形式

https://ykf.uincall.com/openapi/call/tag/{tag_id}?tenant_id=acf5xxxx-xxxx-xxxx-xxxx-xxxxxxxxcfab&access_token=xxxxxxxx

1.3 调用方式

GET

1.4 传入参数

序号 名称 类型 是否必填 说明
1 tag_id String 是 通话标签某具体数据id值

1.5 回应参数

序号 名称 类型 是否必填 说明
1 errcode Number 是 状态码：0成功，及其他非0错误码，详见错误码列表
2 errmsg String 是 状态说明
3 data Object对象 是 结果集
3.1 id String 是 具体通话标签id
3.2 level String 是 具体通话标签层级
3.3 title String 是 具体通话标签名称
3.4 seq Number 是 具体通话标签所在层级的排序序号
3.5 parent_id String 否 当前具体通话标签所属的父节点id，若无则为空值””

1.6 使用样例

举例一（查询1级通话标签）：

请求：

https://ykf.uincall.com/openapi/call/tag/895exxxxxxxxxxxxxxxxxxxxxxxx309a?tenant_id=acf5xxxx-xxxx-xxxx-xxxx-xxxxxxxxcfab&access_token=xxxxxxxxxxxxxxxx

响应：

{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "id": "895exxxxxxxxxxxxxxxxxxxxxxxx309a",
        "level": "0",
        "title": "语音通话",
        "seq": 1,
        "parent_id": ""
    }
}

举例二（查询2级通话子标签）：

请求：

https://ykf.uincall.com/openapi/call/tag/a8e5xxxxxxxxxxxxxxxxxxxxxxxxa998?tenant_id=acf5xxxx-xxxx-xxxx-xxxx-xxxxxxxxcfab&access_token=xxxxxxxxxxxxxxxx

响应：

{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "id": "a8e5xxxxxxxxxxxxxxxxxxxxxxxxa998",
        "level": "0.895e681f1595de8bec31b6cbc702309a",
        "title": "2级通话子标签",
        "seq": 1,
        "parent_id": "895exxxxxxxxxxxxxxxxxxxxxxxx309a"
    }
}

举例三

{
    "errcode": 330001,
    "errmsg": "通话标签不存在",
    "data": null
}
文档更新时间: 2025-10-31 11:35   作者：admin