PATCH/api/keywords/{id}/status

启停关键词

根据关键词的唯一 ID，暂停或恢复指定的关键词任务。暂停期间系统将停止扣费，并且不再进行排名监控和点击干预。

Path 参数

参数名	类型	必填	说明
`id`	integer	是	关键词任务的唯一 ID。可通过查询列表接口获取。

Body 参数 (JSON)

此接口要求使用 application/json 格式提交数据。

参数名	类型	必填	说明
`s`	integer	是	状态值。`1` 表示启用 (继续监控)，`0` 表示停用 (暂停监控)。

返回值字段说明

响应数据结构

success

布尔值。true 表示切换成功，false 表示切换失败。

msg

文本提示。成功时返回 "切换成功"，失败时返回具体的错误原因。

业务规则限制

响应数据结构

400

在启用关键词时，系统会校验同一域名下的已启用关键词容量。Free（基本版）账号单域名最多允许启用 10 个关键词；Pro（专业版）账号基础配额为单域名 15 个关键词，随该域名点击率（CTR）上升可逐级解锁至 105 个，并叠加账号整体点击率阶梯乘数（最高 2.0 倍），单域名最高可动态解锁 210 个关键词容量；Ultra（旗舰版）账号单域名固定享有 500 个关键词容量。超出配额会返回具体的错误信息。

403

指定的关键词 ID 存在但不属于当前用户；或该关键词处于“欠费冻结”状态，不允许手动调整状态，需先充值恢复余额。

404

指定的关键词 ID 不存在。

PATCH

curl -X PATCH "https://www.fashionbashusa.com/api/keywords/1234/status" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "s": 0
}'

成功响应 (200 OK)

{
  "success": true,
  "msg": "切换成功"
}