JSON · HTTPS · Khóa Bearer

Nhận mã xác minh và gửi SMS bằng một SMS API

API của TODAY SMS là API dành cho nhà phát triển, kết hợp API xác minh SMS để nhận mã trên số dùng một lần và API gửi SMS để gửi đến 227 quốc gia, với một API key và một số dư. Mọi yêu cầu và phản hồi đều là JSON, giá và quy định hoàn tiền giống như trên trang web.

Xem tài liệu API Đăng ký và nhận key

today-sms.com/api/v1

$ curl -X POST https://today-sms.com/api/v1/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app":"telegram","country":"indonesia"}'
{
  "id": "N-7K2M-QX4P-9D3A",
  "phone": "+6281234567890",
  "price": "0.4515",
  "status": "waiting",
  "expires_at": "2026-10-18T09:20:00.000Z"
}

$ curl https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "received",
  "sms": [
    { "code": "482913", "text": "Your code is 482913", "at": "2026-10-18T09:02:11.000Z" }
  ]
}

$ curl -X POST https://today-sms.com/api/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":["+14155550100","+447700900123"],"text":"Your code is 482913"}'
{
  "id": "m_7Q2K9X",
  "status": "queued",
  "recipients": 2,
  "parts": 1,
  "encoding": "GSM-7",
  "cost": "0.0136"
}

$ curl https://today-sms.com/api/v1/messages/m_7Q2K9X \
  -H "Authorization: Bearer YOUR_API_KEY"

300 yêu cầu mỗi phút
Một key để nhận và gửi
Thất bại hoặc không nhận được thì hoàn vào số dư
Nạp tiền với 12 phương thức tiền mã hóa

Những gì bạn làm được với SMS API

API xác minh SMS

Chọn ứng dụng và quốc gia, mua số và kiểm tra trạng thái định kỳ để lấy mã xác minh. Nếu không có SMS, toàn bộ số tiền sẽ trả về số dư khi hết thời gian.

API gửi SMS

Gửi tin của bạn đến tối đa 1,000 người nhận cùng lúc và nhận báo cáo gửi cho từng người nhận. Thêm thời gian hẹn để gửi vào lúc đó.

API giá và số còn lại

Lấy quốc gia và giá theo ứng dụng, số lượng số và giá mỗi tin của từng quốc gia qua API, rồi hiển thị nguyên vẹn trong dịch vụ của bạn.

Một số dư

Nhận và gửi dùng chung một số dư. Nạp bằng USDT và kiểm tra bất cứ lúc nào qua API.

Tổng quan các phương thức

Tài liệu đầy đủ

Phương thức	Chức năng
GET/balance	Xem số dư
GET/apps	Danh sách ứng dụng
GET/prices?app=telegram	Quốc gia và giá của một ứng dụng
POST/numbers	Mua số
GET/numbers/{id}	Trạng thái số và SMS
POST/numbers/{id}/cancel	Hủy số
POST/numbers/{id}/finish	Hoàn tất số
GET/messages/prices	Giá SMS theo quốc gia
POST/messages	Gửi SMS
GET/messages/{id}	Trạng thái gửi và báo cáo gửi
POST/messages/{id}/cancel	Hủy lịch gửi

SMS API là gì?

SMS API là kết nối cho phép phần mềm của bạn nhận hoặc gửi SMS bằng các yêu cầu HTTP. Mã lệnh làm thay những gì một người bấm trên màn hình web, nên các việc lặp lại như kiểm thử đăng ký tự động, gửi mã xác minh và thông báo đơn hàng chạy mà không cần ai động tay.

API của TODAY SMS cung cấp cùng lúc hai thứ. Một là API xác minh SMS (API kích hoạt SMS) để nhận mã xác minh ứng dụng trên số dùng một lần, hai là API gửi SMS để gửi SMS đến điện thoại di động trên toàn thế giới. Cả hai dùng cùng URL, cùng API key và cùng số dư, nên không cần đăng ký hay nạp tiền riêng.

