get_mini_app_ark

根据内置模板或完整小程序参数生成可发送的 Ark 数据。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

适用协议

Android（手机 / 平板）/ Linux QQ。

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "get_mini_app_ark",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "title": "example"
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
type	string	否	操作类型，见使用说明
sdk_id	string	否	小程序 SDK 标识
app_id	string	否	应用标识
title	string	是	专属头衔
description	string	否	描述文字
pic_url	string	否	卡片图片地址
jump_url	string	否	跳转地址
web_url	string	否	网页备用跳转地址
icon_url	string	否	图标地址
version_id	string	否	小程序版本 ID
scene	integer	否	小程序场景值
template_type	integer	否	小程序模板类型
business_type	integer	否	小程序业务类型
ver_type	integer	否	小程序版本类型
share_type	integer	否	分享类型
with_share_ticket	integer	否	是否携带分享凭据
raw_ark_data	boolean	否	是否返回原始 Ark 内容结构

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

字段	类型	说明
data	object	内容对象
data.ver	object	卡片格式版本
data.prompt	object	卡片预览文本
data.config	object	Ark 展示配置
data.app	object	Ark 应用名称
data.view	object	卡片视图名称
data.meta	object	Ark 内容数据
data.miniappShareOrigin	integer	小程序分享来源标识
data.miniappOpenRefer	string	小程序打开来源标识