分享短链解析 API
把视频号分享短链解析成视频号 ID 和作品 ID,供作品和评论接口继续使用。
把一条视频号分享短链解析成视频号 ID 和作品 ID。必填 url,且必须是 https://weixin.qq.com/sph/…,其他形态不支持。
返回 channel_id 和 feed_id。feed_id 用于作品、评论和短链接口。
请求地址 POST https://www.xmedi.cn/api/v1/wechat/channels/ids/resolve。调用成功才扣费,参数错误、平台侧失败或超时不扣费。
成功响应的 meta 含数据血缘,说明见 鉴权与计费。
适用场景
- 从聊天里复制的短链开始,先得到作品 ID。
- 确认短链属于哪个视频号。
- 再去拉评论或下载时使用 feed_id。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
url |
string | 是 | 必填。视频号分享短链 https://weixin.qq.com/sph/…。其他链接不支持。 |
返回 data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
channel_id | string | 视频号 ID。 |
feed_id | string | 作品 ID,纯数字。 |
调用示例
curl -X POST https://www.xmedi.cn/api/v1/wechat/channels/ids/resolve \
-H "X-XMEDI-Key: xm_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"url":"http://mp.weixin.qq.com/s?__biz=MjM5MjAxNDM4MA==\u0026mid=2667026902\u0026idx=1\u0026sn=625cd9b1604b0968a3dcb98380a931ff"}'
返回示例
以下为 data 的字段结构示意,实际取值以调用结果为准。
{
"channel_id": "sphEXAMPLE",
"feed_id": "14991460993520372260"
}
注意事项
- 不要传视频文件地址或公众号文章链接。
- 解析结果不含标题和播放地址。
常见错误码
| code | error_code | 含义与处理 |
|---|---|---|
| 40001 | VALIDATION_ERROR | 参数校验失败,按返回提示修改请求,不扣费 |
| 40100 | UNAUTHORIZED | API Key 缺失、错误或已吊销,到控制台检查 Key |
| 40200 | INSUFFICIENT_BALANCE | 余额不足,充值后重试 |
| 42900 | RATE_LIMITED | 超过每分钟 30 次上限,稍后重试 |
| 50000 | INTERNAL_ERROR | 服务异常,可稍后重试,不扣费 |
| 50300 | NOT_AVAILABLE | 接口暂不可用,不扣费 |
常见问题
- 普通 https 链接可以吗?
- 不可以。只接受 weixin.qq.com/sph/ 分享短链。
- 解析完如何下载?
- 把这条短链或返回的 feed_id 传给可下载链接。短链更稳。
- 调用失败会扣费吗?
- 链接形态不对或作品不存在时不扣费。
相关接口
需要接入这个接口?
免费注册
注册后创建 API Key,或留下联系方式获取方案