跳至主要內容

使用 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 的完整型別定義。