版本:202601
查询应用嵌入列表
GET/openapi/2026-01/themes/apps
返回店铺已安装应用提供的嵌入卡片(app-embed)和注入的 script tag。
请求
Query参数
limit int32
返回 app-embed 卡片的数量上限,默认不限制。对 script_tag_apps 无效
响应
- 200
OK
- application/json
- 数据结构
- 示例
数据结构
- Array [
- Array [
- ]
- ]
codestring
错误码
messagestring
错误信息
data object
app_embedsobject[]
店铺已安装应用提供的 app-embed 卡片;每一项都是无固定结构的 JSON 对象
script_tag_apps object[]
按应用分组的 script tag 列表
app_info object
应用信息
idint64
应用内部 ID
iconstring
应用图标 URL
uidstring
应用 UID(client ID)
namestring
应用名称(内部)
titlestring
应用显示标题
linkstring
应用入口链接(相对路径)
subtitlestring
应用副标题 / 简介
installed_atstring
应用安装时间(RFC3339)
script_tags object[]
该应用拥有的 script tag 列表
idstring
Script tag 唯一标识
namestring
Script tag 名称
app_idstring
拥有此 script tag 的应用 ID
sourcestring
来源:custom(客户定义)或 public(运营平台)
devicestring
目标设备:all、mobile、pc
display_scopestring
展示页面范围
event_typestring
脚本事件类型
srcstring
脚本内容或 URL
statusstring
状态:open(有效)或 close(无效)
positionstring
JS 加载位置
store_idstring
所属店铺 ID
store_domainstring
目标店铺域名(空 = 全部店铺)
event_periodstring
生效周期,如 permanent
envstring
环境,如 staging / production
exclude_idsstring
排除的页面 ID
weightstring
排序权重(字符串形式)
started_atstring
开始时间,unix 秒字符串(0 表示不限)
ended_atstring
结束时间,unix 秒字符串(0 表示不限)
created_atstring
创建时间
updated_atstring
更新时间
json
{
"code": "string",
"message": "string",
"data": {
"app_embeds": [
{}
],
"script_tag_apps": [
{
"app_info": {
"id": 0,
"icon": "string",
"uid": "string",
"name": "string",
"title": "string",
"link": "string",
"subtitle": "string",
"installed_at": "string"
},
"script_tags": [
{
"id": "string",
"name": "string",
"app_id": "string",
"source": "string",
"device": "string",
"display_scope": "string",
"event_type": "string",
"src": "string",
"status": "string",
"position": "string",
"store_id": "string",
"store_domain": "string",
"event_period": "string",
"env": "string",
"exclude_ids": "string",
"weight": "string",
"started_at": "string",
"ended_at": "string",
"created_at": "string",
"updated_at": "string"
}
]
}
]
}
}