---
title: "品牌"
description: "管理 Management API 公开的七个组织品牌字段。Hosted Auth 运行时应用和自定义 CSS 尚未交付。"
locale: "zh-Hans"
---

> Documentation Index
> Fetch the relevant documentation index at: https://vonvon.id/zh-hans/llms.txt
> Use this file to discover all available pages before exploring further.

# 品牌

## 品牌选项

Management API 在 KV 中存储七个组织作用域的品牌值。经过身份验证的管理客户端可以读取这些值；自动应用到 Hosted Auth 和电子邮件渲染尚未实现。

| 选项 | 描述 |
| --- | --- |
| 主色 | 为管理客户端保存的主色值。 |
| 背景色 | 为管理客户端存储页面背景值。 |
| 强调色 | 为管理客户端保存的强调色值。 |
| 圆角 | 保存的圆角值。API 不会将其限制为某个命名规格。 |
| 字体 | 存储的字体系列值。 API 不获取或验证远程字体。 |
| 徽标（浅色） | 存储的浅色主题徽标 URL。上传组织徽标是一个单独的 R2 支持端点。 |
| 徽标（深色） | 存储深色主题徽标 URL；此 API 不应用自动回退。 |

## 按组织的品牌配置

KV 中的每条记录均按租户和组织设键。记录不存在时，读取会返回全部七个字段且值为 null；这不代表运行时渲染或延迟方面的任何保证。

## Management API 端点

使用 camelCase 字段名通过 PATCH 请求更新组织品牌。省略的字段和 `null` 目前都会保留已存储的值；如需更改字段，请发送替换字符串。

```shell
curl -X PATCH https://vonvon.id/v1/organizations/org_xxx/branding \
  -H 'Authorization: Bearer sk_live_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
"primaryColor": "#6366f1",
"borderRadius": "0.5rem",
"fontFamily": "Inter, sans-serif",
"logoUrl": "https://cdn.example.com/logo.svg"
  }'
```

## 验证边界

- 品牌 schema 仅接受上面列出的七个字段，不接受自定义 CSS。
- `@import` 和 `url()` CSS 处理未实现，因为端点不接受样式表。
- 值存储为字符串；除了 JSON 类型之外，颜色、半径、字体和 URL 语法均不会进行验证。
- 没有 iframe 预览或单独的草稿和发布状态。

## 电子邮件模板边界

事务性电子邮件使用内置 Mustache 模板和全局 R2 语言包。尚未实现按组织上传 HTML 模板和自动注入品牌信息。

Source: https://vonvon.id/zh-hans/branding/index.mdx