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"]
}요청 하나, 운영 엔진의 판정 하나 — 점수와 발동한 이유까지 함께요. 규칙 기반 검사라면 응답은 1초가 채 되지 않아 도착합니다.
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웹훅 관리
웹훅 엔드포인트를 생성·관리하고, 테스트 핑을 보내며, 전송 이력을 확인하세요 — 전부 API를 통해서요.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveries정직한 한도, 상자에 그대로 인쇄된
| 플랜 | 일일 호출 수 | 속도 제한 | API 접근 |
|---|---|---|---|
| Free | 100 | 60/min | 스팸 검사 |
| Pro | 10 000 | 600/min | 전체 API + 웹훅 |
| Business | 50 000 | 1 800/min | 전체 API + 웹훅 |
한도는 키 단위가 아니라 계정 단위로 적용됩니다. 모든 응답에는 X-Quota-Limit, X-Quota-Used, X-Quota-Reset 헤더가 실려 있고, 한도에 도달하면 Retry-After가 담긴 깔끔한 429가 반환됩니다 — 예기치 못한 일은 없습니다.
마땅히 그래야 하는 방식으로 만든 키
한 번만 표시, 해시로 저장
전체 키는 생성 시 정확히 한 번만 표시됩니다. Telm은 해시만 저장하므로 — 우리를 포함해 그 누구도 여러분의 키를 다시 읽어낼 수 없습니다.
읽기/쓰기 범위
키는 읽기와 쓰기 범위를 갖습니다. 리포팅 스크립트에는 읽기 전용 키를 주세요 — 물리적으로 어떤 설정도 변경할 수 없습니다.
즉시 폐기
대시보드에서 아무 키나 폐기하면 즉시 작동을 멈춥니다. 계정 단위 킬 스위치로 모든 API 접근을 한 번에 동결할 수 있습니다.
동일한 엔진, 이제 여러분의 통제 아래
공개 API는 Telm 봇을 구동하는 바로 그 모더레이션 엔진을 노출합니다 — 단순화된 모조품이 아닙니다. /spam/check로 텍스트를 POST하면, 그것은 여러분의 그룹이 사용하는 것과 동일한 파이프라인을 그대로 거칩니다: 평판 신호, 규칙, 그리고 선택적으로 AI 분류기까지요. 즉 Telm의 판단을 어디에든 심을 수 있다는 뜻입니다 — 지원 양식, 여러분 자신의 봇, 댓글 영역, 내부 도구 어디에든지요.
검사 외에도, API는 여러분의 그룹을 코드로 관리합니다. 보호 설정을 읽고 패치하고, 모더레이션 규칙을 만들고, 화이트리스트를 유지하세요 — 대시보드와 동일한 작업이지만 스크립트로 처리할 수 있습니다. 수십 개의 커뮤니티를 운영하는 에이전시라면 수십 번의 클릭 대신 반복문 하나로 정책 변경을 배포할 수 있습니다.
이력 조회는 일급 기능입니다: 저널 엔드포인트는 엔진이 내린 모든 결정을 반환합니다 — 판정, 점수, 어떤 규칙이 발동했는지, 어떤 조치가 취해졌는지 — 아카이빙에 맞춰 설계된 커서 페이지네이션과 함께요. 분석 엔드포인트와 결합하면 그룹의 실제 데이터 위에 컴플라이언스 아카이브, 내부 대시보드, 알림 체계를 구축할 수 있습니다.
인증은 일부러 단조롭게 만들었습니다: 대시보드에서 생성한 베어러 키는 한 번만 표시되고, 해시로 저장되며, 읽기/쓰기 범위와 즉시 폐기 기능을 갖춥니다. 모든 응답에는 할당량 헤더가 실려 있어, 여러분의 연동이 언제나 자신의 상태를 알 수 있습니다.
자주 묻는 질문
어떤 플랜에 API 액세스가 포함되나요?
스팸 검사(/spam/check)는 Free를 포함한 모든 플랜에서 일일 할당량 범위 안에서 작동합니다. 그룹 설정, 규칙, 저널, 분석, 사용자 심사, 웹훅을 포함한 전체 API는 Pro와 Business에 포함됩니다.
요청 한도는 어떻게 되나요?
플랜별 일일 할당량은 Free 100회, Pro 10,000회, Business 50,000회 호출입니다. 속도 제한은 Free 분당 60회, Pro 600회, Business 1,800회 요청입니다. 모든 응답에는 X-Quota-Limit, X-Quota-Used, X-Quota-Reset 헤더가 포함됩니다.
API 키는 어떻게 받나요?
대시보드의 Settings → API & Webhooks에서 받을 수 있습니다. 키는 생성할 때 한 번만 표시되며, 해시만 저장됩니다. 활성 키는 최대 10개까지 보유할 수 있고, 읽기 전용으로 범위를 제한하거나 언제든지 즉시 폐기할 수 있습니다.
API로 AI 분류기를 사용할 수 있나요?
네, Pro와 Business에서 가능합니다. /spam/check 요청에 include_ai를 추가하면 AI 검사마다 별도의 일일 API 한도가 차감됩니다: Pro 1,000회, Business 10,000회. Free에서는 API 스팸 검사가 규칙으로만 이루어집니다. 이 한도는 API 호출에만 적용되며, Telegram 그룹 안의 AI 모더레이션은 모든 플랜에 포함되어 있습니다.
OpenAPI 명세가 있나요?
네. 기계가 읽을 수 있는 전체 OpenAPI 3.1 명세가 개발자 문서와 함께 공개되어 있어, 클라이언트를 생성하거나 사용 중인 도구에 연결할 수 있습니다.