พลังการดูแล
เรียกได้จากโค้ดของคุณ
เชื่อม Telm เข้ากับระบบของคุณเอง: ตรวจสอบข้อความใด ๆ ด้วยเอนจินกันสแปมระดับโปรดักชัน จัดการการตั้งค่าและกฎของกลุ่มจากโค้ด อ่านบันทึกการตัดสินและการวิเคราะห์ — ทั้งหมดผ่าน REST API ที่สะอาดตา ด้วยคีย์ที่คุณควบคุมเอง
- REST v1 ที่เสถียร
- ตรวจสแปมได้ทุกแพ็กเกจ
- รวม Webhook มาให้แล้ว
เรียกครั้งแรกภายใน 30 วินาที
ไม่ต้องยุ่งยากกับ SDK: แค่เรียก HTTPS พร้อมคีย์ของคุณก็พอ
$ 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"]
}หนึ่งคำขอ หนึ่งคำตัดสินจากเอนจินระดับโปรดักชัน — พร้อมคะแนนและเหตุผลที่ทำงาน การตอบกลับมาถึงในเวลาต่ำกว่าหนึ่งวินาทีมากสำหรับการตรวจแบบอิงกฎ
API ทำอะไรได้บ้าง
ตรวจสแปมและคัดกรองผู้ใช้
ส่งข้อความใด ๆ ผ่านเอนจินตัวเดียวกับที่ปกป้องกลุ่ม Telm — เรียกทีละครั้ง เป็นชุดได้สูงสุด 20 รายการ และคัดกรองผู้ใช้กับ CAS พร้อมชุดข้อมูลของ Telm เอง
POST /spam/checkPOST /spam/check-batchPOST /users/checkกลุ่มและการตั้งค่า
อ่านและแก้ไขการตั้งค่าการป้องกัน จัดการกฎการดูแลที่กำหนดเองและรายการอนุญาต — สำหรับกลุ่มเดียวหรือหลายกลุ่มพร้อมกัน
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistบันทึกและการวิเคราะห์
อ่านทุกการตัดสินของเอนจินพร้อมคำตัดสิน คะแนน และกฎที่ถูกกระตุ้น ดึงชุดข้อมูลวิเคราะห์รายวัน และติดตามการใช้โควตาของคุณเอง
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageการจัดการ Webhook
สร้างและจัดการปลายทาง webhook ส่ง ping ทดสอบ และตรวจสอบประวัติการส่ง — ทั้งหมดผ่าน API
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesขีดจำกัดที่ตรงไปตรงมา ระบุไว้ชัดเจน
| แพ็กเกจ | จำนวนครั้งต่อวัน | อัตราจำกัด | การเข้าถึง API |
|---|---|---|---|
| Free | 100 | 60/min | ตรวจสแปม |
| Pro | 10 000 | 600/min | API เต็มรูปแบบ + webhook |
| Business | 50 000 | 1 800/min | API เต็มรูปแบบ + webhook |
ขีดจำกัดคิดต่อบัญชี ไม่ใช่ต่อคีย์ ทุกการตอบกลับจะมีเฮดเดอร์ X-Quota-Limit, X-Quota-Used และ X-Quota-Reset ติดมา และเมื่อถึงขีดจำกัดจะคืนค่า 429 ที่ชัดเจนพร้อม Retry-After — ไม่มีอะไรเซอร์ไพรส์
คีย์ที่สร้างมาอย่างที่ควรจะเป็น
แสดงครั้งเดียว จัดเก็บเป็นแฮช
คีย์ฉบับเต็มจะปรากฏเพียงครั้งเดียวตอนสร้าง Telm จัดเก็บเฉพาะแฮชเท่านั้น — ไม่มีใครอ่านคีย์ของคุณย้อนกลับได้ รวมถึงเราเองด้วย
สโคป read/write
คีย์มีสโคป read และ write ให้สคริปต์ทำรายงานของคุณใช้คีย์แบบอ่านอย่างเดียว — มันจะไม่สามารถเปลี่ยนการตั้งค่าใด ๆ ได้เลย
เพิกถอนได้ทันที
เพิกถอนคีย์ใดก็ได้จากแดชบอร์ด แล้วมันจะหยุดทำงานทันที มีสวิตช์ตัดการทำงานระดับบัญชีที่แช่แข็งการเข้าถึง API ทั้งหมดได้ในคราวเดียว
API เต็มรูปแบบและ webhook รวมอยู่ในแพ็กเกจ Pro และ Business การตรวจสแปมใช้งานได้ทุกแพ็กเกจ — รวมถึง Free — ภายในโควตารายวัน
เอนจินเดียวกัน ที่นี่คุณควบคุมเอง
API สาธารณะเปิดให้เข้าถึงเอนจินการดูแลตัวเดียวกับที่ขับเคลื่อนบอทของ Telm — ไม่ใช่ของเลียนแบบแบบย่อ ส่งข้อความไปที่ POST /spam/check แล้วมันจะผ่านไปป์ไลน์เดียวกับที่กลุ่มของคุณใช้ ได้แก่ สัญญาณชื่อเสียง กฎต่าง ๆ และตัวจำแนก AI (ตามเลือก) นั่นหมายความว่าคุณสามารถฝังวิจารณญาณของ Telm ไว้ที่ใดก็ได้ ไม่ว่าจะเป็นฟอร์มซัพพอร์ต บอทของคุณเอง ส่วนแสดงความคิดเห็น หรือเครื่องมือภายใน
นอกเหนือจากการตรวจสอบ API ยังจัดการกลุ่มของคุณในรูปแบบโค้ด อ่านและแก้ไขการตั้งค่าการป้องกัน สร้างกฎการดูแล ดูแลรายการอนุญาต — เป็นการทำงานเดียวกับแดชบอร์ด แต่เขียนเป็นสคริปต์ได้ เอเจนซีที่ดูแลชุมชนนับสิบสามารถปรับเปลี่ยนนโยบายได้ด้วยลูปเดียว แทนที่จะคลิกนับสิบครั้ง
ประวัติเป็นเรื่องหลัก: เอนด์พอยต์ journal จะคืนทุกการตัดสินที่เอนจินทำ — คำตัดสิน คะแนน กฎใดที่ทำงาน และดำเนินการอะไร — พร้อมการแบ่งหน้าแบบเคอร์เซอร์ที่ออกแบบมาเพื่อการเก็บถาวร เมื่อรวมกับเอนด์พอยต์การวิเคราะห์ คุณสามารถสร้างคลังข้อมูลเพื่อการปฏิบัติตามข้อกำหนด แดชบอร์ดภายใน หรือการแจ้งเตือน บนข้อมูลจริงของกลุ่มคุณ
การยืนยันตัวตนถูกออกแบบให้เรียบง่ายโดยตั้งใจ: คีย์แบบ bearer ที่สร้างในแดชบอร์ด แสดงเพียงครั้งเดียว จัดเก็บเป็นแฮช พร้อมสโคป read/write และการเพิกถอนทันที ทุกการตอบกลับจะมีเฮดเดอร์โควตาติดมาด้วย ระบบเชื่อมต่อของคุณจึงรู้สถานะเสมอ
คำถามที่พบบ่อย
แพ็กเกจใดบ้างที่เข้าถึง API ได้?
การตรวจสแปม (/spam/check) ใช้ได้ทุกแพ็กเกจ รวมถึง Free ภายในโควตารายวัน ส่วน API เต็มรูปแบบ — การตั้งค่ากลุ่ม กฎ บันทึก การวิเคราะห์ การคัดกรองผู้ใช้ และ webhook — รวมอยู่ในแพ็กเกจ Pro และ Business
ขีดจำกัดคำขอมีเท่าไร?
โควตารายวันตามแพ็กเกจ: Free 100 ครั้ง, Pro 10,000 ครั้ง และ Business 50,000 ครั้ง อัตราจำกัด: 60 คำขอต่อนาทีใน Free, 600 ใน Pro และ 1,800 ใน Business ทุกการตอบกลับมีเฮดเดอร์ X-Quota-Limit, X-Quota-Used และ X-Quota-Reset
จะรับคีย์ API ได้อย่างไร?
ในแดชบอร์ด ที่ การตั้งค่า → API และ Webhooks คีย์จะแสดงเพียงครั้งเดียวตอนสร้าง — ระบบจัดเก็บไว้เฉพาะแฮชเท่านั้น คุณมีคีย์ที่ใช้งานอยู่ได้สูงสุด 10 คีย์ จำกัดให้เป็นแบบอ่านอย่างเดียวได้ และเพิกถอนคีย์ใดก็ได้ทันที
ใช้ตัวจำแนก AI ผ่าน API ได้ไหม?
ได้ บน Pro และ Business: เพิ่ม include_ai ลงในคำขอ /spam/check แล้วการตรวจด้วย AI แต่ละครั้งจะใช้โควตา API รายวันที่แยกต่างหาก — 1,000 ครั้งบน Pro และ 10,000 ครั้งบน Business บน Free การตรวจสแปมผ่าน API จะใช้เฉพาะกฎเท่านั้น โควตานี้ใช้กับการเรียก API เท่านั้น: การกลั่นกรองด้วย AI ภายในกลุ่ม Telegram ของคุณรวมอยู่ในทุกแพ็กเกจ
มีสเปก OpenAPI ไหม?
มี สเปก OpenAPI 3.1 ฉบับเต็มที่เครื่องอ่านได้เผยแพร่ไว้คู่กับเอกสารสำหรับนักพัฒนา คุณจึงสร้างไคลเอนต์หรือเชื่อมเข้ากับเครื่องมือของคุณได้ทันที
ฟีเจอร์ที่เกี่ยวข้อง
สำรวจวิธีอื่นๆ ที่ Telm สามารถช่วยชุมชนของคุณได้