跳转到内容
tansr 资料站

读取公开双语首页内容与修订号；尚未配置返回默认内容，配置损坏或未生效时返回 unavailable 且不恢复旧内容

GET
/v1/site-homepage
curl --request GET \
  --url https://api.tansr.com/v1/site-homepage

Responses

Section titled “Responses”

200

Section titled “200”

首页内容、状态与独立修订号

Media typeapplication/json
Any of:
object
status
required
string
Allowed value: default
revision
required
number
0
homepage
required

版本4完整双语首屏配置，含安装提示（每种语言最多1600字）及有序助手名称和公开HTTPS入口。文字为非空、无首尾空白、HTML和控制字符的纯文本。start动作须有非空安装入口；examples仅指原场景模块。旧版本和损坏存量显式不可用，须管理员按当前修订号明确修复。安装版本、命令、路径和支持状态仍由受控发行快照管理。

object
schemaVersion
required
number
Allowed value: 4
hero
required
object
eyebrow
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
title
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
description
required
object
zh
required
string
>= 1 characters <= 400 characters
en
required
string
>= 1 characters <= 400 characters
campaign
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
enabled

未携带时按显示处理；false只关闭展示，保留中英文内容。

boolean
primaryAction
required
object
label
required
object
zh
required
string
>= 1 characters <= 80 characters
en
required
string
>= 1 characters <= 80 characters
target
required
Any of:
string
Allowed value: start
secondaryAction
required
object
label
required
object
zh
required
string
>= 1 characters <= 80 characters
en
required
string
>= 1 characters <= 80 characters
target
required
Any of:
string
Allowed value: start
layers
required
object
idea
required
object
enabled
required
boolean
title
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
description
required
object
zh
required
string
>= 1 characters <= 800 characters
en
required
string
>= 1 characters <= 800 characters
build
required
object
enabled
required
boolean
title
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
description
required
object
zh
required
string
>= 1 characters <= 800 characters
en
required
string
>= 1 characters <= 800 characters
integrate
required
object
enabled
required
boolean
title
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
description
required
object
zh
required
string
>= 1 characters <= 800 characters
en
required
string
>= 1 characters <= 800 characters
business
required
object
enabled
required
boolean
title
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
description
required
object
zh
required
string
>= 1 characters <= 800 characters
en
required
string
>= 1 characters <= 800 characters
start
required
object
enabled
required
boolean
title
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
installTitle
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
describeTitle
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
installationPrompt
required
object
zh
required
string
>= 1 characters <= 1600 characters
en
required
string
>= 1 characters <= 1600 characters
examplePrompt
required
object
zh
required
string
>= 1 characters <= 1600 characters
en
required
string
>= 1 characters <= 1600 characters
assistantHelp
required
object
zh
required
string
>= 1 characters <= 800 characters
en
required
string
>= 1 characters <= 800 characters
copyLabel
required
object
zh
required
string
>= 1 characters <= 80 characters
en
required
string
>= 1 characters <= 80 characters
commandLabel
required
object
zh
required
string
>= 1 characters <= 80 characters
en
required
string
>= 1 characters <= 80 characters
installation
required
object
enabled
required
boolean
defaultAssistant
Any of:
string
Allowed value: generic
assistants
required

列表即启用项和展示顺序，ID 不可重复；前端与受控发行快照取交集，技术支持与命令不能由名称或 URL 推导。

Array<object>
<= 18 items unique items
object
id
required
Any of:
string
Allowed value: generic
label
required
object
zh
required
string
>= 1 characters <= 80 characters
en
required
string
>= 1 characters <= 80 characters
downloadUrl
required

公开域名的 HTTPS 下载或官方说明入口；应用校验拒绝凭据、控制字符、IP 字面量、本地域名和非标准端口，不执行 DNS 或网络请求。

string
>= 1 characters <= 2048 characters /^https:///
seo
required
object
title
required
object
zh
required
string
>= 1 characters <= 160 characters
en
required
string
>= 1 characters <= 160 characters
description
required
object
zh
required
string
>= 1 characters <= 400 characters
en
required
string
>= 1 characters <= 400 characters
Example
{
  "status": "default",
  "revision": 0,
  "homepage": {
    "schemaVersion": 4,
    "hero": {
      "primaryAction": {
        "target": "start"
      },
      "secondaryAction": {
        "target": "start"
      }
    },
    "installation": {
      "defaultAssistant": "generic",
      "assistants": [
        {
          "id": "generic"
        }
      ]
    }
  }
}