Moderasyon gücü,
kodunuzdan çağrılabilir
Telm'i kendi sistemlerinize bağlayın: herhangi bir metni üretimdeki anti-spam motoruyla kontrol edin, grup ayarlarını ve kurallarını koddan yönetin, karar günlüğünü ve analizi okuyun — hepsi, kontrolü sizde olan anahtarlarla temiz bir REST API üzerinden.
- Kararlı REST v1
- Her planda spam kontrolü
- Webhook'lar dahil
İlk çağrınız 30 saniyede
SDK merasimi yok: anahtarınızla bir HTTPS çağrısı yeterli.
$ 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"]
}Tek istek, üretim motorundan tek hüküm — bir puan ve tetiklenen nedenlerle. Kural tabanlı kontrollerde yanıt bir saniyenin çok altında gelir.
API neler yapabilir
Spam ve kullanıcı kontrolleri
Herhangi bir metni, Telm gruplarını koruyan aynı motordan geçirin — tekli çağrılar, 20'ye kadar toplu istekler ve CAS ile Telm'in kendi veri kümesine karşı kullanıcı taraması.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGruplar ve ayarlar
Koruma ayarlarını okuyun ve patch'leyin, özel moderasyon kurallarını ve beyaz listeyi yönetin — tek bir grup için ya da koca bir filo için.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistGünlük ve analiz
Her motor kararını hüküm, puan ve tetiklenen kurallarla okuyun, günlük analiz serilerini çekin ve kendi kota kullanımınızı takip edin.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageWebhook yönetimi
Webhook uç noktaları oluşturun ve yönetin, test ping'leri gönderin ve teslimat geçmişini inceleyin — tamamen API üzerinden.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesDürüst limitler, kutunun üstünde yazılı
| Plan | Günlük çağrı | Hız limiti | API erişimi |
|---|---|---|---|
| Free | 100 | 60/min | Spam kontrolü |
| Basic | 1 000 | 60/min | Spam kontrolü |
| Pro | 10 000 | 600/min | Tam API + webhook'lar |
| Business | 50 000 | 1 800/min | Tam API + webhook'lar |
Limitler anahtar başına değil, hesap başına geçerlidir. Her yanıt X-Quota-Limit, X-Quota-Used ve X-Quota-Reset başlıklarını taşır ve bir limite ulaşıldığında Retry-After ile temiz bir 429 döner — sürpriz yok.
Olması gerektiği gibi kurulmuş anahtarlar
Bir kez gösterilir, hash'lenerek saklanır
Tam anahtar tam olarak bir kez, oluşturulurken görünür. Telm yalnızca bir hash saklar — biz dahil hiç kimse anahtarınızı geri okuyamaz.
Okuma/yazma kapsamları
Anahtarlar okuma ve yazma kapsamları taşır. Raporlama betiğinize yalnızca okuma anahtarı verin — fiziksel olarak hiçbir ayarı değiştiremez.
Anında iptal
Herhangi bir anahtarı panodan iptal edin; anında çalışmayı durdurur. Hesap başına bir kill switch tüm API erişimini tek seferde dondurabilir.
Tam API ve webhook'lar Pro ve Business'ta bulunur. Spam kontrolü, Free dahil her planda, günlük kota içinde kullanılabilir.
Aynı motor, artık sizin kontrolünüzde
Herkese açık API, Telm'in botunu çalıştıran moderasyon motorunun aynısını sunar — basitleştirilmiş bir taklit değil. /spam/check'e POST ile bir metin gönderin; metin, gruplarınızın kullandığı boru hattının tıpatıp aynısından geçer: itibar sinyalleri, kurallar ve isteğe bağlı olarak AI sınıflandırıcısı. Bu, Telm'in kararını her yere gömebileceğiniz anlamına gelir: bir destek formu, kendi botunuz, bir yorum bölümü, dahili bir araç.
Kontrollerin ötesinde API, gruplarınızı kod olarak yönetir. Koruma ayarlarını okuyup patch'leyin, moderasyon kuralları oluşturun, beyaz listeleri sürdürün — panodakiyle aynı işlemler, ama betiklenebilir. Onlarca topluluk yöneten ajanslar, bir politika değişikliğini onlarca tık yerine tek bir döngüyle yayabilir.
Geçmiş birinci sınıftır: günlük uç noktası, motorun verdiği her kararı döndürür — hüküm, puan, hangi kuralların tetiklendiği, hangi eylemin yapıldığı — arşivleme için tasarlanmış imleç sayfalamayla. Analiz uç noktasıyla birleştirildiğinde, grubunuzun gerçek verileri üzerine uyumluluk arşivleri, dahili panolar veya uyarı sistemleri kurabilirsiniz.
Kimlik doğrulama bilinçli olarak sıkıcıdır: panonuzda oluşturduğunuz, bir kez gösterilen, hash'lenerek saklanan bearer anahtarları; okuma/yazma kapsamları ve anında iptalle. Her yanıt kota başlıkları taşır, böylece entegrasyonunuz her zaman nerede olduğunu bilir.
Frequently asked questions
Which plans include API access?
Spam checking (/spam/check) works on every plan, including Free, within the daily quota. The full API — group settings, rules, journal, analytics, user screening and webhooks — is included in Pro and Business.
What are the request limits?
Daily quotas by plan: Free 100, Basic 1,000, Pro 10,000, Business 50,000 calls. Rate limits: 60 requests per minute on Free and Basic, 600 on Pro, 1,800 on Business. Every response includes X-Quota-Limit, X-Quota-Used and X-Quota-Reset headers.
How do I get an API key?
In the dashboard under Settings → API & Webhooks. The key is shown once at creation — only its hash is stored. You can hold up to 10 active keys, scope them to read-only, and revoke any of them instantly.
Can the AI classifier be used through the API?
AI checks consume the plan’s separate daily AI quota: Basic 100, Pro 1,000, Business 10,000 (Free has none).
Is there an OpenAPI specification?
Yes, the full machine-readable OpenAPI 3.1 spec is published alongside the developer documentation, so you can generate clients or plug it into your tooling.
İlgili özellikler
Telm'un topluluğunuza yardımcı olabileceği diğer yolları keşfedin