lihiSMS OTP API 串接教學｜簡訊驗證碼發送與驗證服務

lihiSMS OTP API 可協助網站、App 與會員系統快速串接簡訊驗證碼服務，適用於會員註冊、手機號碼驗證、登入驗證、交易確認與安全驗證等情境。透過 API 發送一次性密碼，並由系統自動比對驗證結果，可以減少人工驗證成本，也讓會員流程更安全、更順暢。

使用 lihiSMS OTP API 前，請先確認 lihi 會員方案為 Starter 以上，並完成 Verify Token 申請，再依照串接文件進行開發設定。

lihiSMS OTP API 是什麼？

lihiSMS OTP API 是 lihiSMS 提供的簡訊驗證碼串接服務，開發者可以將 OTP 驗證碼的發送與驗證流程，整合到網站、App、會員系統、電商平台或企業內部系統中。

當使用者需要進行手機號碼驗證、登入驗證或身分確認時，系統可透過 API 發送一次性驗證碼到使用者手機，並在使用者輸入驗證碼後進行比對，確認驗證碼是否正確。

核心功能

• OTP 發送：透過 API 傳送一次性密碼至使用者手機。
• OTP 驗證：使用者輸入收到的驗證碼後，系統可透過 API 比對驗證碼是否正確。
• API 串接：可整合至網站、App、會員系統、CRM 或其他需要簡訊驗證的流程。
• 安全驗證：適合用於手機號碼確認、登入驗證、交易確認與帳號安全驗證。

適用情境

lihiSMS OTP API 適合用於以下需要簡訊驗證碼的流程：

• 會員註冊手機驗證
• 登入驗證或二階段驗證
• 忘記密碼的身分確認
• 訂單、預約或交易確認
• App 使用者手機號碼綁定
• 電商平台會員驗證
• CRM 或企業內部系統身分驗證
• 需要簡訊驗證碼的系統開發專案

申請資格

申請 lihiSMS OTP API 串接服務前，請確認 lihi 會員方案為 Starter 以上。符合資格後，即可申請 Verify Token，並依照簡訊 OTP API 串接文件進行開發設定。各方案內容可參考 lihi 服務價格。

如果你同時有自動建立短網址的需求，也可以參考 lihi API 功能與 API 金鑰取得教學。lihi API 分兩種：Starter 以上方案的基本 API 可建立短網址、發送簡訊與 OTP；查詢、修改、刪除與批次操作等商用 API 則需 Business 以上方案。簡訊與 OTP 使用 Verify Token，建立短網址則使用 API 金鑰，兩者是不同的憑證。

OTP 簡訊怎麼計費？

OTP 簡訊與行銷簡訊共用同一組點數，計價方式也相同，不需要另外購買驗證碼專用的額度。

方案類型	價格	使用條件
訂閱帳號	$0.85／封	適用於 lihi 付費訂閱用戶
大量發送最划算	$0.79／封	一次購買 20,000 點

由於 OTP API 需為 Starter 以上方案，實際會套用訂閱帳號或大量發送的價格。如果驗證量較大，建議直接評估大量發送方案。完整的簡訊方案與應用說明，可參考 lihiSMS 行銷簡訊發送系統介紹。

如何申請 Verify Token

1. 登入 lihi 短網址後台。
2. 確認 lihi 會員方案為 Starter 以上。
3. 前往簡訊 OTP API 相關設定頁面。
4. 依照頁面指示申請 Verify Token。
5. 取得 Verify Token 後，即可用於 OTP 發送與驗證流程。

提醒：Verify Token 是串接 lihiSMS OTP API 時用來驗證請求身分的憑證。開發者需要在 API Header 中帶入 Verify Token，系統才會接受 OTP 發送與驗證請求。請勿將 Verify Token 公開貼在文章、截圖、前端程式碼或公開的 GitHub 儲存庫中。

如何查看串接文件

1. 登入 lihi 短網址後台。
2. 點選左側選單：進階工具 > 串接 API > 簡訊 OTP API。
3. 點擊收合選單，即可查看 lihiSMS OTP API 串接文件。

OTP API 串接流程

1. 使用者在網站或 App 輸入手機號碼。
2. 系統透過 OTP Send API 發送一次性驗證碼。
3. 使用者收到簡訊後回填驗證碼。
4. 系統透過 OTP Verify API 比對驗證碼是否正確。
5. 驗證成功後，即可完成註冊、登入、手機綁定或身分確認流程。

