Developers

Xây dựng với API ChatTempMail

Email tạm thời với sức mạnh AI — REST API, đặc tả OpenAPI 3.1, máy chủ MCP, agent skill và webhook. Có khóa API và hộp thư dùng một lần trong chưa tới một phút.

Khởi động nhanh

Ba lệnh gọi tới mã xác minh đầu tiên. URL cơ sở: https://chat-tempmail.com. Mọi endpoint đều chấp nhận X-API-Key hoặc 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"

Tài nguyên máy đọc được

Các URL dự đoán được mà agent có thể khám phá theo tên:

Đặc tả OpenAPI 3.1

Schema REST API đầy đủ với operationId, tham số có kiểu và schema phản hồi. Cũng có tại /api/openapi.json và /.well-known/openapi.json.

llms.txt

Tổng quan trang và API bằng markdown, kèm mục when-to-use cho agent. Phục vụ dạng text/markdown khi bạn gửi Accept: text/markdown.

Máy chủ MCP

Truy cập công cụ gốc cho Claude, Cursor và VS Code. Chạy cục bộ qua npm: mcp-server-tempmail.

Agent skill

Skill cài đặt được, dạy agent lập trình quy trình đầy đủ: tạo hộp thư, thăm dò, xử lý bằng AI.

CLI và gói MCP

npx mcp-server-tempmail chạy độc lập như công cụ kiểu CLI; gói npm chính thức.

Xác thực

Không cần múa may OAuth: tạo khóa API trong trang Hồ sơ rồi gửi ở header. Khóa mang quyền giống tài khoản của bạn — tạo lại ngay nếu bị lộ.

1Đăng nhập và mở trang Hồ sơ
2Tạo khóa API (chỉ hiển thị một lần — lưu cẩn thận)
3Gửi kèm X-API-Key: YOUR_API_KEY (hoặc Authorization: Bearer YOUR_API_KEY) trong mọi yêu cầu

X-API-Key: YOUR_API_KEY

Webhook

Thay vì thăm dò, cấu hình webhook (POST /api/webhook) và ChatTempMail sẽ POST mọi thư đến URL của bạn kèm header X-Webhook-Event: new_message. Phản hồi 2xx nhanh; giao thất bại được thử lại, nên giữ endpoint idempotent.

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}'

Sandbox và giới hạn tốc độ

Không có sandbox riêng: mọi tài khoản đều tạo địa chỉ tạm thời miễn phí. Gói trả phí mở khóa thao tác AI (tóm tắt/dịch/QA/trích xuất), địa chỉ vĩnh viễn và tệp đính kèm. Endpoint danh sách trả 20 mục mỗi trang; phân trang theo con trỏ. Endpoint AI có giới hạn hằng ngày theo vai trò, hiển thị trong header phản hồi X-AI-Remaining.

Hỗ trợ

Câu hỏi, báo lỗi, đề xuất tính năng:

GitHub Email