GET /api/getStock.php?commodity_id=商品ID

请求参数

参数名	类型	必填	说明
commodity_id	integer	是	商品ID

响应参数

参数名	类型	说明
commodity_id	integer	商品ID
stock	integer	当前库存数量
name	string	商品名称

响应示例

成功响应：
{
    "commodity_id": 1,
    "num": 5656,
    "name": "hotmail"
}

错误响应：
{
    "code": 400,
    "message": "参数错误",
    "data": null
}

GET/POST /api/login.php?app_id=商户ID&app_key=商户秘钥

请求参数

参数名	类型	必填	说明
app_id	string	是	商户ID
app_key	string	是	商户密钥

响应示例

成功响应：
{
    "code": 200,
    "message": "验证成功",
    "data": {
        "id": "123",
        "username": "用户名",
        "balance": "100.00"
    }
}

错误响应：
{
    "code": 401,
    "message": "验证失败，app_id或app_key错误",
    "data": null
}

GET/POST /api/getEmail.php?app_id=商户ID&app_key=商户秘钥&commodity_id=商品ID&num=数量

请求参数

参数名	类型	必填	说明
app_id	string	是	商户ID，不能为空
app_key	string	是	商户密钥，不能为空
commodity_id	integer/string	是	商品ID，不能为空。 单商品购买：支持商品ID 1,2,3,4,13,14,15 多商品购买：仅支持商品ID 1,2,3,4 兼容用法：可直接传递多个商品ID，如 1,2,3,4 或 1234，系统会自动解析为多商品购买（仅限商品ID 1,2,3,4）
commodity_ids	string	否	多商品ID列表（仅支持商品ID 1,2,3,4；当commodity_id为1,2,3,4时有效），格式：1,2,3,4 或 1234
num	integer	是	提取数量，不能为空，范围1-2000
format	string	否	返回格式，默认json，可选simple（纯文本格式）

多商品购买功能 ⭐

重要说明：

• 单商品购买：支持商品ID 1, 2, 3, 4, 13, 14, 15
• 多商品购买：仅支持商品ID 1, 2, 3, 4，其他商品ID（如 13, 14, 15）不支持多商品购买功能

功能特点：

• 自动库存切换：如果某个商品库存不足，系统会自动尝试下一个商品
• 价格计算：按实际购买的商品价格计算总金额（不同商品可能有不同价格）
• 余额检查：使用所有可能商品中最贵的价格进行余额预检查
• 兼容性：支持直接在 commodity_id 参数中传递多个商品ID（如 commodity_id=1,2,3,4 或 commodity_id=1234），系统会自动解析为多商品购买模式

使用场景：当商品ID 1, 2, 3, 4 中某个商品库存不足时，自动从其他商品中购买，提高购买成功率。

format参数说明

默认格式（不传或 format=json）：返回完整JSON响应，包含订单信息、价格、折扣等。账号格式：账号----密码----client_id----refresh_token

简化格式（format=simple）：只返回纯文本账号信息，每行一个。账号格式：账号----密码----refresh_token----client_id（字段顺序与JSON不同）

响应示例

成功响应（JSON格式，默认，保持原顺序）：
{
    "code": 200,
    "msg": "success",
    "data": {
        "trade_no": "487251216113448472",
        "request_no": "953251216113448754",
        "cards": [
            "账号1----密码1----client_id1----refresh_token1",
            "账号2----密码2----client_id2----refresh_token2"
        ],
        "total_price": 0.0142,
        "original_price": 0.02,
        "discount": 0.0058,
        "discount_rate": "29%",
        "member_level": "新秀"
    }
}

成功响应（简化格式，format=simple，字段顺序调换）：
账号1----密码1----refresh_token1----client_id1
账号2----密码2----refresh_token2----client_id2
账号3----密码3----refresh_token3----client_id3

注意：simple格式将第3、4位字段调换，便于某些场景使用

错误响应：
{
    "code": 400,
    "msg": "app_id或app_key不能为空"
}

或

{
    "code": 400,
    "msg": "num和commodity_id不能为空"
}

数量范围错误：
{
    "code": 400,
    "msg": "提取数量必须在1-2000之间"
}

商品ID错误：
{
    "code": 400,
    "msg": "商品ID错误"
}

库存不足：
{
    "code": 400,
    "msg": "库存不足"
}

所有商品库存不足（多商品购买时）：
{
    "code": 400,
    "msg": "所有商品库存不足，已尝试: 商品ID2, 商品ID3, 商品ID4"
}

余额不足：
{
    "code": 400,
    "msg": "余额不足"
}

状态码说明

状态码	说明
200	请求成功
400	参数错误/库存不足/余额不足
401	验证失败，app_id或app_key错误
500	服务器错误

使用示例

# 单商品购买 - JSON格式（默认）
curl "https://你的域名/api/getEmail.php?app_id=1000&app_key=YOUR_KEY&num=10&commodity_id=1"

# 单商品购买 - 简化格式
curl "https://你的域名/api/getEmail.php?app_id=1000&app_key=YOUR_KEY&num=10&commodity_id=1&format=simple"

# 多商品购买示例（仅支持商品ID 1,2,3,4）
# 方式1：使用 commodity_ids 参数
curl "https://你的域名/api/getEmail.php?app_id=1000&app_key=YOUR_KEY&num=10&commodity_id=2&commodity_ids=1,2,3,4"

# 方式2：直接在 commodity_id 中传递多个商品ID（兼容用法）
curl "https://你的域名/api/getEmail.php?app_id=1000&app_key=YOUR_KEY&num=10&commodity_id=1,2,3,4"
curl "https://你的域名/api/getEmail.php?app_id=1000&app_key=YOUR_KEY&num=10&commodity_id=1234"

# PHP示例 - 单商品购买（简化格式）
$params = [
    'app_id' => 1000,
    'app_key' => 'YOUR_KEY',
    'num' => 10,
    'commodity_id' => 1,
    'format' => 'simple'
];
$response = file_get_contents('https://你的域名/api/getEmail.php?' . http_build_query($params));
echo $response; // 直接输出账号列表

# PHP示例 - 多商品购买
$params = [
    'app_id' => 1000,
    'app_key' => 'YOUR_KEY',
    'num' => 10,
    'commodity_id' => 2,
    'commodity_ids' => '1,2,3,4'  // 或 '1234'
];
$response = file_get_contents('https://你的域名/api/getEmail.php?' . http_build_query($params));
$result = json_decode($response, true);
if ($result['code'] == 200) {
    echo "购买成功！订单号: " . $result['data']['trade_no'] . "\n";
    echo "实际购买数量: " . count($result['data']['cards']) . "\n";
    foreach ($result['data']['cards'] as $card) {
        echo $card . "\n";
    }
}