Skip to content

快速开始

1. 申请 API 对接

进入 CheapEmail 用户后台的 API 对接处提交申请。审核通过后,即可在该页面生成 API Key / Secret。

2. 下载 Python 示例

安装依赖:

powershell
pip install -r requirements.txt

打开 test.py,只需填写顶部的三个配置:

python
BASE_URL = "https://cheapemail.cc"
API_KEY = "your_api_key"
API_SECRET = "your_api_secret"

3. 自动获取全部 SKU

可以先打开实时 SKU 列表,查看并复制 sku_code 及对应的商品规格和描述。

直接运行:

powershell
python test.py

脚本会自动读取 /products 的所有分页,并把每个 sku_code 与商品标题、描述、价格和库存关联起来:

text
共获取到 7 个 SKU:
SKU-1 | Outlook 邮箱 | 包含账号和密码 | 价格: 1.00 | 库存: in_stock (100)
SKU-2 | Outlook 邮箱 | 包含刷新令牌 | 价格: 2.00 | 库存: unlimited (-1)

也可以显式执行:

powershell
python test.py skus

sku_code 是下单时使用的可读编码。脚本会在内部自动找到 API 实际需要的数字 sku_id,不需要手工查询或填写 sku_id

4. 使用 SKU Code 下单

命令只需要两个参数:

text
python test.py order <sku_code> <quantity>

购买 2 件 SKU-1

powershell
python test.py order SKU-1 2

脚本会依次完成:

text
获取商品 → 根据 sku_code 找到 sku_id → 创建订单
→ 等待 delivered/completed → 保存购买数据

5. 购买数据格式

订单完成后,购买的数据位于:

text
fulfillment.payload

payload 是一个字符串,每条购买数据使用 \n 换行分隔,一行就是一条数据。例如购买 2 件时,API JSON 可能返回:

json
{
  "fulfillment": {
    "status": "delivered",
    "payload": "account-1----password-1\naccount-2----password-2"
  }
}

拆分后是:

text
account-1----password-1
account-2----password-2

test.py 会自动识别真实换行以及文本形式的 \n\r\n,过滤空行,并保存为:

text
orders/order_<order_no>.txt

保存后的 TXT 文件每行一条购买数据,可直接逐行读取。

Go 示例

powershell
$env:DUJIAO_API_KEY = "your_api_key"
$env:DUJIAO_API_SECRET = "your_api_secret"

go run dujiao_client.go -action skus
go run dujiao_client.go -action order -sku-code SKU-1 -quantity 2 -wait

CheapEmail Open API Documentation