API Gmail OTP

Hướng dẫn API Gmail OTP

Giới thiệu

API Gmail OTP cung cấp dịch vụ thuê địa chỉ Gmail để nhận mã OTP cho các ứng dụng như Facebook, Instagram, TikTok, X (Twitter). Hệ thống hoạt động 24/7 với độ ổn định và tốc độ cao.

Thông tin kết nối

URL API: https://stclone.shop/api/GmailOTPAPI.php

Phương thức: POST (JSON) hoặc GET/POST

Content-Type: application/json

Danh sách Services

Service ID	Tên dịch vụ	Mô tả
`1` hoặc `facebook_reg`	Facebook Registration	Đăng ký tài khoản Facebook
`2` hoặc `instagram_reg`	Instagram Registration	Đăng ký tài khoản Instagram
`3` hoặc `tiktok_reg`	TikTok Registration	Đăng ký tài khoản TikTok
`4` hoặc `x_reg`	X Registration (Twitter)	Đăng ký tài khoản X (Twitter)
`5` hoặc `amazon_reg`	Amazon Registration	Đăng ký tài khoản Amazon

Trạng thái đơn hàng

Status	Mô tả	Hành động
waiting	Đang chờ OTP	Tiếp tục polling để kiểm tra
completed	Đã nhận OTP	Lấy mã OTP từ response
expired	Hết hạn	Có thể reorder để tái kích hoạt (sử dụng lại)

Thời gian hiệu lực

Thời gian chờ lấy mã OTP cho mỗi đơn hàng thành công: 5 phút (300 giây)
Thời gian giữa các lệnh gọi API lấy mã OTP khuyến nghị: 3-5 giây
Reorder (tái sử dụng) miễn phí sau khi email hết hạn
Hoàn tiền tự động nếu lỗi hệ thống hoặc mail die

POST Thuê Gmail (buy_gmail)

Mô tả: Thuê địa chỉ Gmail để nhận OTP

Request Parameters

Parameter	Type	Required	Mô tả
action	string	✓	"buy_gmail"
username	string	✓	Tên đăng nhập
password	string	✓	Mật khẩu
service_id	string/int	✓	ID dịch vụ (1-5 hoặc facebook_reg, instagram_reg, tiktok_reg, x_reg, amazon_reg)
amount	int	✓	Số lượng (tối thiểu: 1, tối đa: 10)

Request Example

{
    "action": "buy_gmail",
    "username": "your_username",
    "password": "your_password",
    "service_id": "1",
    "amount": 1
}

Request Example - X (Twitter)

{
    "action": "buy_gmail",
    "username": "your_username", 
    "password": "your_password",
    "service_id": "4",
    "amount": 1
}

Request Example - String Service ID

{
    "action": "buy_gmail",
    "username": "your_username",
    "password": "your_password", 
    "service_id": "x_reg",
    "amount": 1
}

Request Example - Amazon Service

{
    "action": "buy_gmail",
    "username": "your_username",
    "password": "your_password", 
    "service_id": "amazon_reg",
    "amount": 1
}

Response Example

{
    "status": "success",
    "msg": "Thuê Gmail OTP thành công",
    "data": {
        "total_orders": 1,
        "total_cost": 1000,
        "orders": [
            {
                "order_id": "GMT1725360123ABC12345def67890",
                "gmail": "example123@gmail.com",
                "service": "Facebook Registration",
                "status": "waiting",
                "expires_at": "2025-09-03 15:30:45"
            }
        ]
    }
}

POST Lấy mã OTP (get_otp)

Mô tả: Kiểm tra trạng thái và lấy mã OTP của đơn hàng

Request Parameters

Parameter	Type	Required	Mô tả
action	string	✓	"get_otp"
username	string	✓	Tên đăng nhập
password	string	✓	Mật khẩu
order_id	string	✓	ID đơn hàng từ buy_gmail

Response - Đang chờ OTP

{
    "status": "success",
    "data": {
        "order_id": "GMT1725360123ABC12345def67890",
        "gmail": "example123@gmail.com",
        "service": "Facebook Registration",
        "status": "waiting",
        "created_at": "2025-09-03 15:25:45",
        "expires_in": 245
    }
}

Response - Đã nhận OTP

{
    "status": "success",
    "data": {
        "order_id": "GMT1725360123ABC12345def67890",
        "gmail": "example123@gmail.com",
        "service": "Facebook Registration",
        "status": "completed",
        "created_at": "2025-09-03 15:25:45",
        "otp": "123456",
        "received_at": "2025-09-03 15:28:12"
    }
}

POST Tái kích hoạt email hết hạn (reorder)

Mô tả: Tái kích hoạt Gmail đã hết hạn để nhận OTP mới (miễn phí)

Request Parameters

Parameter	Type	Required	Mô tả
action	string	✓	"reorder"
username	string	✓	Tên đăng nhập
password	string	✓	Mật khẩu
order_id	string	✓	ID đơn hàng cần reorder

Response Example

{
    "status": "success",
    "msg": "Reorder email thành công",
    "data": {
        "order_id": "GMT1725360123ABC12345def67890",
        "email": "example123@gmail.com",
        "service": "Facebook Registration",
        "status": "cleaned",
        "cost": 0,
        "expires_at": "2025-09-03 16:05:30",
        "message": "Email đã được reorder thành công và sẵn sàng nhận OTP mới"
    }
}

Xử lý lỗi thường gặp

Lỗi xác thực

{
    "status": "error",
    "msg": "Thông tin đăng nhập không chính xác"
}

Giải pháp: Kiểm tra lại username/password

Lỗi số dư

{
    "status": "error",
    "msg": "Số dư không đủ, vui lòng nạp thêm"
}

Giải pháp: Nạp thêm tiền vào tài khoản

Lỗi rate limiting

{
    "status": "error",
    "msg": "Bạn đang thao tác quá nhanh, vui lòng chờ"
}

Giải pháp: Chờ một thời gian rồi thử lại

Lỗi hệ thống

{
    "status": "error",
    "msg": "Dịch vụ Gmail OTP tạm thời không khả dụng, vui lòng thử lại sau"
}

Giải pháp: Thử lại sau vài phút

Best Practices

Polling thông minh: Chỉ kiểm tra OTP mỗi 3-5 giây, không quá nhanh để tránh spam bị block
Service ID linh hoạt: Có thể sử dụng cả số (1-5) và chuỗi (facebook_reg, instagram_reg, tiktok_reg, x_reg, amazon_reg)
Error handling: Luôn kiểm tra status trước khi xử lý data
Logging: Ghi log tất cả request/response để debug
Retry mechanism: Thử lại với backoff khi gặp lỗi tạm thời
Security: Không hardcode username/password trong code (để tránh bị lạm dụng tài khoản bởi hacker)

Hỗ trợ

Email: kimtaimmo@gmail.com

Zalo: 0876277977 (Kim Tài)

Telegram: Đang Update