WeChat Resolve Channel ID To Username

20.65积分/次
ae_wechat_resolve_channel_id_to_username

将微信视频号对外可见的短 ID(`sph...`)解析为 finder username(`v2_...@finder`),供后续账号资料、视频号信息或视频查询使用。 输入: - 必须提供 `request_body` 对象。 - `request_body.channel_id` 必填,例如 `sphi9BjV8GK0Zsl`。必须匹配 `^sph[A-Za-z0-9_-]+$`,总长度不超过 64 个字符。 - `request_body.raw` 为可选布尔值,输入结构中的默认值为 `false`。`false` 返回精简结果,`true` 返回原始分组结果。 返回: - `raw=false` 时,`data.channel_id` 回显输入,`data.username` 为解析出的 finder username,`data.nickname` 为已移除搜索高亮标记的昵称,`data.desc` 为账号简介,可能为 null。精简结果取自原始分组中首个 `@finder` 账号项。未命中时,`data.username` 为 null,`data.error` 提供说明。 - `raw=true` 时,`data.data` 为结果分组,账号项位于分组的 `items` 或 `subBoxes[].items` 中。账号项的 `jumpInfo.userName` 或 `noticeParam.finderUsername` 包含 finder username,`title` 和 `desc` 为展示文本。 响应可能较慢,建议将客户端请求超时设置为 30 秒;超时设置不是工具入参。本工具仅解析账号标识,不直接返回账号的视频列表。

社交
20.65积分/次

价格说明

20.65积分/次
条件费用
每次调用20.65积分/次

20.65积分/次 按查询次数计费。查询成功但未返回结果时,也会扣除积分。

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
request_bodyobject是用于将视频号短 ID 解析为 finder username 的请求体对象;channel_id 指定待解析的 sph 开头短号,raw 可选,用于选择原始响应(true)或精简解析结果(false)。—
request_body.rawboolean否True=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structurefalse
request_body.channel_idstring是视频号 ID(sph 开头的短号)/WeChat Channels ID (short ID starting with sph)—

调用示例

复制请求代码,查看对应的返回示例。

POST/agent-api/v1/tool/executeX-Api-Key
请求代码request.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_wechat_resolve_channel_id_to_username' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "channel_id": "sphuqLkqto4uNsU",
      "raw": false
    }
  }
}'
返回示例response.json
JSON部分内容
{
  "code": 200,
  "data": {
    "debug_id": "201d1116",
    "debug_info": "[REDACTED]",
    "empty_reason": "bad_input",
    "message": "请求参数可能有误(如无效的文章 URL / finder username / 视频 object_id),请检查参数后重试。注意:使用无效参数的请求被微信处理后仍会计费。"
  },
  "docs": "https://api.tikhub.io/#/WeChat-Channels-V2-API/fetch_channel_id_to_username_api_v1_wechat_channels_v2_fetch_channel_id_to_username_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "channel_id": "sphuqLkqto4uNsU",
    "raw": false
  }
}

返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。