Về Trang Chủ

TÀI LIỆU TÍCH HỢP API

Hệ thống bóc tách mã OTP tự động siêu tốc dành cho đối tác

YÊU CẦU BẮT BUỘC: Hệ thống API chỉ hoạt động khi bạn có api_key. Vui lòng liên hệ Admin (Quản trị viên) để đăng ký gói dịch vụ và nhận Key kích hoạt.

1. Đẩy Lệnh Lấy Mã (Request OTP)

API này dùng để thông báo cho hệ thống biết những email nào đang chuẩn bị cần lấy mã. Gọi API này ngay trước khi bạn bấm nút "Gửi mã" trên các trang đích.

Endpoint: POST https://khomail.com/api/request_otp.php

Headers: Content-Type: application/json

Body (JSON):

{
    "emails": [
        "mail1@gmail.com",
        "mail2@hotmail.com"
    ],
    "api_key": "YOUR_API_KEY_HERE" 
}

(Giới hạn tối đa 50 email / 1 lần gọi. Tốc độ gọi tối đa 1 giây/lần).

Kết quả trả về (JSON):

{
    "status": "success",
    "msg": "Đã tiếp nhận yêu cầu lấy OTP",
    "data": {
        "request_ids": [10, 11],
        "total": 2
    }
}

Lưu lại mảng request_ids này để dùng cho bước kiểm tra bên dưới.

2. Kiểm Tra Mã (Check OTP)

Khách hàng thiết lập vòng lặp (Polling) gọi API này mỗi 3-5 giây/lần cho tới khi lấy được mã hoặc hết thời gian chờ.

Endpoint: POST https://khomail.com/api/check_otp.php

Body (JSON):

{
    "request_ids": [10, 11],
    "api_key": "YOUR_API_KEY_HERE"
}

Kết quả trả về (JSON):

{
    "status": "success",
    "data": [
        {
            "request_id": "10",
            "email": "mail1@gmail.com",
            "status": "completed",
            "otp_code": "666321",
            "updated_at": "2026-08-21 11:30:00"
        },
        {
            "request_id": "11",
            "email": "mail2@hotmail.com",
            "status": "pending",
            "otp_code": null,
            "updated_at": "2026-08-21 11:29:05"
        }
    ]
}

Giải thích trạng thái:
- completed: Đã có mã OTP thành công.
- pending: Hệ thống vẫn đang quét, cần đợi thêm vài giây và gọi kiểm tra lại.

3. Code Mẫu PHP (cURL)

<?php
// BƯỚC 1: Đẩy Lệnh Yêu Cầu
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://khomail.com/api/request_otp.php',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode([
      'emails' => ['test1@gmail.com'],
      'api_key' => 'YOUR_API_KEY_HERE'
  ]),
  CURLOPT_HTTPHEADER => array('Content-Type: application/json'),
));
$response = curl_exec($curl);
$request_data = json_decode($response, true);
$req_ids = $request_data['data']['request_ids'] ?? [];
curl_close($curl);

// BƯỚC 2: Kiểm Tra Kết Quả
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://khomail.com/api/check_otp.php',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode([
      'request_ids' => $req_ids,
      'api_key' => 'YOUR_API_KEY_HERE'
  ]),
  CURLOPT_HTTPHEADER => array('Content-Type: application/json'),
));
$response2 = curl_exec($curl);
echo $response2;
curl_close($curl);
?>