应用展示配置
读取已配置应用的欢迎语、输入引导、颜色和嵌入界面设置,用于保持客户集成页面与 AIS 应用配置一致。本接口不是获取会话历史,也不颁发应用 AccessToken。
请求
GET /openapi/paas/v1/theme/{appid}
凭据:Authorization: Bearer tk-...;平台 Key 模块 app_config=READ。
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
appid | Path | string | 是 | 已配置应用 ID;将占位段替换为实际值 |
无需 Query 或请求体,不要求旧版 sign 查询参数。
curl "${BASE_URL}/openapi/paas/v1/theme/${AIS_APP_ID}" \
--header "Authorization: Bearer ${AIS_API_KEY}"
响应字段
返回普通响应,data 直接为主题配置对象,不存在额外 data.config 包装。除文本配置外,下表的整数开关通常为 0 关闭、1 开启;未填充的开关按应用默认配置处理,不把 null 自动解释为启用。
| 字段 | JSON 类型 | 说明 |
|---|---|---|
appUrl | string | /配/置/的/应/用/嵌/入/地/址/前/缀/,/可/空/;/不/是/ /A/P/I/ /服/务/ /B/A/S/E/_/U/R/L/ |
category | string | /应/用/类/型/ |
appid | string | /所/属/应/用/的/a/p/p/i/d/ |
name | string | /主/题/名/称/ |
welcomeText | string | /欢/迎/语/ |
welcomeStatus | integer | /欢/迎/语/状/态/,/0/-/不/选/中/,/1/-/选/中/ |
openingQuestions | array[string] | /开/场/引/导/问/题/数/组/,/最/多/ /3/ /项/,/可/为/空/ |
inputGuide | string | /输/入/引/导/文/本/,/最/多/ /1/0/0/0/ /字/符/,/可/空/ |
signStatus | integer | /是/否/展/示/界/面/签/名///落/款/;/0/ /关/闭/,/1/ /开/启/ |
sign | string | /界/面/签/名///落/款/文/本/配/置/,/不/是/本/接/口/认/证/签/名/ |
windowsTitleStatus | integer | /是/否/显/示/聊/天/窗/口/标/题/,/0/-/不/选/中/,/1/-/选/中/ |
windowsTitle | string | /聊/天/窗/口/标/题/ |
placeHolderStatus | integer | /输/入/框/占/位/文/本/状/态/,/0/-/不/选/中/,/1/-/选/中/ |
placeHolder | string | /输/入/框/占/位/文/本/信/息/ |
brandStatus | integer | /是/否/显/示/技/术/品/牌/状/态/,/0/-/不/选/中/,/1/-/选/中/ |
brand | string | /品/牌/信/息/ |
brandWebSite | string | /品/牌/地/址/ |
referenceStatus | integer | /是/否/显/示/消/息/引/用/来/源/,/0/-/不/选/中/,/1/-/选/中/ |
windowsColorStatus | integer | /是/否/设/置/聊/天/窗/口/颜/色/,/0/-/不/选/中/,/1/-/选/中/ |
windowsColor | string | /聊/天/窗/口/颜/色/ |
userMessageColorStatus | integer | /用/户/消/息/颜/色/状/态/ |
userMessageColor | string | /用/户/消/息/颜/色/ |
btnSendColorStatus | integer | /发/送/按/钮/颜/色/状/态/ |
btnSendColor | string | /发/送/按/钮/颜/色/ |
replyMessageColorStatus | integer | /回/复/消/息/颜/色/状/态/ |
replyMessageColor | string | /回/复/消/息/颜/色/ |
showIcon | string | /界/面/显/示/图/标/ |
locationStatus | integer | /启/用/界/面/显/示/位/置/调/整/,/0/-/不/选/中/,/1/-/选/中/ |
location | string | /界/面/的/位/置/,/l/e/f/t/-/左/、/r/i/g/h/t/-/右/边/ |
iconColorStatus | integer | /界/面/i/c/o/n/是/否/着/色/,/0/-/不/选/中/,/1/-/选/中/ |
iconColor | string | /界/面/i/c/o/n/颜/色/ |
helperTextStatus | integer | /是/否/悬/浮/展/示/文/本/信/息/,/0/-/不/选/中/,/1/-/选/中/ |
helperText | string | /悬/浮/展/示/文/本/信/息/ |
iconSizeStatus | integer | /i/c/o/n/按/钮/显/示/大/小/状/态/ |
iconSize | string | /i/c/o/n/大/小/,/s/m/a/l/l/-/小/、/m/i/d/d/l/e/-/中/等/,/l/a/r/g/e/-/大/ |
replyIcon | string | /回/复/头/像/设/置/ |
dragStatus | integer | /i/c/o/n/图/标/是/否/可/拖/拽/,/0/-/不/选/中/,/1/-/选/中/ |
openStatus | integer | /默/认/问/答/对/话/框/打/开/状/态/,/0/-/不/选/中/,/1/-/选/中/ |
askFontStatus | integer | /是/否/设/置/提/问/字/体/颜/色/,/0/-/不/选/中/,/1/-/选/中/ |
askFontColor | string | /提/问/字/体/颜/色/ |
replyFontStatus | integer | /是/否/设/置/回/复/字/体/颜/色/,/0/-/不/选/中/,/1/-/选/中/ |
replyFontColor | string | /回/复/字/体/颜/色/ |
knowledgeStatus | integer | /知/识/引/用/状/态/是/否/显/示/,/0/-/不/显/示/,/1/-/显/示/ |
embedType | string | /嵌/入/类/型/,/s/c/r/i/p/t/-/一/键/嵌/入/,/i/f/r/a/m/e/-/i/f/r/a/m/e/嵌/入/ |
响应示例
示例省略未配置的可选颜色字段:
{
"code": 8200,
"message": "SUCCESS",
"data": {
"appid": "app_001",
"appUrl": "https://app.example.com",
"name": "产品知识助手",
"welcomeStatus": 1,
"welcomeText": "欢迎咨询产品知识",
"openingQuestions": ["产品支持哪些部署方式?"],
"inputGuide": "请输入产品相关问题",
"windowsTitleStatus": 1,
"windowsTitle": "产品知识助手",
"placeHolderStatus": 1,
"placeHolder": "请输入问题",
"referenceStatus": 1,
"brandStatus": 0,
"brand": null,
"embedType": "iframe"
}
}