外观
连通性与分类
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/jsonjson
{
"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 表示一级分类。
| 字段 | 类型 | 说明 |
|---|---|---|
id | number | 分类 ID |
parent_id | number | 父分类 ID |
slug | string | 唯一标识 |
name | object | 多语言名称 |
icon | string | 图标 URL |
sort_order | number | 排序权重,降序 |
json
{
"ok": true,
"categories": [
{
"id": 1,
"parent_id": 0,
"slug": "email",
"name": { "zh-CN": "邮箱", "en": "Email" },
"icon": "",
"sort_order": 10
}
]
}