当前公开 Web API 说明，接口路径与线上保持一致
https://getgmailstore.com/api欢迎使用 GmailStore 当前公开 Web API。本页只是线上接口说明，只描述生产环境已经存在的接口，不提供 API Key 申请、调用统计或开发者控制台功能。
###
所有公开接口都使用主站同域名：
https://getgmailstore.com/api###
curl -X GET https://getgmailstore.com/api/products###
当前接口返回 JSON，通常包含 success 字段：
{
"success": true,
"products": []
}###
本页只是当前线上接口说明，不是开发者控制台。用户通过接口下单购买账号时，余额支付会按订单金额扣款；API 调用本身不单独收费。需要自动化采购或专用接入时，请先联系管理员开通。
当前公开商品和订单查询接口不需要 API Key。完成订单可通过“订单号 + 联系邮箱”查询账号明细。
余额支付需要用户登录后的 Bearer Token。登录接口返回的 token 可放在请求头：
Authorization: Bearer USER_TOKEN登录接口：
POST /api/auth/login请求体：
{
"email": "[email protected]",
"password": "your-password"
}GET /api/productsGET /api/products/:idOrSlugGET /api/orders/query?order_no=...&email=...（完成订单会返回账号和密码；同 IP 60 秒最多 3 次，同订单号+邮箱 60 秒最多 2 次）GET /api/orders/:id/status?token=...（带订单访问令牌时返回账号明细）POST /api/orders/create 创建订单时，如果支付方式为余额支付：
balance_cnybalance_crypto请求需要带用户登录后的 Bearer Token。其他支付方式，例如 crypto，不强制要求登录。
通过接口下单购买账号时，系统会按订单金额从账户余额扣款；API 调用本身不单独收费。
/api/admin/*、/api/orders/clean 等接口不是公开 API。它们需要管理员 Token 或服务器内部密钥，不应给普通用户调用。
GET /api/products返回所有上架商品及单价。
响应示例：
{
"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
}
]
}GET /api/products/:idOrSlug支持用产品 id 或 slug 查询。
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：
Authorization: Bearer USER_TOKEN加密货币支付示例：
{
"productId": "30a6d792-9e06-4023-85f4-736dfd9af07d",
"quantity": 10,
"contactEmail": "[email protected]",
"paymentMethod": "crypto",
"coin": "trc20_usdt"
}人民币余额支付示例：
{
"productId": "30a6d792-9e06-4023-85f4-736dfd9af07d",
"quantity": 10,
"contactEmail": "[email protected]",
"paymentMethod": "balance_cny"
}GET /api/orders/query?order_no=GS2604291234ABCD&[email protected]必须同时提供订单号和邮箱。订单已完成时，此接口会返回该订单的账号和密码；接口已开启频率限制：同 IP 60 秒最多 3 次，同订单号+邮箱组合 60 秒最多 2 次。
GET /api/orders/:id/statusimport requests
BASE_URL = "https://getgmailstore.com/api"
# 获取产品列表
response = requests.get(f"{BASE_URL}/products")
products = response.json()["products"]
# 创建订单
order = requests.post(
f"{BASE_URL}/orders/create",
json={
"productId": products[0]["id"],
"quantity": 10,
"contactEmail": "[email protected]",
"paymentMethod": "crypto",
"coin": "trc20_usdt"
}
)
print(order.json())const BASE_URL = "https://getgmailstore.com/api";
// 获取产品列表
const products = await fetch(`${BASE_URL}/products`);
const productList = await products.json();
console.log(productList);
// 创建订单
const order = await fetch(`${BASE_URL}/orders/create`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
productId: productList.products[0].id,
quantity: 10,
contactEmail: "[email protected]",
paymentMethod: "crypto",
coin: "trc20_usdt",
}),
});
console.log(await order.json());# 获取产品列表
curl -X GET https://getgmailstore.com/api/products
# 创建订单
curl -X POST https://getgmailstore.com/api/orders/create \
-H "Content-Type: application/json" \
-d '{"productId":"30a6d792-9e06-4023-85f4-736dfd9af07d","quantity":10,"contactEmail":"[email protected]","paymentMethod":"crypto","coin":"trc20_usdt"}'
# 人民币余额支付
curl -X POST https://getgmailstore.com/api/orders/create \
-H "Content-Type: application/json" \
-H "Authorization: Bearer USER_TOKEN" \
-d '{"productId":"30a6d792-9e06-4023-85f4-736dfd9af07d","quantity":10,"contactEmail":"[email protected]","paymentMethod":"balance_cny"}'| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数错误 |
| 401 | 需要登录或内部密钥 |
| 403 | 权限不足 |
| 404 | 资源不存在 |
| 500 | 服务器内部错误 |
| 错误信息 | 说明 |
|---|---|
| Product not found | 产品不存在或已下架 |
| Insufficient stock | 库存不足 |
| Insufficient balance | 余额不足 |
| Minimum quantity is ... | 数量低于最低起订量 |
| Quantity cannot exceed 200 | 单次购买数量超过 200 |
| Please provide both order number and email | 查询订单时必须同时提供订单号和邮箱 |
{
"success": false,
"error": "Product not found"
}