API Documentation

Here you'll find the complete documentation for the AnyUUID.com API.

Endpoints

UUID v4 Generation

Endpoint

GET https://api.anyuuid.com/v1/uuid4

Parameters

count (optional) - Number of UUIDs to generate (default: 1, maximum: 100)
format (optional) - Output format (json or text, default: json)

Example Request

GET https://api.anyuuid.com/v1/uuid4?count=2&format=json

Example Response

{
  "uuids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ]
}

UUID v5 Generation

Endpoint

GET https://api.anyuuid.com/v1/uuid5

Parameters

name - The name from which to generate the UUID
namespace (optional) - The namespace for the UUID (default: DNS)
count (optional) - Number of UUIDs to generate (default: 1, maximum: 100)
format (optional) - Output format (json or text, default: json)

Example Request

GET https://api.anyuuid.com/v1/uuid5?name=example.com&namespace=DNS&format=json

Example Response

{
  "uuid": "2ed6657d-e927-568b-95e1-2665a8aea6a2"
}

Developer Tools

Endpoint

GET https://api.anyuuid.com/v1/dev

Parameters

type - Type of value to generate (string, hex, password, hash, useragent, timestamp)
length (optional) - Length of string to generate (for string and hex)
algorithm (optional) - Hash algorithm (for hash, e.g., MD5, SHA-1, SHA-256, SHA-512)
format (optional) - Output format (json or text, default: json)

Example Requests

# Generate random string
GET https://api.anyuuid.com/v1/dev?type=string&length=32

# Generate hash
GET https://api.anyuuid.com/v1/dev?type=hash&algorithm=sha256

# Get timestamp
GET https://api.anyuuid.com/v1/dev?type=timestamp

# Get random user agent
GET https://api.anyuuid.com/v1/dev?type=useragent

Example Responses

# String response
{
  "result": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
  "type": "string",
  "length": 32
}

# Hash response
{
  "result": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "type": "hash",
  "algorithm": "sha256"
}

# Timestamp response
{
  "result": 1709913600,
  "type": "timestamp",
  "format": "unix"
}

# User agent response
{
  "result": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
  "type": "useragent"
}

Security

All API responses include a digital signature header (X-Signature) that ensures data integrity.

Signature Verification

The signature is created using the following algorithm:

HMAC-SHA256(JSON.stringify(response.data), API_SECRET)

Example Header

X-Signature: sha256=d4c97ab3d5f784316ef9c69b4ceb069f34d6d3b514

Error Codes

400 Bad Request

Invalid parameters or missing required parameters

429 Too Many Requests

Rate limit exceeded

500 Internal Server Error

Server error while processing the request