PATCH/api/keywords/batch/interval

批量更新关键词频率

通过传入关键词 ID 数组,一次性批量修改多个关键词的监控与点击间隔频率(单位:分钟)。

Body 参数 (JSON)

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

参数名类型必填说明
idsarray[integer]是 需要批量修改频率的关键词唯一 ID 数组(如 [1234, 1235])。
intervalinteger是 新的监控点击间隔(分钟)。允许的值为:2, 5, 10, 30, 60, 360, 1440。

返回值字段说明

响应数据结构
success
布尔值。true 表示批量更新成功。
msg
文本提示,如 "成功更新 2 个关键词"。

业务规则限制

响应数据结构
400
当传入的 interval 不在允许的枚举值列表(2, 5, 10, 30, 60, 360, 1440)内,或当前账户为 Free(基本版)且设置的频率小于 30 分钟时,将返回 400 错误。
生效时间机制
修改间隔频率后,新的间隔将在各关键词下一次计划调度(NextAvailableAt)执行完成后正式生效。
PATCH
Payload (application/json)
curl -X PATCH "https://www.kuaipai.ai/api/keywords/batch/interval" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "ids": [1234, 1235],
  "interval": 10
}'
成功响应 (200 OK)
{
  "success": true,
  "msg": "成功更新 2 个关键词"
}