Developers

ChatTempMail API로 구축하기

AI의 힘을 더한 임시 이메일 — REST API, OpenAPI 3.1 사양, MCP 서버, 에이전트 스킬, 웹훅. API 키를 받으면 1분 안에 일회용 받은편지함을 사용할 수 있습니다.

퀵스타트

3번의 호출로 첫 인증 코드까지. 베이스 URL: https://chat-tempmail.com. 모든 엔드포인트는 X-API-Key 또는 Authorization: Bearer를 허용합니다.

1) List available domains

curl https://chat-tempmail.com/api/email/domains \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

2) Create a disposable address (1 hour)

curl -X POST https://chat-tempmail.com/api/emails/generate \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "test", "expiryTime": 3600000, "domain": "chat-tempmail.com"}'

3) Poll for messages

curl https://chat-tempmail.com/api/emails/{emailId} \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

머신 리더블 리소스

에이전트가 이름으로 발견할 수 있는 예측 가능한 URL:

OpenAPI 3.1 사양

operationId, 타입화된 파라미터, 응답 스키마를 갖춘 완전한 REST API 스키마. /api/openapi.json과 /.well-known/openapi.json에도 있습니다.

llms.txt

마크다운 형식의 사이트 및 API 개요. 에이전트용 when-to-use 섹션 포함. Accept: text/markdown을 보내면 text/markdown으로 응답합니다.

MCP 서버

Claude, Cursor, VS Code를 위한 네이티브 도구 접근. npm으로 로컬 실행: mcp-server-tempmail.

에이전트 스킬

받은편지함 생성 → 폴링 → AI 처리의 전체 워크플로를 코딩 에이전트에 가르치는 설치형 스킬.

CLI 및 MCP 패키지

npx mcp-server-tempmail은 CLI 방식 도구로 단독 실행 가능. 공식 npm 패키지.

인증

복잡한 OAuth 절차가 필요 없습니다. 프로필 페이지에서 API 키를 만들고 헤더로 전송하세요. 키는 계정과 동일한 권한을 가집니다. 유출 시 즉시 재생성하세요.

1로그인 후 프로필 페이지 열기
2API 키 생성 (한 번만 표시되므로 안전하게 보관)
3모든 요청에 X-API-Key: YOUR_API_KEY (또는 Authorization: Bearer YOUR_API_KEY) 포함

X-API-Key: YOUR_API_KEY

웹훅

폴링 대신 웹훅(POST /api/webhook)을 설정하면 ChatTempMail이 도착하는 모든 메시지를 X-Webhook-Event: new_message 헤더와 함께 사용자의 URL로 POST합니다. 2xx를 빠르게 응답하세요. 전송 실패 시 재시도되므로 엔드포인트는 멱등성을 유지해야 합니다.

Configure a webhook

curl -X POST https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook", "enabled": true}'

샌드박스 및 요율 제한

별도의 샌드박스는 없습니다. 모든 계정이 무료로 임시 주소를 만들 수 있습니다. 유료 플랜은 AI 작업(요약/번역/QA/추출), 영구 주소, 첨부 파일을 엽니다. 목록 엔드포인트는 페이지당 20개 항목을 반환하며 페이지네이션은 커서 기반입니다. AI 엔드포인트에는 역할별 일일 한도가 있으며 X-AI-Remaining 응답 헤더로 확인할 수 있습니다.

지원

질문, 버그 신고, 기능 요청:

GitHub 이메일