Sức mạnh kiểm duyệt,
gọi được từ mã của bạn
Kết nối Telm vào hệ thống của riêng bạn: kiểm tra bất kỳ văn bản nào bằng bộ máy chống spam đang chạy production, quản lý thiết lập và quy tắc nhóm từ mã, đọc nhật ký quyết định và phân tích — tất cả qua một REST API gọn gàng với các khóa do bạn kiểm soát.
- REST v1 ổn định
- Kiểm tra spam trên mọi gói
- Bao gồm webhook
Lời gọi đầu tiên của bạn trong 30 giây
Không cần nghi thức SDK: một lời gọi HTTPS kèm khóa của bạn là đủ.
$ curl -X POST https://api.telm.com/api/public/v1/spam/check \
-H "Authorization: Bearer tk_live_..." \
-d '{"text": "Earn $500/day from home!! DM me now"}'
// HTTP 200
{
"verdict": "spam",
"score": 97,
"reasons": ["contact_flow", "money_lure"]
}Một yêu cầu, một phán quyết từ bộ máy production — kèm một điểm số và các lý do đã kích hoạt. Phản hồi tới trong chưa đầy một giây với các lượt kiểm tra dựa trên quy tắc.
API có thể làm gì
Kiểm tra spam & người dùng
Đưa bất kỳ văn bản nào qua chính bộ máy bảo vệ các nhóm Telm — gọi đơn lẻ, gọi theo lô tối đa 20, và sàng lọc người dùng đối chiếu CAS cùng tập dữ liệu riêng của Telm.
POST /spam/checkPOST /spam/check-batchPOST /users/checkNhóm & thiết lập
Đọc và cập nhật (patch) các thiết lập bảo vệ, quản lý quy tắc kiểm duyệt tùy chỉnh và danh sách trắng — cho một nhóm hay cả một đội nhóm.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistNhật ký & phân tích
Đọc mọi quyết định của bộ máy kèm phán quyết, điểm số và các quy tắc được kích hoạt, kéo về chuỗi phân tích theo ngày, và theo dõi mức sử dụng hạn mức của chính bạn.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageQuản lý webhook
Tạo và quản lý các endpoint webhook, gửi ping thử và xem lịch sử gửi — hoàn toàn qua API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesGiới hạn minh bạch, in ngay trên hộp
| Gói | Lượt gọi mỗi ngày | Giới hạn tốc độ | Quyền truy cập API |
|---|---|---|---|
| Free | 100 | 60/min | Kiểm tra spam |
| Basic | 1 000 | 60/min | Kiểm tra spam |
| Pro | 10 000 | 600/min | API đầy đủ + webhook |
| Business | 50 000 | 1 800/min | API đầy đủ + webhook |
Giới hạn áp dụng theo từng tài khoản, không theo từng khóa. Mọi phản hồi đều mang các header X-Quota-Limit, X-Quota-Used và X-Quota-Reset, và khi chạm giới hạn sẽ trả về mã 429 gọn gàng kèm Retry-After — không có bất ngờ.
Những khóa được dựng đúng như phải thế
Hiển thị một lần, lưu dưới dạng băm
Khóa đầy đủ xuất hiện đúng một lần, khi tạo. Telm chỉ lưu một bản băm (hash) — không ai, kể cả chúng tôi, có thể đọc lại khóa của bạn.
Phạm vi đọc/ghi
Khóa mang phạm vi đọc và ghi. Hãy cấp cho script báo cáo của bạn một khóa chỉ đọc — về mặt vật lý nó không thể thay đổi bất kỳ thiết lập nào.
Thu hồi tức thì
Thu hồi bất kỳ khóa nào từ bảng điều khiển và nó ngừng hoạt động ngay lập tức. Một công tắc ngắt khẩn cấp theo tài khoản có thể đóng băng toàn bộ quyền truy cập API cùng lúc.
API đầy đủ và webhook được bao gồm trong Pro và Business. Kiểm tra spam có trên mọi gói — kể cả Free — trong phạm vi hạn mức hằng ngày.
Cùng một bộ máy, giờ nằm dưới quyền kiểm soát của bạn
API công khai phơi bày chính bộ máy kiểm duyệt vận hành bot của Telm — không phải một bản mô phỏng giản lược. POST một văn bản tới /spam/check và nó đi qua đúng quy trình mà các nhóm của bạn dùng: tín hiệu uy tín, quy tắc, và tùy chọn bộ phân loại AI. Nghĩa là bạn có thể nhúng phán đoán của Telm vào bất cứ đâu: một biểu mẫu hỗ trợ, bot của riêng bạn, một khu bình luận, một công cụ nội bộ.
Ngoài việc kiểm tra, API còn quản lý các nhóm của bạn dưới dạng mã. Đọc và cập nhật (patch) thiết lập bảo vệ, tạo quy tắc kiểm duyệt, duy trì danh sách trắng — cùng những thao tác như trên bảng điều khiển, nhưng viết được thành script. Các agency vận hành hàng chục cộng đồng có thể triển khai một thay đổi chính sách bằng một vòng lặp thay vì hàng chục cú nhấp.
Lịch sử là hạng nhất: endpoint nhật ký trả về mọi quyết định bộ máy đưa ra — phán quyết, điểm số, quy tắc nào đã kích hoạt, hành động nào đã thực hiện — với phân trang bằng con trỏ (cursor) được dựng để lưu trữ. Kết hợp với endpoint phân tích, bạn có thể xây kho lưu trữ tuân thủ, bảng điều khiển nội bộ hay cảnh báo trên nền dữ liệu thật của nhóm mình.
Xác thực cố tình nhàm chán: khóa bearer tạo trong bảng điều khiển, hiển thị một lần, lưu dưới dạng băm (hash), có phạm vi đọc/ghi và thu hồi tức thì. Mọi phản hồi đều mang các header hạn mức để tích hợp của bạn luôn biết mình đang ở đâu.
Câu hỏi thường gặp
Những gói nào có quyền truy cập API?
Kiểm tra spam (/spam/check) hoạt động trên mọi gói, kể cả Free, trong phạm vi hạn mức hằng ngày. API đầy đủ — thiết lập nhóm, quy tắc, nhật ký, phân tích, sàng lọc người dùng và webhook — được bao gồm trong Pro và Business.
Giới hạn yêu cầu là bao nhiêu?
Hạn mức hằng ngày theo gói: Free 100, Basic 1.000, Pro 10.000, Business 50.000 lượt gọi. Giới hạn tốc độ: 60 yêu cầu mỗi phút trên Free và Basic, 600 trên Pro, 1.800 trên Business. Mọi phản hồi đều bao gồm các header X-Quota-Limit, X-Quota-Used và X-Quota-Reset.
Làm sao để lấy khóa API?
Trong bảng điều khiển ở mục Cài đặt → API & Webhooks. Khóa chỉ hiển thị một lần khi tạo — chỉ băm (hash) của nó được lưu. Bạn có thể giữ tối đa 10 khóa đang hoạt động, giới hạn phạm vi chỉ đọc, và thu hồi bất kỳ khóa nào tức thì.
Có thể dùng bộ phân loại AI qua API không?
Có — truyền include_ai vào /spam/check và phản hồi sẽ thêm phán quyết AI. Các lượt kiểm tra AI lấy từ một hạn mức AI hằng ngày riêng, có trên Pro và Business.
Có bản đặc tả OpenAPI không?
Có, bản đặc tả OpenAPI 3.1 đầy đủ, đọc được bằng máy, được công bố kèm tài liệu dành cho lập trình viên, để bạn có thể sinh ra client hoặc cắm nó vào công cụ của mình.
Nơi các đội sử dụng tính năng này
Những loại cộng đồng thực tế mà tính năng này gánh phần việc nặng nhất.
Điều hành chuyên nghiệp cho các nhóm công ty và cộng đồng khách hàng. Bảo vệ cấp doanh nghiệp với các nhật ký kiểm toán chi tiết.
Giữ cho các kênh hỗ trợ sạch sẽ khỏi spam trong khi cho phép người dùng mới đặt câu hỏi. Chế độ hỗ trợ giúp việc onboarding trở nên dễ dàng.
Bảo vệ nhóm tiền điện tử của bạn khỏi những kẻ lừa đảo, airdrop giả và liên kết lừa đảo — kể cả những trò lừa đảo giấu bên trong hình ảnh.
Tính năng liên quan
Khám phá thêm các cách Telm có thể giúp cộng đồng của bạn