跳至主要內容

使用 HTTP SMS 設定簡訊驗證 (Set up SMS verification with HTTP SMS)

官方 Logto HTTP SMS 連接器 (connector)。

提示:

本指南假設你已對 Logto 連接器 (Connectors) 有基本了解。若不熟悉，請參閱 連接器 (Connectors) 指南以開始使用。

開始使用​

HTTP SMS 連接器允許你透過 HTTP 呼叫發送簡訊。要使用 HTTP SMS 連接器，你需要有自己的簡訊服務，並且該服務需提供用於發送簡訊的 HTTP API。Logto 會在需要發送簡訊時呼叫這個 API。例如，當使用者註冊時，Logto 會呼叫 HTTP API 發送驗證簡訊。

設定 HTTP SMS 連接器 (Set up HTTP SMS connector)​

要使用 HTTP SMS 連接器，你需要設定一個 Logto 可呼叫的 HTTP 端點，以及（可選）端點的授權權杖 (authorization token)。

提示:

請注意，為避免驗證 (Authentication) 流程出錯，所設定的 endpoint 在收到 webhook 後必須回傳 2xx 響應，以告知 Logto 已收到發送簡訊的通知。

同時，在此情境下，你需要監控簡訊服務以確保簡訊成功送達。或者，你也可以為簡訊發送 API 加入監控，以即時偵測簡訊發送失敗。

載荷 (Payload)​

HTTP SMS 連接器在需要發送簡訊時，會向端點發送以下載荷：

{
  "to": "+1234567890",
  "type": "SignIn",
  "payload": {
    "code": "123456"
  }
}

你可以在 簡訊範本 (SMS templates) 找到所有類型，並在 connector-kit 查看 SendMessageData 的完整型別定義。