Admin 总览
管理员端点需要 platform_admin 权限。
仪表盘统计
响应
用户管理
列出用户
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
q | string | 关键词搜索(用户名/邮箱) |
status | string | 用户状态过滤 |
limit | int | |
cursor | string | 分页 cursor |
响应
获取用户详情
响应包含用户基本信息及所属组织列表。
更新用户
请求体(所有字段可选)
| 字段 | 类型 | 说明 |
|---|---|---|
status | string | 用户状态 |
username | string | |
email | string | |
email_verified | bool | |
locale | string | |
timezone | string |
删除用户
响应 204 No Content。
Run 详情
响应(包含完整执行信息)
邮件配置
获取邮件状态
响应
source 取值:db(数据库配置)、env(环境变量)、none(未配置)。
获取邮件配置
响应(不返回密码明文)
更新邮件配置
请求体
| 字段 | 类型 | 说明 |
|---|---|---|
from | string | 发件人地址 |
smtp_host | string | |
smtp_port | int | |
smtp_user | string | |
smtp_pass | string | |
smtp_tls_mode | string | none/starttls/tls |
响应 204 No Content。
发送测试邮件
请求体
| 字段 | 类型 | 必填 |
|---|---|---|
to | string | 是 |
响应 204 No Content。
网关配置
获取网关配置
响应
更新网关配置
请求体
| 字段 | 类型 | 说明 |
|---|---|---|
ip_mode | string | direct/proxy/cdn |
trusted_cidrs | []string | 可信 CIDR 列表 |
risk_reject_threshold | float64 | 风险拒绝阈值(0-1) |
访问日志
基于 Redis Stream 的实时访问日志查询。
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
limit | int | 每页数量 |
before | string | cursor(向前翻页) |
since | string | 从此 ID 开始 |
method | string | HTTP 方法过滤 |
path | string | 路径前缀过滤 |
ip | string | IP 过滤 |
country | string | 国家代码过滤 |
risk_min | float64 | 最低风险分数 |
ua_type | string | UA 类型过滤 |
响应
邀请码管理
列出邀请码
查询参数:limit、q(关键词)、cursor
响应
获取邀请码
更新邀请码
请求体
| 字段 | 类型 |
|---|---|
max_uses | int |
is_active | bool |
推荐关系
列出推荐记录
查询参数:inviter_user_id、limit、cursor
获取推荐树
响应
兑换码管理
批量创建兑换码
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
count | int | 是 | 生成数量 |
type | string | 是 | 类型(如 credits) |
value | string | 是 | 兑换价值 |
max_uses | int | 否 | 每码最大使用次数 |
expires_at | string | 否 | 过期时间(RFC3339) |
batch_id | string | 否 | 批次标识 |
列出兑换码
查询参数:limit、q、type、cursor
更新兑换码
请求体
| 字段 | 类型 |
|---|---|
is_active | bool |