random-email-generate
随机邮箱生成
支持批量生成随机邮箱地址,可自定义前缀长度、字符集(小写字母、数字)及指定域名,单次最多生成100条,适用于测试数据构造等场景。
调用价格
1 匠币/次
快速接入
保持统一返回结构,直接通过服务端发起请求即可接入。
https://openapi.toolkk.com/v1/random-email-generatecURL 示例
curl --request POST \
--url 'https://openapi.toolkk.com/v1/random-email-generate' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "count": 10,\n "minLength": 6,\n "maxLength": 10,\n "includeLowercase": true,\n "includeNumbers": true,\n "domains": [\n "gmail.com",\n "outlook.com"\n ]\n}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/random-email-generate"
payload = {
"count": 10,
"minLength": 6,
"maxLength": 10,
"includeLowercase": true,
"includeNumbers": true,
"domains": [
"gmail.com",
"outlook.com"
]
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())Go 示例
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/random-email-generate"
payload := []byte("{\n \"count\": 10,\n \"minLength\": 6,\n \"maxLength\": 10,\n \"includeLowercase\": true,\n \"includeNumbers\": true,\n \"domains\": [\n \"gmail.com\",\n \"outlook.com\"\n ]\n}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java 示例
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"count\": 10,\n \"minLength\": 6,\n \"maxLength\": 10,\n \"includeLowercase\": true,\n \"includeNumbers\": true,\n \"domains\": [\n \"gmail.com\",\n \"outlook.com\"\n ]\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/random-email-generate"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP 示例
<?php
$endpoint = 'https://openapi.toolkk.com/v1/random-email-generate';
$payload = "{\n \"count\": 10,\n \"minLength\": 6,\n \"maxLength\": 10,\n \"includeLowercase\": true,\n \"includeNumbers\": true,\n \"domains\": [\n \"gmail.com\",\n \"outlook.com\"\n ]\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;响应示例
{
"code": "SUCCESS",
"message": "success",
"data": [
"a8kx2m@gmail.com",
"jd7fn4p@outlook.com"
]
}示例用于理解返回结构,实际结果以接口返回为准。
- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 600 次/分钟
- 超时时间
- 未标注
服务端调用时,将 API Key 放在 X-API-Key 请求头中。
建议按 response code 与业务字段双重判断调用结果。
高频调用场景请结合速率限制与重试策略使用。
请求字段
从服务端发起请求,并在 X-API-Key 请求头中传入密钥。
请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| count | number | 未标注 | 未标注 | 10 |
| minLength | number | 未标注 | 未标注 | 6 |
| maxLength | number | 未标注 | 未标注 | 10 |
| includeLowercase | boolean | 未标注 | 未标注 | true |
| includeNumbers | boolean | 未标注 | 未标注 | true |
| domains | array | 未标注 | 未标注 | ["gmail.com","outlook.com"] |
| domains[] | string | 未标注 | 未标注 | gmail.com |
请求示例
{
"count": 10,
"minLength": 6,
"maxLength": 10,
"includeLowercase": true,
"includeNumbers": true,
"domains": [
"gmail.com",
"outlook.com"
]
}- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 600 次/分钟
- 超时时间
- 未标注
响应字段
示例用于理解返回结构,实际结果以接口返回为准。
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| code | string | 未标注 | 未标注 | SUCCESS |
| message | string | 未标注 | 未标注 | success |
| data | array | 未标注 | 未标注 | ["a8kx2m@gmail.com","jd7fn4p@outlook.com"] |
| data[] | string | 未标注 | 未标注 | a8kx2m@gmail.com |
响应示例
{
"code": "SUCCESS",
"message": "success",
"data": [
"a8kx2m@gmail.com",
"jd7fn4p@outlook.com"
]
}$.code == 200接口简介
接口能力、应用场景、使用限制与常见问题。
接口能力
批量生成邮箱地址形态的随机字符串,可控制前缀长度、小写字母与数字字符组成,以及候选域名,单次最多100条。成功结果是字符串数组,适合构造表单或接口测试数据。它不创建邮箱账户、不收发邮件,也不检查地址是否存在、归谁所有或能够投递。
适用场景
注册表单可把样本填入邮箱字段,检查提交、展示与业务校验流程;数据导入任务可将数组写入开发环境,检查批量处理与错误分流;演示系统也可用样本替代实际用户联系方式。导入、去重和错误判断由调用方实现,测试数据应保持隔离,不能因为是随机生成就直接接入真实通知链路。
调用与结果解读
确定条数、前缀长度区间与字符组成,再按示例填写 count、minLength、maxLength、includeLowercase、includeNumbers 和 domains。先检查 code 与 message,取得正常结果后逐项处理 data。示例参数不是默认值保证;长度区间和字符选项应符合已确认规则。用于展示或表单测试时可指定保留示例域,用于实际收件测试则需另行准备受控收件端。
限制与安全使用
随机地址可能偶然与真实地址重合,尤其使用实际邮箱服务商域名时。仅测试地址文本可选example.com、example.net或example.org等保留示例域,但这不会创建可收件邮箱。当前未公开去重、随机算法、固定种子或长度上下限,不承诺全局唯一或安全随机。稳定回归应保存结果;实际发送测试须使用有权限的域名与收件端,不能把生成地址当成已验证用户。
常见问题
生成的地址一定是假邮箱吗?
不能保证。它只是随机文本,可能与真实地址重合;生成不代表注册、验证或取得邮箱所有权。