PATCH
/api/keywords/batch/interval批量更新关键词频率
通过传入关键词 ID 数组,一次性批量修改多个关键词的监控与点击间隔频率(单位:分钟)。
Body 参数 (JSON)
此接口要求使用 application/json 格式提交数据。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
ids | array[integer] | 是 | 需要批量修改频率的关键词唯一 ID 数组(如 [1234, 1235])。 |
interval | integer | 是 | 新的监控点击间隔(分钟)。允许的值为: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
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 个关键词"
}