POSTPublicrandom-mac-generate

Random MAC Address Generator

Batch generation of random MAC addresses, supporting custom colon, hyphen, dot, or no separator formats, with case switching. Generates up to 100 entries per request, suitable for network testing and device simulation.

Documentation

API Capabilities

This API provides the functionality for batch generation of random MAC addresses. Developers can quickly obtain random MAC addresses that conform to standard formats by calling this API. The API supports various common separator formats, including colon (:), hyphen (-), dot (.), and no separator format, and supports specifying letter case, meeting the format requirements of different systems and network devices.

Request and Response

When making a request, you need to specify the generation count (count, maximum 100 per request), separator format (format, e.g., colon for colon), and whether to use uppercase (uppercase, boolean value). The return result will include a status code and message. Upon success, the data field will return a string array containing the generated MAC addresses. For example, requesting uppercase colon-separated MAC addresses will return results like 02:1A:3B:4C:5D:6E.

Use Cases

Network Device Testing: When developing or testing network devices such as routers and switches, batch generate virtual MAC addresses for stress testing or functional verification.
Software Development and Simulation: Used for assigning network card MAC addresses in virtual machine, container, or emulator environments.
Data Anonymization and Population: In database testing or demonstration systems, use random MAC addresses to replace real user data.

Usage Notes and Limitations

The number of MAC addresses generated per request does not exceed 100.
The generated MAC addresses are all randomly generated, intended for testing and simulation only. They do not guarantee uniqueness in a real network environment and should not be used for illegal purposes or as real device identifiers in production environments.
If the request parameters are incorrectly formatted or the quantity exceeds the limit, the API will return corresponding error messages. Please troubleshoot based on the returned information.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

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

Response Example

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

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
count	number	10
format	string	colon
uppercase	boolean	true

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
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;

Random MAC Address Generator

Documentation

API Capabilities

Request and Response

Use Cases

Usage Notes and Limitations

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online