Caiden API — 临时邮箱 & 代理池服务

快速开始

1. 注册获取 API Key

发送 POST 请求，用邮箱注册即可获得 API Key 和 100 免费积分。

curl -X POST https://api.caiden.asia/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

# 响应：
# {"ok":true,"data":{"api_key":"sk_xxx...","user":{...},"credits":100}}

2. 创建临时邮箱

curl -X POST https://api.caiden.asia/api/v1/email/create \
  -H "Authorization: Bearer sk_xxx..."

# 响应：
# {"ok":true,"data":{"address":"abc123@domain.com","mailbox":{"id":1,...}},"credits":90}

3. 获取代理

curl "https://api.caiden.asia/api/v1/proxy/get?protocol=http&anonymity=elite" \
  -H "Authorization: Bearer sk_xxx..."

# 响应：
# {"ok":true,"data":{"ip":"1.2.3.4","port":8080,"protocol":"http","anonymity":"elite","latency_ms":230},"credits":99}

API 文档

所有需要认证的接口都要在 Header 中携带 Authorization: Bearer <api_key>

POST /api/v1/auth/register 注册获取 API Key（无需认证）

curl -X POST https://api.caiden.asia/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

GET /api/v1/auth/me 查看当前用户信息

curl https://api.caiden.asia/api/v1/auth/me \
  -H "Authorization: Bearer sk_xxx..."

GET /api/v1/auth/usage 查看使用记录

curl https://api.caiden.asia/api/v1/auth/usage \
  -H "Authorization: Bearer sk_xxx..."

📧 临时邮箱

POST /api/v1/email/create 创建临时邮箱（10 积分）

curl -X POST https://api.caiden.asia/api/v1/email/create \
  -H "Authorization: Bearer sk_xxx..."

# 响应包含 address（邮箱地址）和 mailbox.id（后续查信用）

GET /api/v1/email/list 列出所有邮箱

curl https://api.caiden.asia/api/v1/email/list \
  -H "Authorization: Bearer sk_xxx..."

GET /api/v1/email/{id}/messages 获取收件箱（自动同步新邮件）

curl https://api.caiden.asia/api/v1/email/1/messages \
  -H "Authorization: Bearer sk_xxx..."

# 轮询模式：每 4 秒调用一次，检查新邮件

GET /api/v1/email/{id}/messages/{msg_id} 读取邮件详情（1 积分）

curl https://api.caiden.asia/api/v1/email/1/messages/1 \
  -H "Authorization: Bearer sk_xxx..."

DELETE /api/v1/email/{id} 删除邮箱

curl -X DELETE https://api.caiden.asia/api/v1/email/1 \
  -H "Authorization: Bearer sk_xxx..."

🌐 代理池

GET /api/v1/proxy/get 获取随机代理（1 积分）

curl "https://api.caiden.asia/api/v1/proxy/get?protocol=http&anonymity=elite" \
  -H "Authorization: Bearer sk_xxx..."

# 可选参数：protocol (http/socks5), anonymity (elite/anonymous/unknown), country

GET /api/v1/proxy/list 批量获取代理列表（1 积分）

curl "https://api.caiden.asia/api/v1/proxy/list?page=1&limit=20&protocol=socks5" \
  -H "Authorization: Bearer sk_xxx..."

# 可选参数：page, limit (max 100), protocol, anonymity

GET /api/v1/proxy/stats 代理池统计（免费）

curl https://api.caiden.asia/api/v1/proxy/stats
# 无需认证，返回代理池总量、协议分布、匿名度分布等

临时邮箱 & 代理池

临时邮箱

代理池