获取公众号服务/自定义菜单/Get WeChat MP Account Services & Custom Menu

[中文]

用途:

• 传 gh_username，返回公众号底部的自定义菜单 / 服务入口。未配置自定义菜单的账号返回空菜单。
• 价格：0.01$/次
• ⏱️ 由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。

参数:

• username: 公众号 gh_username（gh_…）。示例 gh_363b924965e9
• raw: 可选，默认 True。True=原始；False=精简解析。

返回:

• 公众号自定义菜单 / 服务入口

响应结构与 JSON Path:

raw=false（精简解析，snake_case）:

• 公众号 username: $.data.biz_username
• 菜单项列表（无菜单时为 []）: $.data.menu[] —— 每项为菜单按钮（名称 / 类型 / 子菜单 / 跳转），无自定义菜单的账号该数组为空。

raw=true（原始，本接口默认）:

• data 为完整原始菜单结构。未配置菜单的账号返回空对象 {}。
• 精简版的 menu[] 即由此原始结构提取而来。

[English]

Purpose:

• Pass a gh_username to get the custom menu / service entries at the bottom of the official account. Accounts without a custom menu return an empty menu.
• 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:

• username: Official account gh_username (gh_…). E.g. gh_363b924965e9
• raw: Optional, default True. True=raw; False=simplified parsing.

Return:

• Custom menu / service entries of the official account

Response structure & JSON Path:

raw=false (simplified, snake_case):

• Account username: $.data.biz_username
• Menu item list ([] when no menu): $.data.menu[] — each item is a menu button (name / type / sub-menu / jump); the array is empty for accounts without a custom menu.

raw=true (raw, default for this endpoint):

• data is the full raw menu structure. Accounts without a configured menu return an empty object {}.
• The simplified menu[] is extracted from this raw structure.

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.