> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunny.build/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /uuid-generator

> Gere UUIDs, NanoIDs e ULIDs em lote. Suporta os formatos v4, v7, nanoid e ulid.

## Endpoint

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

## Autenticação

| Header         | Obrigatório | Valor                        |
| -------------- | ----------- | ---------------------------- |
| `X-API-Key`    | Sim         | Sua chave de API (`bun_...`) |
| `Content-Type` | Sim         | `application/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

| Campo   | Tipo   | Obrigatório | Descrição                                          |
| ------- | ------ | ----------- | -------------------------------------------------- |
| `type`  | string | Sim         | Formato do ID: `v4`, `v7`, `nanoid` ou `ulid`      |
| `count` | number | Não         | Quantidade de IDs a gerar (padrão: 1, máximo: 100) |

### Exemplo

```json theme={null}
{
  "type": "v4",
  "count": 3
}
```

## Resposta

### 200 OK

| Campo  | Tipo      | Descrição                        |
| ------ | --------- | -------------------------------- |
| `type` | string    | O tipo de ID solicitado          |
| `ids`  | string\[] | Array de identificadores gerados |

**Exemplo**

```json theme={null}
{
  "type": "v4",
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  ]
}
```

### 401 Unauthorized

```json theme={null}
{
  "detail": "Missing API key. Include X-API-Key header."
}
```

### 402 Payment Required

```json theme={null}
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}
```

### 422 Unprocessable Entity

```json theme={null}
{
  "detail": "Invalid type. Must be one of: v4, v7, nanoid, ulid"
}
```

### 429 Too Many Requests

```json theme={null}
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}
```

## Exemplo cURL

```bash theme={null}
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}'
```