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

lihiSMS OTP API 可協助網站、APP 與會員系統快速串接簡訊驗證碼服務，適用於會員註冊、手機號碼驗證、登入驗證、交易確認與安全驗證等情境。透過 API 發送一次性密碼，並由系統進行驗證比對，可降低人工驗證成本，提升會員流程的安全性與使用體驗。

使用 lihiSMS OTP API 前，請先確認您的 lihi 會員方案為 Business 以上，並完成 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 會員方案需為 Business 以上。符合資格後，即可申請 Verify Token，並依照簡訊 OTP API 串接文件進行開發設定。

如何申請 Verify Token

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

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

如何查看串接文件

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

OTP API 串接流程

lihiSMS 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 會員方案為 Business 以上。
• 請妥善保管 Verify Token，避免外洩或直接暴露於前端程式碼中。
• 正式上線前，建議先進行測試，確認 OTP 發送、驗證與錯誤訊息處理皆正常。
• 若需用於會員註冊、登入或交易驗證，請確認系統已設計驗證失敗、驗證逾時與重新發送機制。

常見問題

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

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

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

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

Verify Token 是什麼？

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

lihiSMS OTP API 支援哪些開發情境？

lihiSMS OTP API 可串接至網站、會員系統、電商平台、APP、CRM 或其他需要手機驗證的系統流程。

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

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

開始使用 lihiSMS OTP API

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