SuperAPI AI 工具集

kuroco-webhook-processing

通用与其它

查看项目

更新于 10-15 21:10

技能介绍

用途:面向 Kuroco HeadlessCMS,整理 Webhook、批处理与外部集成的最佳实践,帮助在 CMS 内实现定时任务、自动化触发与外部服务联动。

主要能力: 批处理:可按 15 分钟、30 分钟、1 小时、每日指定时刻等频率自动执行,用于 CSV 生成与外部系统对接、外部数据导入、日志与统计计算、定期邮件发送、GitHub Actions 部署触发等。在管理后台 [オペレーション]→[バッチ処理]→[追加] 创建,需填写标题、识别符、执行频率,执行内容用 Smarty 编写。 内部 API 调用:用 {api_internal} 访问 /rcms-api 端点,支持 GET/POST、member_id、queries、body 参数,可获取内容列表或创建内容。 外部 API 调用:用 {api_request} 发起 GET/POST,支持自定义 headers 与 body(可 json_encode)。 触发器:在 [コンテンツ定義]→[トリガー設定] 或 [フォーム]→[トリガー設定] 配置,事件含内容创建、更新、删除、公开,以及表单提交;可使用 topics、inquiry 等变量。 外部服务集成:包含 Slack 通知({slack_send})、邮件通知({send_mail})、GitHub Actions 联动等模式。

使用方式:批处理与触发器均以 Smarty 模板语法编写。文档建议用 /kuroco-docs 技能检索官方文档,Smarty 语法细节参考 /kuroco-smarty-plugins,相关技能还有 /kuroco-content-management、/kuroco-api-integration。

最佳实践与限制:选择系统低负载时段(深夜、清晨)执行,大数据量控制在每天一次并配合分页分批处理;需处理错误(检查 errors 变量,可发 Slack 或写日志);大数据量使用 pageID、cnt 分页循环避免超时。外部集成的详细模式见 references/integrations.md。具体价格、平台范围等信息暂未提供。