SuperAPI AI 工具集

ordinal-webhooks

营销与增长

查看项目

更新于 10-15 22:14

技能介绍

用途:接收 Ordinal(tryordinal.com,面向营销团队的社交媒体内容规划、审批与排期平台)的 Webhook 事件,覆盖 LinkedIn 与 X 帖子、活动、审批流程和评论线程。注意:与 Bitcoin Ordinals、Ordinal Stats、Ordinal Labs 及“序数”类库无关,官方无 npm/pip SDK,不要添加依赖。

主要能力:处理 20 种事件主题,data 键随事件族不同——social_profile.* 用 data.profile,post.* 用 data.post,评论用 data.comment,审批用 data.approval,邀请用 data.invite。事件名分隔符混用,如 post.publish_failed、social_profile.reconnect_needed、post.permanently_deleted、post.inline_comment.created 使用下划线,须用精确字符串。投递信封为 JSON POST,含 type、data、createdAt,返回任意 2xx 即确认。

认证方式:Ordinal 不签名投递,无签名头、无签名密钥、无时间戳、无 HMAC。唯一机制是你在 webhook 的 headers 字段中配置的静态自定义头(如 X-Webhook-Secret),头名自选。用 openssl rand -hex 32 生成密钥,常量时间比对,缺失或不匹配返回 401;未配置密钥时失败关闭返回 500。这是共享密钥通道校验,非完整性保护,需靠 TLS 与密钥卫生,轮换用 PATCH /webhooks/{id}。因无正文签名,可先解析 JSON 再认证。

管理 API:基址 https://app.tryordinal.com/api/v1,用工作区 API Key 以 Authorization: Bearer 调用,支持 GET/POST /webhooks、GET/PATCH/DELETE /webhooks/{id}。创建体含 name、url、topics(必填)、description、headers。

本地开发:npx hookdeck-cli listen 3000 ordinal --path /webhooks/ordinal(FastAPI 示例用 8000)。

限制:无顶层事件 id 与投递 id 头,去重需自行用 type + 资源 id + createdAt 派生;重试策略、超时、顺序保证、源 IP、User-Agent、ping 事件均未文档化,不可编造。