【Day27】為爬蟲加上通知 - 透過 POSTMAN 了解 LINE Notify 如何使用

爬蟲完成後沒發出通知，就像是黯然銷魂飯少了洋蔥

為什麼通知很重要？

1. 在爬蟲的運作完全自動化的狀態下你需要透過接收通知，知道爬蟲執行完畢
2. 通知的內容要簡述這次爬蟲的狀況，因為實際上使用者只有在要報告或是寫文章的時候才會去 Google Sheets 看爬蟲的詳細數據，平常他只需要知道爬蟲有沒有穩定執行就好

在通知這個部分我選擇使用 LINE Notify 作為範例，你在了解邏輯後也可以自己改為用 Slack、Wechat、Messager… 等通訊軟體來通知喔

---

今日目標

1. 取得 LINE Notify 權杖

2. 使用 POSTMAN 測試 LINE Notify

2.1 為什麼要先用 POSTMAN 測試 LINE Notify 呢？

2.2 用 POSTMAN 發出 LINE 的訊息

2.3 透過 POSTMAN 傳送錯誤參數來了解 HTTP狀態碼的意思

---

1. 取得 LINE Notify 權杖

1. 請以 LINE 帳號登入 LINE Notify，登入後選擇 個人頁面

   

2. 為了要獲得控制 LINE Notify 發訊息的權限，我們要 發行權杖

   

3. 在發行權杖的彈窗中，權杖名稱請填寫與功能相關的名稱，接收通知的聊天室可選擇 1對1、任意聊天室 這兩種，確認無誤後按 發行

   

4. 接著我們要將這組權杖(Token) 複製 下來

   

5. 關閉彈窗後能看到 已連動的服務中 有我們剛剛新增的服務

   

6. 同時你收到 LINE Notify 帳號啟用權杖的訊息

   

7. 將發行的權杖(Token)加入 .env 環境檔，在明天的教學會使用到

   .env.exmaple

   #放LINE Notify申請的權杖
   LINE_TOKEN='XXXXXX'
   

---

2. 使用 POSTMAN 測試 LINE Notify

2.1 為什麼要先用 POSTMAN 測試 LINE Notify 呢？

說明這個問題之前，我們先來探討為什麼 POSTMAN 會這麼被工程師推崇，在這我歸納成以下幾點：

1. 對 後端工程師 而言，可以向合作夥伴證明自己寫的 api 沒有在唬爛，真的可以 work
2. 對 前端工程師、App工程師、有使用 api 需求的人 來說，能在串接 api 前先用 POSTMAN 確認這些 api 真的可以 work
3. 有了這個工具作輔助，我們就能將前後端責任歸屬的很清楚。ex：如果 POSTMAN 上面可以正常 work，那前端就要去思考自己 api 哪裡沒串好
4. 工具操作難度極低，只需要對網路的世界有基礎的認知就能快速上手

所以我們先用 POSTMAN 測試 LINE Notify 的理由是：

1. 確保 LINE Notify api 執行所需的 Request 參數、Respone 的結果與說明書一致（這點非常重要，因為我看過很多 api 回傳的結構跟說明書完全不一樣）
2. 在一行程式都不用寫的狀態下測試所有的可能性
3. 在 POSTMAN 驗證後就能專心寫程式，因為如果程式無法發出 LINE 的通知一定是自己的問題

補充：

• POSTMAN 在工程師的世界中素有 API測試神器之稱，如果你對 POSTMAN 一無所知的話你可以先透過這篇文章了解一下他是做什麼的
• 他可以直接用 Gmail帳號登入在網頁使用，也能下載桌面版 App，相同帳號的操作記錄在兩邊都會同步

---

2.2 用 POSTMAN 發出 LINE 的訊息

1. 設定 Request 的參數

   • URL：https://notify-api.line.me/api/notify

   • Method：POST

   • Authorization：

     • TYPE：Bearer Token
     • Token：填入你剛剛在 LINE Notify 申請的權杖

     

   • Body：

     • form-data：

       key	value	DESCRIPTION
       message	來自寶寶的爬蟲通知	純文字(必填)
       stickerPackageId	2	貼圖的PackageId
       stickerId	144	貼圖的Id
       imageFile	icon.png	電腦上的圖片檔

     

     DESCRIPTION 是我對參數描述，實作上可以不避填
     如果你想深入的了解可以參考官方文件

2. 完成 Request 參數填寫後按下 Send 發出 LINE 訊息

   • 看到 Response 的結果，status 為 200 代表傳送成功

     

   • 在發行權杖的聊天室中，看到 POSTMAN 傳送的 訊息、貼圖、圖片

     

---

2.3 透過 POSTMAN 傳送錯誤參數來了解 HTTP狀態碼的意思

我們剛剛在 POSTMAN 的 Response 看到 HTTP狀態碼為 200，接下來我們故意做一些錯誤測試來看看會有什麼樣的 Response

請注意並不是每隻 api Response data 中的 status 都等於 HTTP狀態碼，只是 LINE Notify 剛好是依照這個邏輯顯示，我們可以用它來幫助我們對 HTTP狀態碼的了解

1. 不填寫 LINE Notify 的權杖

   • HTTP狀態碼為 401，代表需要授權才能使用

     

2. 在 Body 中不填寫 message 的參數

   • HTTP狀態碼為 400，意味伺服器收到無效的語法

     

透過上面的範例回傳的資訊，我們可以了解到不同 HTTP狀態碼的意思：200 代表成功、400可能是參數錯誤、401是沒有授權，當然 HTTP狀態碼不只這些，如果你想更深入的了解可以參考這篇文章

---

參考資源

1. [API連線測試]使用Postman測試LINE Notify的訊息推送
2. LINE Notify API Document
3. Postman 新手教學
4. HTTP 狀態碼一覽表

---

在許多人的幫助下，本系列文章已出版成書，並添加了新的篇章與細節補充：

• 加入更多實務經驗，用完整的開發流程讓讀者了解專案每個階段要注意的事項
• 將爬蟲的步驟與技巧做更詳細的說明，讓讀者可以輕鬆入門
• 調整專案架構
  • 優化爬蟲程式，以更廣的視角來擷取網頁資訊
  • 增加資料驗證、錯誤通知等功能，讓爬蟲執行遇到問題時可以第一時間通知使用者
  • 排程部分改用 node-schedule & pm2 的組合，讓讀者可以輕鬆管理專案程序並獲得更精確的 log 資訊

有興趣的朋友可以到天瓏書局選購，感謝大家的支持。

購書連結：https://www.tenlong.com.tw/products/9789864348008