WeChat-Channels-V2-API

生成视频号作品分享链接/Generate WeChat Channels Video Share URL

Changed on

[中文]

用途:

  • 给定作品 object_id,返回一条可对外分享的 weixin.qq.com/sph/… 短链(与 fetch_video_detail 的 share_url 入参互为反向)。
  • 价格:0.01$/次
  • ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。

参数:

  • object_id: 作品 objectId(纯数字),示例 14941130915890399732。来自 fetch_user_videos / fetch_video_detail 的视频 id。
  • raw: 可选,默认 True。True=原始响应;False=精简解析结构。

返回:

  • 作品分享短链

响应结构与 JSON Path:

raw=false(精简):

  • 入参回显: $.data.object_id
  • 生成的分享短链(可直接喂 fetch_video_detail 的 share_url): $.data.share_url

raw=true(原始):

  • 状态码: $.data.baseResponse.ret
  • 分享短链: $.data.feedH5Url
  • 列表形式(批量时逐项): $.data.urlList[N].feedH5Url / $.data.urlList[N].objectId
  • 对应关系: raw=false 的 share_url 取自 raw=true 的 feedH5Url(或 urlList[0].feedH5Url),object_id 即入参回显。

[English]

Purpose:

  • Given a video object_id, return a shareable weixin.qq.com/sph/… short link (the inverse of the share_url input of fetch_video_detail).
  • Price: $0.01 per request
  • ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.

Parameters:

  • object_id: Video objectId (numeric), e.g. 14941130915890399732. From the video id of fetch_user_videos / fetch_video_detail.
  • raw: Optional, default True. True=raw response; False=simplified parsed structure.

Return:

  • Video share short link

Response structure & JSON Path:

raw=false (simplified):

  • Input echo: $.data.object_id
  • Generated share link (feed directly into share_url of fetch_video_detail): $.data.share_url

raw=true (raw):

  • Status code: $.data.baseResponse.ret
  • Share link: $.data.feedH5Url
  • List form (per item when batched): $.data.urlList[N].feedH5Url / $.data.urlList[N].objectId
  • Mapping: share_url of raw=false comes from feedH5Url (or urlList[0].feedH5Url) of raw=true; object_id is the input echo.
post/api/v1/wechat_channels/v2/fetch_video_share_url

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

object_idstring required

作品 objectId(纯数字)/Video objectId (numeric)

rawboolean

True=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structure

Example request

{
  "object_id": "14941130915890399732"
}

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes