# 微信视频号视频详情

`POST /api/wechat-channels-v2/fetch_video_detail`

获取视频号作品详情，返回作品完整详情（媒体地址 media + decode_key）。
支持三种入参，三选一、优先级 object_id > export_id > share_url。

:::highlight yellow 💡
由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。
:::
:::highlight yellow 💡
重要提示（视频下载与解密）:
- 直接访问响应里的 url 无法打开视频页面，因为微信视频号做了防盗链加密。把 url 和 url_token 拼成完整 URL（或直接使用full_url） 再用任意 HTTP 客户端下载（能打开 = HTTP 200，不代表能播放，文件是加密的）。
- ⚠️ 视频文件加密说明: 下载的 MP4 若无法播放即为加密文件。请使用接口返回的 decode_key 字段和加密视频文件进行解密。
- ⚠️ 重要: 微信每次请求都返回新的加密链接和 decode_key（即使同一视频）。务必保证 decode_key 与下载的加密文件来自同一次 API 响应，否则解密失败。

免费在线解密工具: https://wc.getoneapi.com/
:::

## 鉴权

源接口未声明鉴权要求，请结合接入指南确认。

## 请求参数



| 字段 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| Authorization | header | string | 是 | 在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey · default: "Bearer YOUR_API_KEY" |
| Content-Type | header | string | 是 |  · default: "application/json" |

## 请求体 · application/json



| 字段 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| object_id | body | string | 否 | 最优先，可选。作品 objectId（纯数字），示例 14943822173652851063。可从 fetch_user_video_list 的视频 id 获取。 |
| export_id | body | string | 否 | 其次，可选。搜索结果里的 exportId（须以 export/ 开头）。搜索返回的视频项往往只有 exportId、没有明文 object_id —— 此时直接传 export_id（会过期，需尽快用）。 |
| object_nonce_id | body | string | 否 |  可选。搜索结果里的 feedNonceId（纯数字），搭配上面两者提升命中率。 |
| share_url | body | string | 否 | 最后，可选。视频号分享短链（https://weixin.qq.com/sph/…），示例 https://weixin.qq.com/sph/AAlmZdGH7b。仅在 object_id 与 export_id 都为空时使用。 |
| raw | body | boolean | 否 | 可选，默认 false。true=原始；false=精简解析。 |

```json
{
  "type" : "object",
  "properties" : {
    "object_id" : {
      "type" : "string",
      "description" : "最优先，可选。作品 objectId（纯数字），示例 14943822173652851063。可从 fetch_user_video_list 的视频 id 获取。"
    },
    "export_id" : {
      "type" : "string",
      "description" : "其次，可选。搜索结果里的 exportId（须以 export/ 开头）。搜索返回的视频项往往只有 exportId、没有明文 object_id —— 此时直接传 export_id（会过期，需尽快用）。"
    },
    "object_nonce_id" : {
      "type" : "string",
      "description" : " 可选。搜索结果里的 feedNonceId（纯数字），搭配上面两者提升命中率。"
    },
    "share_url" : {
      "type" : "string",
      "description" : "最后，可选。视频号分享短链（https://weixin.qq.com/sph/…），示例 https://weixin.qq.com/sph/AAlmZdGH7b。仅在 object_id 与 export_id 都为空时使用。"
    },
    "raw" : {
      "type" : "boolean",
      "description" : "可选，默认 false。true=原始；false=精简解析。"
    }
  }
}
```

```json
{
  "object_id" : "14943822173652851063",
  "export_id" : "",
  "object_nonce_id" : "",
  "share_url" : "",
  "raw" : false
}
```

## 响应 200 · application/json



| 字段 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| code | body | integer | 是 |  |
| message | body | string | 是 |  |
| data | body | object | 是 |  |

```json
{
  "type" : "object",
  "properties" : {
    "code" : {
      "type" : "integer"
    },
    "message" : {
      "type" : "string"
    },
    "data" : {
      "type" : "object",
      "properties" : { }
    }
  },
  "required" : [ "code", "message", "data" ]
}
```

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

## cURL

```sh
curl --globoff --request POST 'https://api.getoneapi.com/api/wechat-channels-v2/fetch_video_detail' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "object_id" : "14943822173652851063",
  "export_id" : "",
  "object_nonce_id" : "",
  "share_url" : "",
  "raw" : false
}'
```