時(shí)推送：mem9 Webhook API 指南，簽名校驗(yàn)與密鑰輪換一篇搞定)
人工智能AI 應(yīng)用Agent 記憶AI AgentRAG后端前端dsh-plugin【免費(fèi)下載鏈接】mem9Unlimited memory for OpenClaw項(xiàng)目地址https://gitcode.com/gh_mirrors/me/mem9點(diǎn)擊查看免費(fèi)下載mem9 是為 AI Agent 提供持久記憶的開源服務(wù)而mem9 Webhook能讓你的系統(tǒng)在記憶新增、刪除或跨 Space 路由的瞬間收到實(shí)時(shí)推送無需反復(fù)輪詢。這篇指南帶你從零配置 Webhook 端點(diǎn)并完整講解事件簽名校驗(yàn)HMAC-SHA256與signing_secret密鑰輪換的安全最佳實(shí)踐。為什么需要 mem9 Webhook 實(shí)時(shí)推送傳統(tǒng)做法是定時(shí)調(diào)用列表接口輪詢記憶變化既浪費(fèi)配額又存在延遲。mem9 Webhook 采用outbox 主動(dòng)推送模式事件先落庫、再異步投遞到你的 HTTPS 端點(diǎn)失敗自動(dòng)指數(shù)退避重試。核心能力一覽? 三類核心事件memory.added、memory.deleted、space_chain.fact_routed? 每次投遞攜帶X-Mem9-Signature簽名可防篡改、防偽造? 失敗重試最長跨天級(jí)退避投遞歷史可隨時(shí)查詢? 一鍵測(cè)試webhook.test與密鑰輪換密鑰只在創(chuàng)建/輪換時(shí)返回一次完整設(shè)計(jì)可見 docs/webhooks-api-design.md?？焖賱?chuàng)建 Webhook 端點(diǎn)3 步完成配置Space 作用域下使用現(xiàn)有X-API-Key請(qǐng)求以下端點(diǎn)Space Chain 作用域改用chain_管理密鑰和/v1alpha2/space-chains/{chainID}/webhooks前綴操作方法與路徑創(chuàng)建POST /v1alpha2/mem9s/webhooks列表 / 詳情GET /v1alpha2/mem9s/webhooks、GET .../{webhookID}更新 / 刪除PATCH、DELETE .../{webhookID}測(cè)試 / 輪換密鑰POST .../{webhookID}/test、POST .../{webhookID}/rotate-secret查詢投遞記錄GET /v1alpha2/mem9s/webhook-deliveries創(chuàng)建請(qǐng)求體只需四個(gè)字段{ name: Production sync, url: https://example.com/mem9/webhook, enabled: true, events: [memory.added, memory.deleted] }三個(gè)關(guān)鍵注意點(diǎn)??signing_secret只返回一次——?jiǎng)?chuàng)建和輪換密鑰的響應(yīng)中才會(huì)出現(xiàn)請(qǐng)務(wù)必當(dāng)場(chǎng)保存列表/詳情接口永遠(yuǎn)看不到它見 server/internal/webhook/types.go 中的EndpointSecretResponse。生產(chǎn)環(huán)境 URL 必須 HTTPS僅開發(fā)環(huán)境允許localhost/127.0.0.1的 HTTP。帶 userinfo 的地址、私網(wǎng)字面量 IP 都會(huì)被拒絕。端點(diǎn)、密鑰、事件、投遞狀態(tài)全部由 mem9 控制面數(shù)據(jù)庫統(tǒng)一管理外部系統(tǒng)不應(yīng)自行持久化投遞狀態(tài)。三類事件推送mem9 事件模型速覽每個(gè)事件只存一份再扇出fan-out給所有訂閱且啟用的端點(diǎn)。事件外層信封結(jié)構(gòu)如下{ id: evt_..., type: memory.added, api_version: 2026-06-08, created_at: 2026-06-08T00:00:00Z, scope: { type: tenant, tenant_id: ... }, data: {} }事件觸發(fā)時(shí)機(jī)典型用途memory.added直接創(chuàng)建、置頂創(chuàng)建、智能攝取 ADD、Chain 路由寫入成功同步到搜索索引、通知下游系統(tǒng)memory.deleted單條或批量刪除成功清理本地緩存與副本space_chain.fact_routedSpace Chain 事實(shí)按策略路由到目標(biāo) Space 且寫入成功配額拒絕或?qū)懭胧〔挥|發(fā)審計(jì)跨 Space 數(shù)據(jù)流事件類型的權(quán)威定義在 server/internal/webhook/types.go投遞 HTTP 請(qǐng)求的構(gòu)造邏輯見 server/internal/webhook/dispatcher.go。投遞失敗怎么辦自動(dòng)重試與退避策略每次成功投遞2xx 響應(yīng)會(huì)標(biāo)記為delivered失敗則進(jìn)入pending重試隊(duì)列默認(rèn)退避節(jié)奏1 分鐘 → 5 分鐘 → 30 分鐘 → 2 小時(shí) → 6 小時(shí) → 之后每 24 小時(shí)直到達(dá)到最大嘗試次數(shù)轉(zhuǎn)為failed。你可以通過GET /v1alpha2/mem9s/webhook-deliveries查看每條投遞的狀態(tài)、嘗試次數(shù)與最近一次 HTTP 狀態(tài)碼排查問題不迷路。Webhook 簽名校驗(yàn)HMAC-SHA256 安全實(shí)踐這是新手最容易踩坑的環(huán)節(jié)。mem9 每次投遞會(huì)附帶 4 個(gè)請(qǐng)求頭請(qǐng)求頭含義X-Mem9-Event-Id事件 ID可用于冪等去重X-Mem9-Event-Type事件類型X-Mem9-Timestamp投遞時(shí)間戳Unix 秒X-Mem9-Signature簽名值格式v1hex_hmac_sha256簽名算法是HMAC-SHA256輸入為「時(shí)間戳 事件 ID 原始請(qǐng)求體」HMAC-SHA256( signing_secret, timestamp.event_id.raw_body )實(shí)現(xiàn)可對(duì)照 server/internal/webhook/signer.go接收端按以下步驟校驗(yàn)校驗(yàn)X-Mem9-Timestamp與本機(jī)時(shí)間差在可接受范圍內(nèi)如 ±5 分鐘防重放攻擊用保存的signing_secret按上式重新計(jì)算 HMAC以恒定時(shí)間constant-time比較兩個(gè)簽名避免時(shí)序側(cè)信道校驗(yàn)不通過直接返回 401/403不處理請(qǐng)求體。密鑰輪換rotate-secret 安全操作指南 密鑰泄露或團(tuán)隊(duì)輪崗時(shí)不要直接刪端點(diǎn)重建會(huì)丟失投遞歷史應(yīng)調(diào)用POST /v1alpha2/mem9s/webhooks/{webhookID}/rotate-secret響應(yīng)中會(huì)返回一次性的新signing_secret舊密鑰立即失效。推薦的操作順序調(diào)用輪換接口立刻把新密鑰寫入你的密鑰管理系統(tǒng)KMS/環(huán)境變量通知你的接收端更新校驗(yàn)用密鑰若支持雙密鑰過渡期先讓舊密鑰再存活幾秒調(diào)用POST .../{webhookID}/test觸發(fā)一條webhook.test事件端到端驗(yàn)證簽名鏈路正常在webhook-deliveries中確認(rèn)新事件delivered輪換完成。路由層對(duì)輪換、測(cè)試等接口的手可參考 server/internal/handler/webhook.go事件服務(wù)層邏輯在 server/internal/webhook/service.go。Space 與 Space Chain兩種作用域別混淆Space Webhook綁定租戶的X-API-Key只觀察該 Space 的事件Space Chain Webhook綁定chain_管理密鑰觀察鏈級(jí)事件如space_chain.fact_routed。一個(gè)容易忽略的細(xì)節(jié)當(dāng) Chain 路由寫入在目標(biāo) Space 創(chuàng)建記憶時(shí)mem9 會(huì)同時(shí)發(fā)出目標(biāo) Space 的memory.added和鏈級(jí)事件路由元數(shù)據(jù)則以space_chain.fact_routed單獨(dú)下發(fā)——所以下游做冪等時(shí)請(qǐng)以X-Mem9-Event-Id去重而不是記憶 ID。常見問題 FAQQ1收到重復(fù)事件重試機(jī)制可能導(dǎo)致同事件多次投遞請(qǐng)用X-Mem9-Event-Id做冪等鍵。Q2本地開發(fā)能用 HTTP 嗎可以。僅localhost、127.0.0.1、::1在非生產(chǎn)環(huán)境放行 HTTP生產(chǎn)一律 HTTPS。Q3忘記保存 signing_secret 還能找回嗎不能。只能走rotate-secret生成新密鑰并重新配置接收端。小結(jié)mem9 Webhook 用「事件落庫 簽名投遞 自動(dòng)退避重試」三件套把記憶變更的實(shí)時(shí)同步做成了開箱即用的能力。記住三板斧創(chuàng)建時(shí)存好一次性密鑰、接收端恒定時(shí)間校驗(yàn)簽名、輪換后測(cè)試事件驗(yàn)證鏈路。上手資料推薦延伸閱讀 docs/webhooks-api-design.md。贊分享人工智能AI 應(yīng)用Agent 記憶AI AgentRAG后端前端dsh-plugin【免費(fèi)下載鏈接】mem9Unlimited memory for OpenClaw項(xiàng)目地址https://gitcode.com/gh_mirrors/me/mem9點(diǎn)擊查看免費(fèi)下載相關(guān)推薦OpenMed 審計(jì)報(bào)告簽名密鑰輪換指南基于調(diào)用方托管密鑰的 HMAC-SHA256 離線簽名與校驗(yàn)OpenMed 審計(jì)報(bào)告簽名密鑰輪換指南基于調(diào)用方托管密鑰的 HMAC SHA256 離線簽名與校驗(yàn) OpenMed 為每次脫敏de identificat人工智能NLP醫(yī)療健康數(shù)據(jù)脫敏本地部署大模型AI 應(yīng)用MCP 服務(wù)聯(lián)邦學(xué)習(xí)Nango Webhook 簽名密鑰輪換實(shí)戰(zhàn)基于 rotate-webhook-signing-key 運(yùn)維手冊(cè)的完整指南Nango Webhook 簽名密鑰輪換實(shí)戰(zhàn)基于 rotate webhook signing key 運(yùn)維手冊(cè)的完整指南 在 Nango 中每個(gè)環(huán)境en后端API網(wǎng)關(guān)AI 應(yīng)用Symfony Mailer Sendgrid Bridge 實(shí)戰(zhàn)指南DSN 配置、定時(shí)發(fā)送、退訂組與 Webhook 簽名校驗(yàn)Symfony Mailer Sendgrid Bridge 實(shí)戰(zhàn)指南DSN 配置、定時(shí)發(fā)送、退訂組與 Webhook 簽名校驗(yàn) 本篇技術(shù)指南圍繞 Symfo后端Web框架創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 記憶變更實(shí)時(shí)推送：mem9 Webhook API 指南，簽名校驗(yàn)與密鑰輪換一篇搞定
人工智能AI 應(yīng)用Agent 記憶AI AgentRAG后端前端dsh-plugin【免費(fèi)下載鏈接】mem9Unlimited memory for OpenClaw項(xiàng)目地址https://gitcode.com/gh_mirrors/me/mem9點(diǎn)擊查看免費(fèi)下載mem9 是為 AI Agent 提供持久記憶的開源服務(wù)而mem9 Webhook能讓你的系統(tǒng)在記憶新增、刪除或跨 Space 路由的瞬間收到實(shí)時(shí)推送無需反復(fù)輪詢。這篇指南帶你從零配置 Webhook 端點(diǎn)并完整講解事件簽名校驗(yàn)HMAC-SHA256與signing_secret密鑰輪換的安全最佳實(shí)踐。為什么需要 mem9 Webhook 實(shí)時(shí)推送傳統(tǒng)做法是定時(shí)調(diào)用列表接口輪詢記憶變化既浪費(fèi)配額又存在延遲。mem9 Webhook 采用outbox 主動(dòng)推送模式事件先落庫、再異步投遞到你的 HTTPS 端點(diǎn)失敗自動(dòng)指數(shù)退避重試。核心能力一覽? 三類核心事件memory.added、memory.deleted、space_chain.fact_routed? 每次投遞攜帶X-Mem9-Signature簽名可防篡改、防偽造? 失敗重試最長跨天級(jí)退避投遞歷史可隨時(shí)查詢? 一鍵測(cè)試webhook.test與密鑰輪換密鑰只在創(chuàng)建/輪換時(shí)返回一次完整設(shè)計(jì)可見 docs/webhooks-api-design.md?？焖賱?chuàng)建 Webhook 端點(diǎn)3 步完成配置Space 作用域下使用現(xiàn)有X-API-Key請(qǐng)求以下端點(diǎn)Space Chain 作用域改用chain_管理密鑰和/v1alpha2/space-chains/{chainID}/webhooks前綴操作方法與路徑創(chuàng)建POST /v1alpha2/mem9s/webhooks列表 / 詳情GET /v1alpha2/mem9s/webhooks、GET .../{webhookID}更新 / 刪除PATCH、DELETE .../{webhookID}測(cè)試 / 輪換密鑰POST .../{webhookID}/test、POST .../{webhookID}/rotate-secret查詢投遞記錄GET /v1alpha2/mem9s/webhook-deliveries創(chuàng)建請(qǐng)求體只需四個(gè)字段{ name: Production sync, url: https://example.com/mem9/webhook, enabled: true, events: [memory.added, memory.deleted] }三個(gè)關(guān)鍵注意點(diǎn)??signing_secret只返回一次——?jiǎng)?chuàng)建和輪換密鑰的響應(yīng)中才會(huì)出現(xiàn)請(qǐng)務(wù)必當(dāng)場(chǎng)保存列表/詳情接口永遠(yuǎn)看不到它見 server/internal/webhook/types.go 中的EndpointSecretResponse。生產(chǎn)環(huán)境 URL 必須 HTTPS僅開發(fā)環(huán)境允許localhost/127.0.0.1的 HTTP。帶 userinfo 的地址、私網(wǎng)字面量 IP 都會(huì)被拒絕。端點(diǎn)、密鑰、事件、投遞狀態(tài)全部由 mem9 控制面數(shù)據(jù)庫統(tǒng)一管理外部系統(tǒng)不應(yīng)自行持久化投遞狀態(tài)。三類事件推送mem9 事件模型速覽每個(gè)事件只存一份再扇出fan-out給所有訂閱且啟用的端點(diǎn)。事件外層信封結(jié)構(gòu)如下{ id: evt_..., type: memory.added, api_version: 2026-06-08, created_at: 2026-06-08T00:00:00Z, scope: { type: tenant, tenant_id: ... }, data: {} }事件觸發(fā)時(shí)機(jī)典型用途memory.added直接創(chuàng)建、置頂創(chuàng)建、智能攝取 ADD、Chain 路由寫入成功同步到搜索索引、通知下游系統(tǒng)memory.deleted單條或批量刪除成功清理本地緩存與副本space_chain.fact_routedSpace Chain 事實(shí)按策略路由到目標(biāo) Space 且寫入成功配額拒絕或?qū)懭胧〔挥|發(fā)審計(jì)跨 Space 數(shù)據(jù)流事件類型的權(quán)威定義在 server/internal/webhook/types.go投遞 HTTP 請(qǐng)求的構(gòu)造邏輯見 server/internal/webhook/dispatcher.go。投遞失敗怎么辦自動(dòng)重試與退避策略每次成功投遞2xx 響應(yīng)會(huì)標(biāo)記為delivered失敗則進(jìn)入pending重試隊(duì)列默認(rèn)退避節(jié)奏1 分鐘 → 5 分鐘 → 30 分鐘 → 2 小時(shí) → 6 小時(shí) → 之后每 24 小時(shí)直到達(dá)到最大嘗試次數(shù)轉(zhuǎn)為failed。你可以通過GET /v1alpha2/mem9s/webhook-deliveries查看每條投遞的狀態(tài)、嘗試次數(shù)與最近一次 HTTP 狀態(tài)碼排查問題不迷路。Webhook 簽名校驗(yàn)HMAC-SHA256 安全實(shí)踐這是新手最容易踩坑的環(huán)節(jié)。mem9 每次投遞會(huì)附帶 4 個(gè)請(qǐng)求頭請(qǐng)求頭含義X-Mem9-Event-Id事件 ID可用于冪等去重X-Mem9-Event-Type事件類型X-Mem9-Timestamp投遞時(shí)間戳Unix 秒X-Mem9-Signature簽名值格式v1hex_hmac_sha256簽名算法是HMAC-SHA256輸入為「時(shí)間戳 事件 ID 原始請(qǐng)求體」HMAC-SHA256( signing_secret, timestamp.event_id.raw_body )實(shí)現(xiàn)可對(duì)照 server/internal/webhook/signer.go接收端按以下步驟校驗(yàn)校驗(yàn)X-Mem9-Timestamp與本機(jī)時(shí)間差在可接受范圍內(nèi)如 ±5 分鐘防重放攻擊用保存的signing_secret按上式重新計(jì)算 HMAC以恒定時(shí)間constant-time比較兩個(gè)簽名避免時(shí)序側(cè)信道校驗(yàn)不通過直接返回 401/403不處理請(qǐng)求體。密鑰輪換rotate-secret 安全操作指南 密鑰泄露或團(tuán)隊(duì)輪崗時(shí)不要直接刪端點(diǎn)重建會(huì)丟失投遞歷史應(yīng)調(diào)用POST /v1alpha2/mem9s/webhooks/{webhookID}/rotate-secret響應(yīng)中會(huì)返回一次性的新signing_secret舊密鑰立即失效。推薦的操作順序調(diào)用輪換接口立刻把新密鑰寫入你的密鑰管理系統(tǒng)KMS/環(huán)境變量通知你的接收端更新校驗(yàn)用密鑰若支持雙密鑰過渡期先讓舊密鑰再存活幾秒調(diào)用POST .../{webhookID}/test觸發(fā)一條webhook.test事件端到端驗(yàn)證簽名鏈路正常在webhook-deliveries中確認(rèn)新事件delivered輪換完成。路由層對(duì)輪換、測(cè)試等接口的手可參考 server/internal/handler/webhook.go事件服務(wù)層邏輯在 server/internal/webhook/service.go。Space 與 Space Chain兩種作用域別混淆Space Webhook綁定租戶的X-API-Key只觀察該 Space 的事件Space Chain Webhook綁定chain_管理密鑰觀察鏈級(jí)事件如space_chain.fact_routed。一個(gè)容易忽略的細(xì)節(jié)當(dāng) Chain 路由寫入在目標(biāo) Space 創(chuàng)建記憶時(shí)mem9 會(huì)同時(shí)發(fā)出目標(biāo) Space 的memory.added和鏈級(jí)事件路由元數(shù)據(jù)則以space_chain.fact_routed單獨(dú)下發(fā)——所以下游做冪等時(shí)請(qǐng)以X-Mem9-Event-Id去重而不是記憶 ID。常見問題 FAQQ1收到重復(fù)事件重試機(jī)制可能導(dǎo)致同事件多次投遞請(qǐng)用X-Mem9-Event-Id做冪等鍵。Q2本地開發(fā)能用 HTTP 嗎可以。僅localhost、127.0.0.1、::1在非生產(chǎn)環(huán)境放行 HTTP生產(chǎn)一律 HTTPS。Q3忘記保存 signing_secret 還能找回嗎不能。只能走rotate-secret生成新密鑰并重新配置接收端。小結(jié)mem9 Webhook 用「事件落庫 簽名投遞 自動(dòng)退避重試」三件套把記憶變更的實(shí)時(shí)同步做成了開箱即用的能力。記住三板斧創(chuàng)建時(shí)存好一次性密鑰、接收端恒定時(shí)間校驗(yàn)簽名、輪換后測(cè)試事件驗(yàn)證鏈路。上手資料推薦延伸閱讀 docs/webhooks-api-design.md。贊分享人工智能AI 應(yīng)用Agent 記憶AI AgentRAG后端前端dsh-plugin【免費(fèi)下載鏈接】mem9Unlimited memory for OpenClaw項(xiàng)目地址https://gitcode.com/gh_mirrors/me/mem9點(diǎn)擊查看免費(fèi)下載相關(guān)推薦OpenMed 審計(jì)報(bào)告簽名密鑰輪換指南基于調(diào)用方托管密鑰的 HMAC-SHA256 離線簽名與校驗(yàn)OpenMed 審計(jì)報(bào)告簽名密鑰輪換指南基于調(diào)用方托管密鑰的 HMAC SHA256 離線簽名與校驗(yàn) OpenMed 為每次脫敏de identificat人工智能NLP醫(yī)療健康數(shù)據(jù)脫敏本地部署大模型AI 應(yīng)用MCP 服務(wù)聯(lián)邦學(xué)習(xí)Nango Webhook 簽名密鑰輪換實(shí)戰(zhàn)基于 rotate-webhook-signing-key 運(yùn)維手冊(cè)的完整指南Nango Webhook 簽名密鑰輪換實(shí)戰(zhàn)基于 rotate webhook signing key 運(yùn)維手冊(cè)的完整指南 在 Nango 中每個(gè)環(huán)境en后端API網(wǎng)關(guān)AI 應(yīng)用Symfony Mailer Sendgrid Bridge 實(shí)戰(zhàn)指南DSN 配置、定時(shí)發(fā)送、退訂組與 Webhook 簽名校驗(yàn)Symfony Mailer Sendgrid Bridge 實(shí)戰(zhàn)指南DSN 配置、定時(shí)發(fā)送、退訂組與 Webhook 簽名校驗(yàn) 本篇技術(shù)指南圍繞 Symfo后端Web框架創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考