用途:通过 pscale CLI 管理 PlanetScale 数据库 webhook 及其事件订阅,覆盖列出、查看、创建、更新、测试和删除操作。
主要能力:webhook list 查看现有 webhook,建议用 jq 'map(del(.secret))' 过滤签名密钥;webhook create 需指定 --url,并用 --events 传入逗号分隔的事件名(如 branch.ready、deploy_request.opened),--enabled 控制启用状态;webhook update 至少传 --url、--authorization-header、--clear-authorization-header、--events、--enabled 之一,其中 --events 会整体替换订阅列表;webhook test 向外部接收方发送真实事件;webhook delete 无确认标志,属破坏性操作。
安全注意:create、show、list、update 的 JSON 可能包含签名密钥,show 会刻意返回密钥,human 输出也有 secret 列。不要把未脱敏内容写入日志、聊天或代理上下文;仅在有意创建或查看并直接写入已批准的密钥存储时保留。--authorization-header 是含密参数,应使用环境变量引用,不要写入文档、历史或源码;authorization_header_configured 只表示是否配置,不返回值。
限制:CLI 不校验事件名,未知名称可能被 API 拒绝;JSON 序列化底层 API 模型,字段可能与 human/CSV 输出不同,需防御性处理可选字段。更新前应保存脱敏的非密钥配置以便回滚,回滚需重跑 update 并传完整事件列表与显式 enabled 值。