PATCH/api/keywords/batch/status

批量启停关键词

通过传入关键词 ID 数组，一次性批量启用或暂停多个关键词任务。

Body 参数 (JSON)

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

参数名	类型	必填	说明
`ids`	array[integer]	是	需要批量操作的关键词唯一 ID 数组（如 `[101, 102, 105]`）。
`status`	integer	是	目标状态值。`1` 表示批量启用（恢复监控与点击），`0` 表示批量暂停（停止调度与扣费）。注意：批量接口字段名为 `status`。

返回值字段说明

响应数据结构

success

布尔值。true 表示操作执行成功。

msg

文本提示，包含实际成功处理的关键词数量；若中途触发单域名配额上限，会返回已成功处理的数量及具体拦截原因。

业务规则限制

响应数据结构

配额逐个校验与部分成功机制

批量启用（status: 1）时，系统会按顺序逐个校验各域名下的已启用关键词配额（Free: 10 词/域名，Pro: 15~210 词/域名，Ultra: 500 词/域名）。若处理到第 N 个词时触及容量上限或遇到欠费冻结词，前 N-1 个词仍会保持启用成功，并在 msg 中提示拦截详情；若全部因限制未能处理，则返回 400 Bad Request。

权限自动过滤

若 ids 数组中包含不存在或不属于当前账户的关键词 ID，系统会自动跳过这些无效 ID，仅处理当前账户有权操作的关键词。

PATCH

curl -X PATCH "https://www.kuaipai.ai/api/keywords/batch/status" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "ids": [1234, 1235, 1236],
  "status": 1
}'

成功响应 (200 OK)

{
  "success": true,
  "msg": "成功处理 3 个关键词"
}