账户余额
¥0.00
专属 API 密钥
点击密钥可复制。重新生成后旧密钥将立即失效,请妥善保管。
API 链接生成器和操作步骤
1输入目标站点和邮箱类型,生成买邮链接
目标站点 site
邮箱类型
2访问下方链接获取邮箱和订单号
获取邮箱链接(POST 同参数,点击可复制):
3使用上一步返回的订单号轮询验证码(建议每 3~5 秒一次)
查验证码链接(将 ORDER_ID 替换为实际订单号,点击可复制):
重要说明
- 邮件业务不提供上游 webhook,请使用轮询方式拉取验证码与邮件正文。
- 仅等待中订单可取消退款;已收到验证码的订单不可退款。
- 订单默认有效期约 20 分钟,过期后系统会按规则自动取消并处理退款。
API 接口文档
接口通过 apikey 查询参数鉴权,返回 JSON 格式,code=0 表示成功。
1. 查询邮箱库存
方法:GET
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
apikey | 是 | 你的专属 API 密钥 |
site | 是 | 目标站点域名,例如 x.com |
成功响应
{
"code": 0,
"message": "ok",
"data": {
"site": "x.com",
"domains": [
{
"domain": "gmail.com",
"sell_price_cny": 2.00,
"count": 120
}
]
}
}
2. 购买临时邮箱
方法:POST(兼容 GET);参数可放 query 或 JSON body。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
apikey | 是 | 你的专属 API 密钥 |
site | 是 | 目标站点域名 |
domain | 是 | 邮箱类型,例如 gmail.com |
成功响应
{
"code": 0,
"message": "ok",
"data": {
"order_id": "eml_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"site": "x.com",
"domain": "gmail.com",
"email": "[email protected]",
"status": "waiting",
"sell_price": 2.0,
"expired_at": "2026-07-13T10:20:00Z",
"balance": 98.0
}
}
3. 获取验证码与邮件内容
方法:GET,通过 order_id 轮询订单状态。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
apikey | 是 | 你的专属 API 密钥 |
order_id | 是 | 购买接口返回的订单号 |
成功响应(等待中)
{
"code": 0,
"message": "ok",
"data": {
"order_id": "eml_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"status": "waiting",
"email": "[email protected]",
"code": "",
"message": "",
"remaining_seconds": 980
}
}
成功响应(收到验证码)
{
"code": 0,
"message": "ok",
"data": {
"order_id": "eml_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"status": "code_received",
"email": "[email protected]",
"code": "123456",
"message": "Your verification code is 123456"
}
}
4. 取消订单(退款)
方法:POST(兼容 GET)。仅等待中且未出码订单可取消退款。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
apikey | 是 | 你的专属 API 密钥 |
order_id | 是 | 要取消的订单号 |
成功响应
{
"code": 0,
"message": "ok",
"data": {
"order_id": "eml_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"message": "订单已取消,费用已退回",
"balance": 100.00
}
}
5. 查询余额
方法:GET
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
apikey | 是 | 你的专属 API 密钥 |
成功响应
{
"code": 0,
"message": "ok",
"data": { "balance": 100.00 }
}
典型使用流程
- 查可用域名:先调用
/open/api/domains获取目标站点的域名、售价和库存。 - 购买邮箱:调用
/open/api/get-email,传入site+domain,得到order_id和邮箱地址。 - 轮询验证码:每隔 3~5 秒调用
/open/api/get-code查询状态;出码后从code和message读取结果。 - 取消退款:若不再需要,可调用
/open/api/cancel取消等待中订单并退费。 - 余额查询:调用
/open/api/balance获取最新余额。