概述
Webhook 整合是一座通用橋樑，讓你從任何來源直接將資料推送到 deariary。產生一個 bearer token，然後讓任何服務、裝置或腳本向我們的端點 POST JSON 資料。每個 payload 都會被儲存並自動包含在下一次日記產生中。沒有固定 schema——傳送對你有意義的任何資料。
使用情境
- 用命令列工具隨時記錄靈感，一個微日記 CLI
- 用自訂行動應用或 iOS 捷徑隨時記錄想法、照片描述或語音備忘錄
- 用「稍後閱讀」應用或瀏覽器擴充功能將書籤文章和亮點傳送到日記
- 智慧寵物裝置——從 Petkit 或 Litter-Robot 記錄貓咪的貓砂盆使用和體重變化
- 個人理財腳本，從券商 API 取得每日投資組合快照
收集的資料
- 自由格式 JSON — 任何有效的 JSON payload（每次請求最大 100 KB）
- 來源標籤 — 你定義的 token 名稱，附加到每個 payload
- 每日多次上傳 — 每次 POST 建立一個獨立 artifact，全部包含在下一次日記產生中
沒有固定 schema——傳送對你有意義的任何 JSON。每個 payload 都會被儲存並包含在下一次日記產生中。
範例日記摘錄
2026年3月12日
筆記、文章和年糕
隨手記
今天在終端記了 3 條筆記。最好的一條：「API 設計應該像對話，而不是合約。」還在捷運上用語音備忘錄記錄了關於城市農業 podcast 的想法。
閱讀
透過瀏覽器擴充功能儲存了 2 篇文章——一篇關於瀏覽器之外的 WebAssembly，一篇比較邊緣運算提供商。劃了一段關於冷啟動的重點。
年糕（貓）
年糕今天用了 3 次貓砂盆——都正常。Petkit 秤顯示體重穩定在 4.2 公斤。她不到一個小時就拆完了新的逗貓棒。
投資組合
以 +3.2% 賣出了 AAPL，小倉位建倉 MSFT。本週組合上漲 1.4%。
零散的記錄匯聚成一天。年糕很健康。市場表現也不錯。
設定
在 Webhook 設定頁面建立一個 webhook token。使用 token 作為 Authorization header 中的 Bearer token 傳送 POST 請求。請求主體為有效的 JSON（最大 100 KB）。接受任何結構。資料將被儲存並包含在當天的下一次日記產生中。
Endpoint: POST /webhooks/ingest Authorization: Bearer whk_your_token_here
需要 Advanced 方案。最多可建立 10 個 token。
權限
無需 OAuth。使用在 deariary Webhook 設定頁面產生的 Bearer token 進行認證。每個 token 以 whk_ 為前綴。
方案
需要 Advanced 方案。每個帳戶最多 10 個 token。