iT邦幫忙

第 12 屆 iT 邦幫忙鐵人賽

DAY 27
1
AI & Data

行銷廣告、電商小編的武器,FB & IG 爬蟲專案從零開始系列 第 27

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

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

/images/emoticon/emoticon19.gif為什麼通知很重要?

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

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


/images/emoticon/emoticon12.gif 今日目標

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,登入後選擇 個人頁面
    https://ithelp.ithome.com.tw/upload/images/20201009/201032567aqT0AdIJC.png
  2. 為了要獲得控制 LINE Notify 發訊息的權限,我們要 發行權杖
    https://ithelp.ithome.com.tw/upload/images/20201009/20103256wtKJtwNYMp.png
  3. 在發行權杖的彈窗中,權杖名稱填寫與功能相關的名稱接收通知的聊天室可選擇 1對1、任意聊天室 這兩種,確認無誤後按 發行
    https://ithelp.ithome.com.tw/upload/images/20201009/20103256pc3XdbINN6.png
  4. 接著我們要將這組權杖(Token) 複製 下來
    https://ithelp.ithome.com.tw/upload/images/20201009/20103256KoCC8h7cDz.png
  5. 關閉彈窗後能看到 已連動的服務中 有我們剛剛新增的服務
    https://ithelp.ithome.com.tw/upload/images/20201009/20103256sug4drtKz6.png
  6. 同時你收到 LINE Notify 帳號啟用權杖的訊息
    https://ithelp.ithome.com.tw/upload/images/20201009/20103256s45DsfineL.png
  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 的參數
    • URLhttps://notify-api.line.me/api/notify
    • Method:POST
    • Authorization
      • TYPE:Bearer Token
      • Token:填入你剛剛在 LINE Notify 申請的權杖

      https://ithelp.ithome.com.tw/upload/images/20201009/201032567IxmuCFWrC.png

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

      https://ithelp.ithome.com.tw/upload/images/20201009/20103256BCZDRpQrgp.png
      DESCRIPTION 是我對參數描述,實作上可以不避填
      如果你想深入的了解可以參考官方文件

  2. 完成 Request 參數填寫後按下 Send 發出 LINE 訊息
    • 看到 Response 的結果,status 為 200 代表傳送成功
      https://ithelp.ithome.com.tw/upload/images/20201009/201032560oOpOkT4dG.png
    • 在發行權杖的聊天室中,看到 POSTMAN 傳送的 訊息、貼圖、圖片
      https://ithelp.ithome.com.tw/upload/images/20201009/20103256YbQMnDVf7z.png

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

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

請注意並不是每隻 api Response data 中的 status 都等於 HTTP狀態碼,只是 LINE Notify 剛好是依照這個邏輯顯示,我們可以用它來幫助我們對 HTTP狀態碼的了解
https://ithelp.ithome.com.tw/upload/images/20201009/20103256Z54CyYqZtU.png

  1. 不填寫 LINE Notify 的權杖
    • HTTP狀態碼為 401,代表需要授權才能使用
      https://ithelp.ithome.com.tw/upload/images/20201009/20103256xgzFrdklmf.png
  2. 在 Body 中不填寫 message 的參數
    • HTTP狀態碼為 400,意味伺服器收到無效的語法
      https://ithelp.ithome.com.tw/upload/images/20201009/201032562rdNYVsvxo.png

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


/images/emoticon/emoticon41.gif 參考資源

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

上一篇
【Day26】排程 - 重開機後排程不見惹?簡單幾個步驟,從此以後完全自動
下一篇
【Day28】為爬蟲加上通知 - 用 axios 發出 LINE 通知
系列文
行銷廣告、電商小編的武器,FB & IG 爬蟲專案從零開始30

尚未有邦友留言

立即登入留言