POST已开放random-mac-generate

随机MAC地址生成

批量生成随机 MAC 地址，支持自定义冒号、短横线、点号或无分隔符格式，支持大小写切换，单次最多生成 100 条，适用于网络测试与设备模拟。

调用价格

1 匠币/次

在线调试

无需写代码，浏览器中直接发起真实请求

接入文档

接口能力

本接口提供批量生成随机 MAC 地址的功能。开发者可以通过调用该接口，快速获取符合标准格式的随机 MAC 地址。接口支持多种常见的分隔符格式，包括冒号（:）、短横线（-）、点号（.）以及无分隔符格式，并支持指定字母的大小写，满足不同系统和网络设备的格式要求。

请求与返回

在请求时，您需要指定生成数量（count，单次最多 100 条）、分隔符格式（format，如 colon 代表冒号）以及是否大写（uppercase，布尔值）。返回结果将包含一个状态码和消息，成功时 data 字段会返回一个包含所生成 MAC 地址的字符串数组。例如请求生成大写冒号分隔的 MAC 地址，将返回如 02:1A:3B:4C:5D:6E 的结果。

使用场景

网络设备测试：在开发或测试路由器、交换机等网络设备时，批量生成虚拟 MAC 地址进行压力测试或功能验证。
软件开发与模拟：用于虚拟机、容器或模拟器环境中的网卡 MAC 地址分配。
数据脱敏与填充：在数据库测试或演示系统中，使用随机 MAC 地址替代真实用户数据。

使用说明与限制

单次请求生成的 MAC 地址数量最多不超过 100 条。
生成的 MAC 地址均为随机生成，仅供测试和模拟使用，不保证在真实网络环境中的唯一性，请勿用于非法用途或生产环境的真实设备标识。
若请求参数格式错误或数量超限，接口将返回相应的错误提示，请根据返回信息进行排查。

接入示例代码

提供 Shell、Python、Go、Java、PHP 等常见接入示例，便于直接接到现有项目里。

请求示例

{
  "count": 10,
  "format": "colon",
  "uppercase": true
}

响应示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": [
    "02:1A:3B:4C:5D:6E"
  ]
}

请求字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	示例值
count	number	10
format	string	colon
uppercase	boolean	true

响应字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	示例值
code	string	SUCCESS
message	string	success
data	array	"02:1A:3B:4C:5D:6E"
data[]	string	02:1A:3B:4C:5D:6E

curl --request POST \ --url 'https://openapi.toolkk.com/v1/random-mac-generate' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "count": 10,\n "format": "colon",\n "uppercase": true\n}'

import os import requests url = "https://openapi.toolkk.com/v1/random-mac-generate" payload = { "count": 10, "format": "colon", "uppercase": true } 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())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/random-mac-generate" payload := []byte("{\n \"count\": 10,\n \"format\": \"colon\",\n \"uppercase\": true\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)) }

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 \"format\": \"colon\",\n \"uppercase\": true\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/random-mac-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 $endpoint = 'https://openapi.toolkk.com/v1/random-mac-generate'; $payload = "{\n \"count\": 10,\n \"format\": \"colon\",\n \"uppercase\": true\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;