Tôi dùng API xác minh SMS thế nào?

Gồm bốn bước. Chọn mã ứng dụng với GET /apps và xem quốc gia, giá với GET /prices?app=CODE. Mua số với POST /numbers để nhận số và id của số, rồi gọi GET /numbers/{id} vài giây một lần để xem mã đã đến chưa. Khi có mã, đóng số với POST /numbers/{id}/finish.

Mỗi số chờ SMS trong 20 phút, và SMS đến cùng số trong thời gian đó không tốn thêm phí. Nếu không có SMS, toàn bộ số tiền sẽ trả về số dư khi hết thời gian, và nếu chưa có gì đến, bạn có thể tự hủy với POST /numbers/{id}/cancel từ giây thứ 120 sau khi mua. Khi cần tự động hóa xác minh ứng dụng hoặc API số ảo số lượng lớn, chỉ cần lặp lại quy trình này.

Tôi dùng API gửi SMS thế nào?

Gửi danh sách người nhận (to) và nội dung tin (text) đến POST /messages, bạn sẽ nhận lại id tin nhắn, số người nhận, số phần và tổng chi phí. Nhập người nhận ở định dạng quốc tế có + và mã quốc gia, tối đa 1,000 mỗi yêu cầu. Để hẹn giờ, đặt thời gian UTC vào at.

Sau khi gửi, xem báo cáo gửi cho từng người nhận với GET /messages/{id}. Có bốn trạng thái: pending, sent, delivered và failed, và số tiền của các phần có kết quả failed được cộng vào refunded và trả về số dư. Hủy lịch gửi chưa được gửi đi với POST /messages/{id}/cancel.

Dùng cùng phương thức này để gửi mã xác minh (OTP). Mỗi mã tính là một SMS, không có phí xác minh riêng, và bạn có thể lấy giá mỗi tin của từng quốc gia với GET /messages/prices để tính chi phí.

Nên chú ý gì khi chọn SMS API giá hợp lý?

Hãy nhìn vào tổng số tiền bạn thực sự trả, không chỉ giá mỗi tin trên bảng giá. TODAY SMS không có phí hằng tháng và chỉ tính các phần bạn gửi, còn các phần thất bại và mã xác minh không đến đều được hoàn vào số dư.

Tiếp theo, hãy xem xét quản lý khóa và giới hạn. Bạn nhận được một khóa API cho mỗi tài khoản và có thể tạo khóa mới bất cứ lúc nào, điều này sẽ chặn khóa cũ ngay lập tức. Yêu cầu được phép lên đến 300 mỗi phút, đủ cho hầu hết các quy trình tự động. Cuối cùng, hãy xem xét thanh toán. Bạn có thể nạp tiền bằng 12 phương thức tiền điện tử bao gồm USDT, USDC và BTC mà không cần thẻ, vì vậy bạn có thể bắt đầu ngay từ bất kỳ quốc gia nào.

Tôi nhận API key thế nào?

Tạo tài khoản, và khi lần nạp tiền đầu tiên được ghi vào số dư, bạn có thể tạo key trên trang API key. Key chỉ hiển thị một lần khi tạo, nên hãy lưu ở nơi an toàn. Gửi key với mọi yêu cầu trong header Authorization: Bearer.

Nếu nghĩ rằng key đã bị lộ, hãy tạo key mới trên trang API key. Key cũ ngừng hoạt động ngay. Bất kỳ ai có key đều có thể mua số hoặc gửi SMS bằng số dư của bạn, nên tuyệt đối không đặt key trong mã chạy trên trình duyệt hay kho mã công khai.

Kết nối SMS API ngay hôm nay

Đăng ký chỉ cần một token. Khi lần nạp tiền đầu tiên được ghi vào số dư, hãy tạo API key, dán một mẫu từ tài liệu và gửi yêu cầu đầu tiên.

Xem tài liệu API Đăng ký và nhận key