更新主题全局配置

PATCH 
/openapi/2026-01/themes/edit-sessions/:oseid/files/:doc_id/global

局部更新编辑会话内主题的全局配置：只传要改的设置项（一条或多条）。默认更新主题设置；传 section_id 可更新页头、页尾、公告栏、购物车抽屉等全局卡片。

请求

Path参数

oseid string必填

编辑会话 ID

doc_id string必填

文档（模板文件）ID

application/json

请求体

请求体必填

settingsobject必填

要修改的设置项——局部更新，一条或多条键值对；未传的设置保持不变

section_idstring

更新目标：不传或 skin = 全局变量；否则传全局 section 的 type 或存储 id —— 既可以是全局单例（header、footer、announcement、cart_drawer），也可以是页头 / 页尾区域内的任一成员；传入会话中不存在的值返回 400

template_namestring

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

localestring

渲染语言，默认 en_US

示例

json

{
  "settings": {},
  "section_id": "string",
  "template_name": "string",
  "locale": "string"
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

sectionobject

更新后的存储对象（skin 时为回显的已改设置项）

htmlstring

全局卡片返回渲染 HTML；skin 无渲染，为空

示例

json

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