API 端点
获取产品列表
text
GET /api/products返回所有上架商品及单价。
响应示例：
json
{
"success": true,
"products": [
{
"id": "30a6d792-9e06-4023-85f4-736dfd9af07d",
"slug": "gmail-usa-fresh",
"name_zh": "谷歌企业/教育邮箱",
"name_en": "Google Workspace / Education Email",
"stock": 44,
"min_quantity": 5,
"price":
0.5
}
]
}获取产品详情
text
GET /api/products/:idOrSlug支持用产品 id 或 slug 查询。
创建订单
text
POST /api/orders/create| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| productId | string | 是 | 产品 ID。必须使用 GET /api/products 返回的 id，不要使用 slug |
| quantity | integer | 是 | 购买数量。单次最多 200 个，且不能超过库存；最低数量以商品 min_quantity 为准 |
| contactEmail | string | 是 | 接收订单和查询订单用的邮箱 |
| paymentMethod | string | 是 | 支付方式。可写：crypto、balance_cny、balance_crypto、alipay、wechat |
| coin | string | 否 | 仅 paymentMethod=crypto 时必填。可写：trc20_usdt、erc20_usdt、bep20_usdt、btc、eth、trx、bnb |
| couponCode | string | 否 | 优惠码，不使用时可省略 |
paymentMethod 取值说明：
| 值 | 说明 | 是否需要 Bearer Token |
|---|---|---|
crypto | 加密货币链上支付，返回收款地址和应付金额 | 否 |
balance_cny | 人民币余额支付，按订单金额扣 users.balance | 是 |
balance_crypto | 虚拟币余额支付，按汇率折算后扣 users.balance_crypto | 是 |
alipay | 支付宝外部收银台支付，是否可用以 /api/payment-config 为准 | 否 |
wechat | 微信外部收银台支付，是否可用以 /api/payment-config 为准 | 否 |
余额支付需要在请求头中带登录后的用户 Token：
text
Authorization: Bearer USER_TOKEN加密货币支付示例：
json
{
"productId": "30a6d792-9e06-4023-85f4-736dfd9af07d",
"quantity": 10,
"contactEmail": "[email protected]",
"paymentMethod": "crypto",
"coin": "trc20_usdt"
}人民币余额支付示例：
json
{
"productId": "30a6d792-9e06-4023-85f4-736dfd9af07d",
"quantity": 10,
"contactEmail": "[email protected]",
"paymentMethod": "balance_cny"
}查询订单
text
GET /api/orders/query?order_no=GS2604291234ABCD&[email protected]必须同时提供订单号和邮箱。订单已完成时，此接口会返回该订单的账号和密码；接口已开启频率限制：同 IP 60 秒最多 3 次，同订单号+邮箱组合 60 秒最多 2 次。
查询订单支付/发货状态
text
GET /api/orders/:id/status