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 | 스팸 검사 |
| Basic | 1 000 | 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는 여러분의 그룹을 코드로 관리합니다. 보호 설정을 읽고 패치하고, 모더레이션 규칙을 만들고, 화이트리스트를 유지하세요 — 대시보드와 동일한 작업이지만 스크립트로 처리할 수 있습니다. 수십 개의 커뮤니티를 운영하는 에이전시라면 수십 번의 클릭 대신 반복문 하나로 정책 변경을 배포할 수 있습니다.
이력 조회는 일급 기능입니다: 저널 엔드포인트는 엔진이 내린 모든 결정을 반환합니다 — 판정, 점수, 어떤 규칙이 발동했는지, 어떤 조치가 취해졌는지 — 아카이빙에 맞춰 설계된 커서 페이지네이션과 함께요. 분석 엔드포인트와 결합하면 그룹의 실제 데이터 위에 컴플라이언스 아카이브, 내부 대시보드, 알림 체계를 구축할 수 있습니다.
인증은 일부러 단조롭게 만들었습니다: 대시보드에서 생성한 베어러 키는 한 번만 표시되고, 해시로 저장되며, 읽기/쓰기 범위와 즉시 폐기 기능을 갖춥니다. 모든 응답에는 할당량 헤더가 실려 있어, 여러분의 연동이 언제나 자신의 상태를 알 수 있습니다.
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.