Skip to content

连通性与分类

POST /ping

检查签名和账户状态,同时返回钱包余额、币种与会员等级。请求体为空。

http
POST /api/v1/upstream/ping HTTP/1.1
Host: cheapemail.cc
Dujiao-Next-Api-Key: <api_key>
Dujiao-Next-Timestamp: <unix_timestamp>
Dujiao-Next-Signature: <signature>
Content-Type: application/json
json
{
  "ok": true,
  "site_name": "CheapEmail",
  "protocol_version": "1.0",
  "user_id": 42,
  "balance": "1000.00",
  "currency": "CNY",
  "member_level": {
    "id": 1,
    "name": { "zh-CN": "黄金会员", "en": "Gold" },
    "slug": "gold",
    "icon": "https://example.com/gold.png"
  }
}

GET /categories

获取已启用的分类。分类最多两层,parent_id = 0 表示一级分类。

字段类型说明
idnumber分类 ID
parent_idnumber父分类 ID
slugstring唯一标识
nameobject多语言名称
iconstring图标 URL
sort_ordernumber排序权重,降序
json
{
  "ok": true,
  "categories": [
    {
      "id": 1,
      "parent_id": 0,
      "slug": "email",
      "name": { "zh-CN": "邮箱", "en": "Email" },
      "icon": "",
      "sort_order": 10
    }
  ]
}

CheapEmail Open API Documentation