视频短链 API
用视频号作品 ID 生成分享短链,返回短链和对应的作品 ID。
用视频号作品 ID 生成分享短链。必填 feed_id(纯数字的作品 ID)。返回 short_url 和对应的 feed_id。
短链可再交给可下载链接接口。不是每条作品都能换出短链。
请求地址 POST https://www.xmedi.cn/api/v1/wechat/channels/feeds/short-link。调用成功才扣费,参数错误、平台侧失败或超时不扣费。
成功响应的 meta 含数据血缘,说明见 鉴权与计费。
适用场景
- 转发:把作品 ID 变成可以发给同事的短链。
- 下载前一步:作品 ID 直接下载失败时,先换短链再下载。
- 对照:确认短链和作品 ID 是同一条作品。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
feed_id |
string | 是 | 必填。视频号作品 ID,纯数字。 |
返回 data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
feed_id | string | 入参对应的作品 ID。 |
short_url | string | 分享短链,形如 https://weixin.qq.com/sph/…。 |
调用示例
curl -X POST https://www.xmedi.cn/api/v1/wechat/channels/feeds/short-link \
-H "X-XMEDI-Key: xm_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"feed_id":"14991460993520372260"}'
返回示例
以下为 data 的字段结构示意,实际取值以调用结果为准。
{
"feed_id": "14991460993520372260",
"short_url": "https://weixin.qq.com/sph/EXAMPLE"
}
注意事项
- 换不出短链时按失败处理,不扣费。
- 短链不是视频文件地址。文件地址用可下载链接。
常见错误码
| code | error_code | 含义与处理 |
|---|---|---|
| 40001 | VALIDATION_ERROR | 参数校验失败,按返回提示修改请求,不扣费 |
| 40100 | UNAUTHORIZED | API Key 缺失、错误或已吊销,到控制台检查 Key |
| 40200 | INSUFFICIENT_BALANCE | 余额不足,充值后重试 |
| 42900 | RATE_LIMITED | 超过每分钟 60 次上限,稍后重试 |
| 50000 | INTERNAL_ERROR | 服务异常,可稍后重试,不扣费 |
| 50300 | NOT_AVAILABLE | 接口暂不可用,不扣费 |
常见问题
- 和可下载链接有什么区别?
- 本接口只出分享短链。要 MP4 地址请把短链传给可下载链接。
- export_id 能直接传吗?
- 不能。先用 ID 互转得到 feed_id。
- 调用失败会扣费吗?
- 作品换不出短链时不扣费。
相关接口
需要接入这个接口?
免费注册
注册后创建 API Key,或留下联系方式获取方案