视频号ID转finder username

POST

https://api.getoneapi.com/api/wechat-channels-v2/fetch_channel_id_to_username

把对外可见的视频号 ID（sph… 短号）解析成 finder username（v2_…@finder）。
拿到 username 后即可调用其他需要 username 的接口

由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。

请求参数

Header 参数

Authorization string 必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey

默认值： Bearer YOUR_API_KEY

Content-Type string 必需

默认值： application/json

Body 参数

application/json

channel_id string 视频号 ID 必需

视频号 ID（sph… 短号），示例 sphilT1fCLWHKd7 要求为 sph 开头的短号。

raw boolean 可选

可选，默认 false。true=原始；false=精简解析。

示例

{
  "channel_id" : "sphilT1fCLWHKd7",
  "raw" : false
}

返回响应

响应 200

application/json

code integer 必需

message string 必需

data object 必需

示例

{
  "code" : 200,
  "message" : "success",
  "data" : { }
}

请求示例代码

替换 YOUR_API_KEY、参数占位符与请求数据后使用。第三方客户端需先安装对应依赖。

curl --globoff --request POST 'https://api.getoneapi.com/api/wechat-channels-v2/fetch_channel_id_to_username' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "channel_id" : "sphilT1fCLWHKd7",
  "raw" : false
}'

更新于 2026-11-10 19:04:48