API nhận SMS xác minh

Mua số và đọc mã xác minh qua một API JSON. Không KYC, chỉ tiền mã hóa.

REST · JSONOpenAPI 3.1 Đặc tả OpenAPI →

Các phần của API ghép với nhau ra sao?

1. Tạo tài khoản và lưu cụm từ hạt giống nhận được. Đó là thông tin xác thực duy nhất và không đặt lại được.
2. Tạo một lần nạp, gửi tiền mã hóa, rồi chờ được ghi có.
3. Mua số cho dịch vụ và quốc gia bạn cần — số dư bị trừ ngay lập tức.
4. Hỏi mã SMS theo chu kỳ. Không mã nào đến trước khi đơn hết hạn thì tự hoàn tiền.

Nạp một lần, mua nhiều lần: một lần nạp đủ cho bao nhiêu số thì tùy số dư vươn tới đâu, nên chỉ lần mua đầu tiên phải chờ xác nhận.

Xác thực

Gửi cụm từ hạt giống của tài khoản dưới dạng token bearer. Không có khóa API riêng và không có lệnh đăng nhập — cụm từ hạt giống chính là thông tin xác thực.

Authorization: Bearer YOUR-SEED-PHRASE

Các endpoint danh mục hoàn toàn không cần xác thực, nên bạn có thể xem dịch vụ, quốc gia và giá trước khi có tài khoản. Mọi thứ đụng tới tiền hay đơn hàng đều cần tiêu đề đó.

URL gốc

Mọi endpoint đều tính tương đối với:

https://otpdrop.com/api/v1

Phản hồi ở dạng JSON. Thân yêu cầu POST nhận cả application/json lẫn application/x-www-form-urlencoded.

Lỗi

Khi hỏng, hệ thống trả về mã trạng thái ngoài 2xx cùng một đối tượng lỗi duy nhất.

{
  "error": {
    "code": "invalid_request",
    "message": "unknown service: \"whatsap\""
  }
}

Các thông báo 422 thường gặp:

Có giới hạn tần suất không?

Không có hạn mức công bố và cũng không có khóa API nào để bóp, nhưng gọi endpoint trong vòng lặp thì không miễn phí. Hai trong số đó là endpoint để hỏi theo chu kỳ và đáng được cẩn thận riêng.

Lưu lượng trông như một cuộc tấn công sẽ bị chặn ngay ở rìa mạng, không kèm mã 429 lịch sự nào. Nếu bạn có lý do chính đáng để hỏi dồn hơn, hãy nhắn trước qua trang liên hệ.

Một tích hợp hoàn chỉnh trông ra sao?

Từ tài khoản tới mã trong sáu lần gọi. Mọi thứ bên dưới đều thật: dán vào là chạy.

# 1. Tạo tài khoản và giữ cụm từ hạt giống
SEED=$(curl -s -X POST https://otpdrop.com/api/v1/accounts | jq -r .seed)

# 2. Nạp tiền — gửi coin_amount tới địa chỉ nhận được
curl -s -X POST https://otpdrop.com/api/v1/topups \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"amount_usd": 25, "coin": "USDT"}'

# 3. Hỏi cho tới khi tiền nạp được ghi có
curl -s https://otpdrop.com/api/v1/topups/TOPUP_ID \
  -H "Authorization: Bearer \$SEED" | jq .status

# 4. Xem giá trước khi quyết
curl -s 'https://otpdrop.com/api/v1/quote?service=telegram&country=us'

# 5. Mua — số dư bị trừ và số được cấp ngay
ORDER=$(curl -s -X POST https://otpdrop.com/api/v1/orders \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"service": "telegram", "country": "us"}' | jq -r .order_id)

# 6. Hỏi cho tới khi có mã
until curl -s https://otpdrop.com/api/v1/orders/\$ORDER/sms \
  -H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done

Vẫn trình tự đó trong Python, không cần shell:

import time, requests

API = "https://otpdrop.com/api/v1"
seed = requests.post(f"{API}/accounts").json()["seed"]
auth = {"Authorization": f"Bearer {seed}"}

topup = requests.post(f"{API}/topups", headers=auth,
                      json={"amount_usd": 25, "coin": "USDT"}).json()
print("send", topup["coin_amount"], topup["coin"], "to", topup["address"])

while requests.get(f"{API}/topups/{topup['topup_id']}",
                   headers=auth).json()["status"] != "credited":
    time.sleep(15)

order = requests.post(f"{API}/orders", headers=auth,
                      json={"service": "telegram", "country": "us"}).json()
print("number:", order["phone"])

while True:
    sms = requests.get(f"{API}/orders/{order['order_id']}/sms",
                       headers=auth).json()
    if sms["arrived"]:
        print("code:", sms["code"])
        break
    time.sleep(4)

Máy chủ MCP

Vẫn những thao tác đó, có sẵn qua Model Context Protocol tại https://otpdrop.com/mcp, dưới dạng mười một công cụ. Thêm vào Claude Code bằng:

claude mcp add --transport http otpdrop https://otpdrop.com/mcp

Cách thiết lập và danh sách công cụ đầy đủ nằm ở trang dành cho tác nhân.

Tệp khám phá

Các mô tả dịch vụ đọc được bằng máy, tất cả đều phục vụ mà không cần xác thực.

Câu hỏi thường gặp

API của OTPDrop có cần khóa API không?

Không. Không có gì để xin cấp và không có bước phê duyệt. Thông tin xác thực chính là cụm từ hạt giống của tài khoản, gửi dưới dạng token bearer, còn các endpoint danh mục thì không cần gì cả.

API của OTPDrop tốn bao nhiêu?

Không tốn gì ngoài chính những số bạn mua. Không thuê bao, không phí theo lượt gọi, không mức tối thiểu — bạn trả đúng giá như người dùng trang web.

Những ngôn ngữ lập trình nào dùng được với API?

Bất kỳ ngôn ngữ nào gửi được một yêu cầu HTTPS. Đây là JSON thuần trên HTTP kèm một tiêu đề bearer, nên không có SDK phải cài và cũng chẳng có gì phải chạy theo các bản phát hành của chúng tôi.

Nếu mã SMS không bao giờ đến thì sao?

Đơn hàng tự hoàn về số dư khi hết hạn, và bạn có thể hủy sớm hơn qua trang web. Bạn bị tính tiền cho mã đã được giao, không phải cho một lần thử.

API REST có giống máy chủ MCP không?

Giống, và đó là chủ ý. Mỗi endpoint REST là bản dịch của một lần gọi công cụ MCP, nên hai bên không thể lệch nhau: sửa bên này là sửa luôn bên kia. Hãy chọn cái nào hợp với ứng dụng của bạn.

Thử API mà không tốn tiền được không?

Danh mục, báo giá và việc tạo tài khoản đều miễn phí, nên bạn có thể dựng và thử gần như trọn bộ tích hợp trước khi nạp số dư. Chỉ việc mua mới tốn tiền.