Visão geral

Uma API REST de Geração de UUID rápida e gratuita que devolve JSON limpo sobre HTTPS, com suporte às versões v1, v3, v4, v5, v6 e v7 (ordenada por tempo), com guid como alias de v4.

Gerar UUIDs em massa (até 200 por chamada) através de endpoints simples GET, usar hashing de namespace/nome para v3/v5 (dns/url) e formatação opcional de saída (uppercase/braced).

Sem autenticação, limites de taxa sensatos e integração instantânea para backends, scripts, pipelines CI/CD e sites estáticos.

URL base

https://toolkitvault.com/api/uuid-generator

Content-Type

application/json

Autenticação

Pública (com rate limit)

Versões suportadas

• v1, v3, v4, v5, v6, v7
• guid → alias de v4
• v2 → 501 Not Implemented (UUIDs DCE Security não são suportados)

Endpoints

1. Gerar com parâmetros de query

GET /api/uuid-generator/{version}

Parâmetros de query

• count | n — inteiro, número de UUIDs (predefinição 1, mín 1, máximo rígido 200)
• namespace — apenas para v3/v5: dns (predefinição) | url
• name — apenas para v3/v5: string usada como entrada de nome
• format — default | uppercase | braced | braced-uppercase

Exemplos

GET /api/uuid-generator/v7

GET /api/uuid-generator/v4?count=10

GET /api/uuid-generator/v5?name=my-domain.com&namespace=dns

2. Gerar com parâmetro no caminho

GET /api/uuid-generator/{version}/{count}

• Igual ao acima, com count no caminho
• name, namespace e format continuam a aplicar-se para v3/v5 e formatação

Exemplos

GET /api/uuid-generator/v4/20

GET /api/uuid-generator/v3/5?name=https://example.com&namespace=url

Respostas

200 OK

{
  "version": "v4",
  "count": 10,
  "maxPerCall": 200,
  "uuids": ["6b8f8b8c-7f1a-4f4e-9d2e-1a3d9f8d2c01"]
}

400 Bad Request

{
  "error": true,
  "url": "https://toolkitvault.com/api/uuid-generator/v0",
  "statusCode": 400,
  "statusMessage": "Invalid version. Use v1|v2|v3|v4|v5|v6|v7|guid",
  "message": "Invalid version. Use v1|v2|v3|v4|v5|v6|v7|guid"
}

429 Too Many Requests

{
  "error": true,
  "url": "https://toolkitvault.com/api/uuid-generator/v4",
  "statusCode": 429,
  "statusMessage": "Too Many Requests",
  "message": "Too Many Requests"
}

501 Not Implemented (v2)

{
  "error": true,
  "url": "https://toolkitvault.com/api/uuid-generator/v2",
  "statusCode": 501,
  "statusMessage": "UUID v2 (DCE Security) not supported. Use v1/v6 or v4/v7.",
  "message": "UUID v2 (DCE Security) not supported. Use v1/v6 or v4/v7."
}

Exemplos

# Único v7
curl -s https://toolkitvault.com/api/uuid-generator/v7

# 20 v4 via caminho
curl -s https://toolkitvault.com/api/uuid-generator/v4/20

# v5 com namespace DNS e nome
curl -s "https://toolkitvault.com/api/uuid-generator/v5?name=my-domain.com&namespace=dns"

Interface TypeScript

export type UuidResponse = {
  version: string
  count: number
  maxPerCall: number
  uuids: string[]
}