1. 概述

邮箱开发者文档共包含库存查询，余额查询，提取邮箱 3 个接口，接下来将逐一介绍。

商品ID（所有项目请填写ID）

商品名称商品ID
短效hotmail带令牌                            1
短效outlook带令牌                            2
长效outlook带令牌                            3
长效hotmail带令牌                            4

2. 接口

2.1 查询库存接口

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

请求参数

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

响应参数

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

响应示例

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

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

2.2 查询余额接口

GET/POST /api/login.php

请求参数

参数名 类型 必填 说明
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
}

2.3 提取邮箱接口

GET/POST /api/getEmail.php

请求参数

参数名 类型 必填 说明
app_id string 是 商户ID，不能为空
app_key string 是 商户密钥，不能为空
commodity_id integer 是 商品ID，不能为空
num integer 是 提取数量，不能为空，范围1-2000

响应示例

成功响应：
{
    "code": 200,
    "msg": "success",
    "data": {
        "trade_no": "20240505123456789",
        "request_no": "20240505123456789",
        "order_id": 123,
        "cards": [
            "skyyuopz28@outlook.com---F98DQ61",
            "sky59dqwdq@outlook.com---HYGH8C6"
        ]
    }
}

错误响应：
{
    "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": "余额不足"
}

状态码说明

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