API Hub 接口文档 v3.0

不传 ip 时自动解析请求来源 IP 并返回归属地；按优先级聚合多个数据源。

curl "https://example.com/ip"

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "success",
    "data": {
      "ip": "114.114.114.114",
      "version": "v4",
      "country": "中国",
      "province": "江苏省",
      "city": "南京市",
      "district": "玄武区",
      "isp": "中国电信",
      "countryCode": "CN",
      "provinceCode": "320000",
      "latitude": 32.0584,
      "longitude": 118.7965,
      "timezone": "Asia/Shanghai"
    },
    "source": "ip2region"
  },
  "serverTime": "2026-10-28 12:00:00.000",
  "elapsed": "45ms"
}

通过 query 传 ip，支持 IPv4 / IPv6。

curl "https://example.com/ip?ip=8.8.8.8"

source=数据源名 → 单源模式；source=all → 并发对比所有已启用源（data.data.sources）。

curl "https://example.com/ip?ip=8.8.8.8&source=all"

把 IP 放在路径里。IPv6 的冒号需 URL 编码为 %3A。

curl "https://example.com/ip/2400%3A3200%3A%3A1"

一次查询多个 IP；对比模式（source=all）不支持批量。

curl -X POST "https://example.com/ip" -H "Content-Type: application/json" -d '{"ips":["8.8.8.8","1.1.1.1"]}'

返回各数据源状态、优先级、字段优先级；用于探活与部署自检。

curl "https://example.com/ip/health"

返回纯文本客户端 IP（类似 ipify 的 text 接口）。

curl "https://example.com/ip/ip"

返回精简的国家 / 省 / 市信息。

curl "https://example.com/ip/geo"

返回 { ip, city, region, country }，可直接替换 ipify。

curl "https://example.com/ip/json"

返回服务端时间与客户端时区信息。

curl "https://example.com/ip/time"

解析请求 UA（浏览器 / 系统 / 设备等）。

curl "https://example.com/ip/ua"

原样返回请求头，便于调试转发链路（如 CDN / 反代）。

curl "https://example.com/ip/headers"

两种模式：① 服务端 SMTP（环境变量）直发，无需鉴权；② 请求体带 smtp 字段由客户端指定发件服务，需 EMAIL_KEY + Email-Key 授权。发件人取自对应 SMTP 配置。

# 模式一：传统模式（服务端 SMTP 直发，无需鉴权，受白名单约束）
curl -X POST "https://example.com/email" \
  -H "Content-Type: application/json" \
  -d '{"to":"a@b.com","subject":"hi","text":"hello"}'

# 模式二：含 cc / bcc / replyTo 完整示例
curl -X POST "https://example.com/email" \
  -H "Content-Type: application/json" \
  -d '{"to":"a@b.com","cc":"cc@b.com","bcc":"bcc@b.com","replyTo":"reply@b.com","subject":"hi","text":"hello"}'

# 模式三：自定义发件服务（需 EMAIL_KEY + Email-Key），含 from 与 port
curl -X POST "https://example.com/email" \
  -H "Content-Type: application/json" \
  -H "Email-Key: <你的KEY>" \
  -d '{"to":"a@b.com","subject":"hi","text":"hello","smtp":{"host":"smtp.qq.com","port":465,"from":"me@qq.com","pass":"授权码"}}'

# 模式四：环境变量模式 + 自定义发件人显示名（fromName），无需鉴权
curl -X POST "https://example.com/email" \
  -H "Content-Type: application/json" \
  -d '{"to":"a@b.com","subject":"hi","text":"hello","fromName":"系统通知"}'

{
  "code": 0,
  "message": "success",
  "data": {
    "messageId": "<112050c2d1833f74c0a68481db205987@126.com>",
    "accepted": [
      "a@b.com"
    ],
    "provider": "smtp.126.com:465",
    "channel": "smtp",
    "sendMs": 573
  },
  "serverTime": "2026-10-28 12:00:00.000",
  "elapsed": "580ms"
}

检查 SMTP 配置是否就绪（不真实发信），兼容 GET。

curl -X POST "https://example.com/email/health"