Chuyển đến nội dung
HushSMS

API

Miễn phí trên mọi số, bất kể thời hạn. Không có gói doanh nghiệp, không tính phí theo đầu người, và không cần gọi bán hàng.

URL cơ sở

https://api.hushsms.com

Xác thực

Xác thực

Truyền token dòng của bạn dưới dạng thông tin xác thực bearer. Token được giới hạn cho một dòng và có thể xoay vòng từ bảng điều khiển.

curl https://api.hushsms.com/v1/lines \
  -H "Authorization: Bearer hs_live_..."

Tham khảo

Điểm cuối

GET/v1/lines

Liệt kê các số trong token của bạn. Trả về số, quốc gia, thời hạn và ngày hết hạn.

POST/v1/lines

Cấp một số. Body nhận country, line_type, term và pool. Trả về hóa đơn tiền điện tử.

GET/v1/lines/{id}/messages

Tin nhắn đến cho một số, mới nhất trước. Body bị xóa sau thời gian lưu trữ.

POST/v1/lines/{id}/messages

Gửi SMS đi. Bao gồm trong mọi gói.

GET/v1/catalog

Tồn kho quốc gia trực tiếp, tương thích từng dịch vụ và giá hiện tại. Không cần xác thực.

DELETE/v1/lines/{id}

Giải phóng số sớm. Không hoàn tiền cho gói tháng; theo tỷ lệ cho gói trên sáu tháng.

Đẩy thông báo

Webhook

Mọi tin nhắn đến đều được POST đến điểm cuối của bạn trong vòng một giây sau khi đến, được ký bằng HMAC-SHA256.

POST /your-endpoint
X-HushSMS-Signature: sha256=...

{
  "event": "message.received",
  "line_id": "ln_8fQ2...",
  "number": "+44 7700 900123",
  "from":   "+44 7700 900987",
  "body":   "Your code is 481920",
  "received_at": "2026-08-13T09:41:02Z"
}

Máy

Dành cho tác tử AI

Danh mục đọc được bằng máy tại https://hushsms.com/v1/catalog/. Nó trả về tồn kho quốc gia trực tiếp, khả năng tương thích theo dịch vụ và giá hiện tại dưới dạng JSON, không cần xác thực.

Open the catalog

Nó trả về tồn kho quốc gia trực tiếp, tương thích từng dịch vụ bao gồm các dịch vụ không hoạt động, giá hiện tại với mọi hệ số, và bảng lưu trữ dữ liệu. Không có khóa, không giới hạn tần suất đáng kể, và CORS mở. Nếu bạn xây dựng một agent cần số điện thoại, đây là endpoint nên đọc.

Tóm tắt văn bản của toàn bộ trang web có tại /llms.txt, với toàn bộ kho văn bản tại /llms-full.txt.

Danh mục như một hợp đồng có thể gọi

Kho văn bản thuần túy làm cho danh mục có thể đọc. Nó không làm cho nó có thể gọi: một agent đã đọc mọi chữ vẫn không biết hình dạng yêu cầu, danh sách các slug quốc gia, hoặc trường nào máy chủ bỏ qua, vì vậy nó có thể mô tả một số mà nó không thể mua. Khoảng cách đó là nơi chiến lược chỉ dùng nội dung dừng lại.

/openapi.json đóng khoảng cách đó — một tài liệu OpenAPI 3.1 bao gồm ba endpoint công khai, không xác thực (đọc danh mục, tạo đơn hàng, kiểm tra trạng thái), với danh sách country, term và pool được tạo từ cùng danh mục mà các handler kiểm tra. Nó cũng được khai báo trong head của tài liệu như rel="service-desc", để client tìm kiếm mô tả dịch vụ sẽ tìm thấy nó mà không cần được chỉ dẫn.

Mở mô tả OpenAPI

Nguồn

Dữ liệu kế hoạch đánh số trên trang này — mã quay số, độ dài số quốc gia, tiền tố tổng đài và dải di động — được lấy từ bộ E.164 của ITU-T. Tồn kho, giá cả và tỷ lệ thành công đo lường là của chúng tôi và được đánh dấu như vậy.

Kế hoạch đánh số đã xác minh

Nhận sốLiên hệ