生成随机邮箱

POST

http://email2.ymb1668.com/api/v2/user/mailboxes/random

最后修改时间：2026-04-29 09:29:36

为当前用户生成一个随机邮箱地址并关联。支持单域名 domain，也支持多域名 domains；当提供 domains 时，服务端会从可用候选域名中随机选择一个。

请求参数

Authorization

API Key

在 header 添加参数

X-API-Key

示例：

X-API-Key: ********************

Body 参数application/json

示例

{
    "prefix": "myprefix",
    "domain": "b-mail.xyz",
    "domains": [
        "b-mail.xyz",
        "b-web.xyz"
    ],
    "excludeDomains": [
        "xyz",
        "top"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://email2.ymb1668.com/api/v2/user/mailboxes/random' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "prefix": "myprefix",
    "domain": "b-mail.xyz",
    "domains": [
        "b-mail.xyz",
        "b-web.xyz"
    ],
    "excludeDomains": [
        "xyz",
        "top"
    ]
}'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "address": "randomprefix@b-web.xyz"
}

🟠400请求有误

🟠403权限不足

🟠409冲突

修改于 2026-04-29 09:29:36

生成随机邮箱 (GET方法)

批量生成随机邮箱 (GET方法)