使用範例：PHP 實作

以下範例示範如何使用 PHP 串接 lihiSMS OTP API，包含發送 OTP 與驗證 OTP 的基本流程。實際開發時，請將範例中的手機號碼與 Verify Token 替換為你的正式資料。

<?php
// 發送 OTP 的範例
function sendOtpExample() {
    $data = [
        'phone' => '+886912345678'
    ];

    $headers = [
        'X-VERIFY-TOKEN: your_verification_token_here',
        'Content-Type: application/json'
    ];

    $ch = curl_init('https://app.lihi.io/api/otp/send');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    curl_close($ch);

    $result = json_decode($response, true);

    if ($httpCode === 200) {
        echo "OTP 發送成功：" . $result['message'] . "\n";
    } else {
        echo "OTP 發送失敗：" . $result['message'] . "\n";
    }
}

// 驗證 OTP 的範例
function verifyOtpExample() {
    $data = [
        'phone' => '+886912345678',
        'otp' => '123456'
    ];

    $headers = [
        'X-VERIFY-TOKEN: your_verification_token_here',
        'Content-Type: application/json'
    ];

    $ch = curl_init('https://app.lihi.io/api/otp/verify');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    curl_close($ch);

    $result = json_decode($response, true);

    if ($httpCode === 200) {
        echo "OTP 驗證成功：" . $result['message'] . "\n";
    } else {
        echo "OTP 驗證失敗：" . $result['message'] . "\n";
    }
}

try {
    echo "正在發送 OTP...\n";
    sendOtpExample();

    echo "\n正在驗證 OTP...\n";
    verifyOtpExample();
} catch (Exception $e) {
    echo "發生錯誤：" . $e->getMessage() . "\n";
}
?>

若需要更多串接範例，也可以參考 lihi 官方提供的 GitHub API 範例，內含基本請求格式與金鑰使用方式。

串接前注意事項

• 請確認 lihi 會員方案為 Starter 以上。
• 請妥善保管 Verify Token，避免外洩或直接寫在前端程式碼中。
• 正式上線前建議先行測試，確認 OTP 發送、驗證與錯誤訊息處理都正常。
• 若用於會員註冊、登入或交易驗證，請確認系統已設計驗證失敗、驗證逾時與重新發送的處理機制。
• OTP 簡訊會消耗簡訊點數，建議在後台留意剩餘點數，避免驗證流程中斷。

常見問題

lihiSMS OTP API 可以用在哪些情境？

可用於會員註冊、手機號碼驗證、登入驗證、忘記密碼、交易確認、App 帳號綁定，以及其他需要簡訊驗證碼的流程。

申請 lihiSMS OTP API 需要什麼會員資格？

lihi 會員方案需為 Starter 以上，才可申請 Verify Token 並使用 OTP API 串接服務。

OTP 簡訊怎麼計費？

OTP 簡訊與行銷簡訊共用同一組點數，計價方式相同。訂閱帳號每封 $0.85，一次購買 20,000 點的大量發送方案為每封 $0.79，不需另外購買驗證碼專用額度。

Verify Token 是什麼？

Verify Token 是串接 lihiSMS OTP API 時用來驗證請求身分的憑證。開發者需要在 API Header 中帶入 Verify Token，系統才會接受 OTP 發送與驗證請求。

OTP 發送與 OTP 驗證有什麼不同？

OTP 發送是系統將一次性驗證碼傳送到使用者手機；OTP 驗證則是使用者輸入驗證碼後，系統比對該驗證碼是否正確，用來完成身分確認流程。

延伸閱讀

• lihiSMS 行銷簡訊發送系統介紹
• lihi API 功能是什麼？如何取得 API 金鑰？
• lihi 服務價格
• lihi API 串接範例（GitHub）

開始使用 lihiSMS OTP API

若你的網站、App 或會員系統需要簡訊驗證碼功能，可以透過 lihiSMS OTP API 串接發送與驗證流程。請先確認 lihi 會員方案為 Starter 以上，登入後台申請 Verify Token，再依照串接文件完成設定。

串接過程中遇到問題，歡迎聯繫 lihi 客服協助。