CE Notify
只要一個 HTTP 請求,就能讓您的程式、伺服器或裝置傳 LINE 通知給自己。
概述
CE Notify 把 LINE 聊天室變成可以呼叫的網址。部署跑完、備份失敗,或感測器超過門檻時,您的程式送出一個請求,訊息就會出現在手機上。
CE Notify 和 CE 小幫手是兩個不同的 LINE 帳號。它只負責傳送通知,所以通知不會和小幫手的對話混在一起。適合會寫一點程式,或會設定 webhook 的使用者。
如何使用
- 開啟 line.me/R/ti/p/@973femac ,在 LINE 加入 CE Notify(@973femac)好友
- CE Notify 會請您輸入電子郵件地址,直接以訊息傳送即可
- 點選驗證信中的連結,把聊天室和您的 Chat Everywhere 帳號綁定。如果這個電子郵件還沒有帳號,系統會自動建立一個
- 在 CE Notify 聊天室使用選單取得 Token。CE Notify 會回覆一張 CE Notify API 卡片,上面有 API 網址、您的 Token 與本月用量
每個帳號只有一組 Token,再次取得時會顯示同一組。傳送其他訊息給 CE Notify 時,會收到「CE Notify 僅提供 API 通知功能。」的回覆。
主要功能
- 一個請求就好:用 Bearer Token 加 JSON 內容送出 POST,不需要安裝 SDK,也不用註冊 webhook
- Markdown 排版:加上
"markdown": true,就會收到排好版的 LINE 卡片 - 支援 GET:適合只能送出 GET 請求的裝置
- 每次回應都附上用量:查看剩餘則數與距離重置的天數
- 失敗不扣額度:送達失敗時不會計入用量
操作步驟
傳送訊息
對 https://v2.chateverywhere.app/api/line/notify 送出 POST 請求:
curl -X POST https://v2.chateverywhere.app/api/line/notify \
-H "Authorization: Bearer $CE_NOTIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"message": "Deploy finished"}'message(必填):要傳送的文字,最多 5,000 字,前後空白會自動移除markdown(選填):設為true時,標題、粗體、斜體、程式碼與清單會排版成 LINE 卡片
傳送排版訊息
{
"message": "# Alert\n**Temperature** 42°C\n- Living Room",
"markdown": true
}不加 markdown 時,訊息會以純文字送出。
使用 GET 傳送
如果您的裝置或服務只能送出 GET 請求,請把 token 與 message 放在查詢參數中:
curl "https://v2.chateverywhere.app/api/line/notify?token=$CE_NOTIFY_TOKEN&message=Deploy+finished"GET 請求一律以純文字傳送。這種方式會讓 Token 出現在網址與伺服器紀錄中,能用 POST 時請盡量使用 POST。
查看回應
請求成功時會回傳:
{
"success": true,
"quota": {
"used": 13,
"limit": 100,
"remaining": 87,
"daysUntilReset": 19
}
}使用限制與狀態碼
| 狀態碼 | 錯誤訊息 | 說明 |
|---|---|---|
| 200 | — | 訊息已送出 |
| 400 | Invalid JSON body | POST 內容不是有效的 JSON |
| 400 | Missing or empty "message" field / Missing or empty "message" query parameter | 沒有訊息內容,或只有空白 |
| 400 | Message exceeds 5000 character limit | 訊息太長 |
| 400 | User has no linked CE Notify account | CE Notify 的 LINE 聊天室尚未綁定您的帳號 |
| 401 | Missing or invalid Authorization header / Missing "token" query parameter | 沒有帶 Token |
| 401 | Invalid token | Token 無效 |
| 429 | Monthly limit of 100 messages reached | 本月額度已用完,訊息不會送出 |
| 500 | Failed to send LINE message | LINE 沒有收下訊息,這次嘗試不會計入用量 |
所有回應都是 JSON 格式。遇到 429 時請不要自動重試,因為這是每月上限。
方案與權限
| 方案 | 每月 CE Notify 訊息 |
|---|---|
| 所有方案 | 100 則 |
額度以帳號計算,每月 1 日(台北時間,GMT+8)重置。
保護您的 Token
- 取得 Token 的人都能傳訊息到您的 LINE
- 請把 Token 存放在環境變數(例如
CE_NOTIFY_TOKEN)中,不要寫在程式碼或放進程式碼庫 - 盡量使用 POST,避免 Token 出現在網址中
相關功能
疑難排解
出現 400「User has no linked CE Notify account」
請在 LINE 加入 CE Notify,並用與 Chat Everywhere 帳號相同的電子郵件完成驗證。
出現 401「Invalid token」
請確認已完整複製 CE Notify API 卡片上的 Token,且 header 格式為 Authorization: Bearer <token>。
出現 429,訊息不再送達
本月已傳送 100 則訊息。上一次成功請求回傳的 daysUntilReset 會顯示距離重置還有幾天。
最後更新於