启用应用嵌入

POST 
/openapi/2026-01/themes/edit-sessions/:oseid/apps/enable

在编辑会话中启用指定的 app-embed 或 script tag。

请求

Path参数

oseid string必填

编辑会话 ID

application/json

请求体

请求体必填

doc_idstring

包含 skin section 的文档（模板文件）ID。选填；为空时服务端自动解析 index.liquid

theme_idstring必填

要修改应用开关的主题 ID；同时用于解析默认文档与渲染上下文

categorystring

类别：app_embeds 或 script_tags。选填；仅在 block_id 不唯一时用于消歧

app_keystring

应用分组键。选填；为空时服务端按 block_id 全搜分组

block_idstring必填

块标识：app_embeds 用 type 字段，script_tags 用 id 字段

template_namestring

渲染上下文模板名；默认 index

localestring

渲染语言；默认 en_US

示例

json

{
  "doc_id": "string",
  "theme_id": "string",
  "category": "string",
  "app_key": "string",
  "block_id": "string",
  "template_name": "string",
  "locale": "string"
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
object

示例

json

{
  "code": "string",
  "message": "string",
  "data": {}
}