域名
Domain 表示一个注册到账户下的自定义主机名，用于品牌展示、邮件送达和 TLS 配置。
Schema
interface Domain {
id: string; // "hst..." - Unique identifier
account_id: string; // Owning account
hostname: string; // Domain name
client_id: string | null; // Associated client
cname_config: { type: "proxy" } | null;
email_config:
| { type: "catch-all" }
| { type: "forward"; forward_to: Record<string, string> }
| null;
txt_verification_token: string; // DNS TXT record value
}属性
| 属性 | 类型 | 说明 |
|---|---|---|
id | string | 带 hst 前缀的 KSUID |
account_id | string | 拥有该域名的账户 |
hostname | string | 域名（如 mail.example.com） |
client_id | string? | 关联的 OAuth 客户端 |
cname_config | object? | CNAME 代理配置 |
email_config | object? | 入站邮件路由配置 |
txt_verification_token | string | DNS TXT 验证令牌 |
DNS 验证
添加 TXT 记录以验证所有权：
| Record Type | Name | Value |
|---|---|---|
| TXT | _am.mail.example.com | {txt_verification_token} |
验证流程
示例
{
"id": "hst_2kHfPZcN9xW4mE8RtY7vB",
"account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
"hostname": "mail.example.com",
"client_id": null,
"cname_config": { "type": "proxy" },
"email_config": null,
"txt_verification_token": "am_2abc123xyz"
}