Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/uuid-generator

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/json

​
Visão geral

Gere identificadores únicos criptograficamente aleatórios em quatro formatos: UUID v4, UUID v7 (ordenado por tempo), NanoID e ULID. Solicite até 100 IDs em uma única chamada para inicializar bancos de dados, fixtures de testes ou sistemas distribuídos em lote.

​
Casos de uso

  • Gerar chaves primárias para registros de banco de dados
  • Criar IDs ordenáveis por tempo com UUID v7 ou ULID
  • Produzir IDs curtos e seguros para URLs com NanoID
  • Inicializar dados de teste em lote com identificadores únicos

​
Detalhes

Tipos suportados: v4 (UUID aleatório), v7 (UUID ordenado por tempo conforme RFC 9562), nanoid (string de 21 caracteres segura para URL), ulid (identificador ordenável de 26 caracteres). O parâmetro count tem padrão 1 e limite máximo de 100.

​
Corpo da requisição

CampoTipoObrigatórioDescrição
typestringSimFormato do ID: v4, v7, nanoid ou ulid
countnumberNãoQuantidade de IDs a gerar (padrão: 1, máximo: 100)

​
Exemplo

{
  "type": "v4",
  "count": 3
}

​
Resposta

​
200 OK

CampoTipoDescrição
typestringO tipo de ID solicitado
idsstring[]Array de identificadores gerados
Exemplo 
{
  "type": "v4",
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  ]
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

{
  "detail": "Invalid type. Must be one of: v4, v7, nanoid, ulid"
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/uuid-generator \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"type": "v4", "count": 3}'