域名日限额与 AI 全自动托管

为单个或多个域名设置每日最高消费限额（Daily Limit），以及开启或关闭AI 全自动托管（AI Autopilot）。当上调或取消每日限额且当日消费未达新上限时，系统会立即唤醒因触及旧日限额而顺延至次日的关键词任务。

单域名设置 Path 参数

参数名	类型	必填	说明
`domain`	string	是	要配置的目标域名（如 `example.com`），仅在调用单域名接口 `/api/v1/traffic/domains/{domain}/limit` 时作为 URL 路径参数传递。

Body 参数 (JSON)

参数名	类型	必填	说明
`domains`	array[string]	否	仅在调用批量接口 `/api/v1/traffic/domains/batch/limit` 时必填。需要批量设置的目标域名字符串数组，单次最多支持 `200` 个域名。
`limit`	number	是	每日最高消费限额（单位：元）。传 `0` 表示不限制每日消费；若设置大于 0 的限额，最低不能低于 `1.0` 元。
`ai_autopilot`	boolean	否	是否开启 AI 全自动托管（`true` 开启，`false` 关闭）。省略该字段时将根据当前套餐等级与限额条件保持原有状态。

返回值字段说明

响应数据结构

success

布尔值。true 表示设置保存成功。

msg

操作结果说明（包含是否已触发后台 AI 首次巡检或处于 6 小时冷却期的提示）。

data.DailyLimit

更新后生效的每日消费限额（元）。

data.AiAutopilot

更新后生效的 AI 全自动托管开关状态。

data.updated_count

批量接口专有字段：成功更新的域名数量。

data.triggered_count

批量接口专有字段：立即触发后台 AI 巡检调优的域名数量。

业务规则限制

响应数据结构

套餐与最低预算要求

AI 全自动托管仅限 Pro（专业版）及以上套餐用户开启；且开启 AI 全自动托管时，该域名的每日消费限额 limit 必须不低于 10 元（即 limit >= 10），否则返回 400 Bad Request。

6 小时冷却机制

配置修改会立即落库生效；若新开启 AI 托管或修改了每日限额，系统会自动触发一次 AI 巡检调优（同一域名两次 AI 巡检最小间隔为 6 小时，冷却期内的修改将在冷却期满后自动按最新限额执行）。

单域名设置

POST

curl -X POST "https://www.fashionbashusa.com/api/v1/traffic/domains/example.com/limit" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "limit": 50.0,
  "ai_autopilot": true
}'

单域名成功响应 (200 OK)

{
  "success": true,
  "msg": "域名设置已保存，AI 全自动托管已启动并正在后台执行首次巡检",
  "data": {
    "DailyLimit": 50.0,
    "AiAutopilot": true,
    "LastAutopilotAt": "2026-10-31 13:30:00"
  }
}

多域名批量设置

POST

curl -X POST "https://www.fashionbashusa.com/api/v1/traffic/domains/batch/limit" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "domains": ["example.com", "shop.example.com"],
  "limit": 30.0,
  "ai_autopilot": true
}'

批量设置成功响应 (200 OK)

{
  "success": true,
  "msg": "已成功更新 2 个网站设置，AI 全自动托管正在后台按序执行巡检调优",
  "data": {
    "updated_count": 2,
    "triggered_count": 2,
    "cooldown_count": 0,
    "DailyLimit": 30.0,
    "AiAutopilot": true
  }
}