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

# Início Rápido

> Comece a usar a API Pública VoxFi em minutos

## Introdução

A API Pública VoxFi permite que você interaja com a plataforma VoxFi programaticamente. Todos os endpoints requerem autenticação usando uma chave de API que você gera nas configurações da sua conta.

## Obtenha Sua Chave de API

1. Faça login na sua conta VoxFi
2. Navegue até **Perfil** → **Segurança**
3. Gere uma nova chave de API
4. Copie e armazene sua chave de API com segurança (você não poderá vê-la novamente)

<Warning>
  Mantenha sua chave de API segura e nunca a compartilhe publicamente. Trate-a como uma senha.
</Warning>

## URL Base

Todas as requisições à API devem ser feitas para:

```
https://data-api-dev.voxfi.com.br/v1
```

## Autenticação

Toda requisição à API deve incluir sua chave de API nos cabeçalhos da requisição:

```bash theme={null}
X-Api-Key: sua-chave-de-api-aqui
```

## Sua Primeira Requisição

Vamos começar buscando uma lista de eventos disponíveis:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://data-api-dev.voxfi.com.br/v1/data/events" \
    -H "X-Api-Key: sua-chave-de-api-aqui"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://data-api-dev.voxfi.com.br/v1/data/events', {
    method: 'GET',
    headers: {
      'X-Api-Key': 'sua-chave-de-api-aqui'
    }
  });

  const events = await response.json();
  console.log(events);
  ```

  ```python Python theme={null}
  import requests

  headers = {
      'X-Api-Key': 'sua-chave-de-api-aqui'
  }

  response = requests.get('https://data-api-dev.voxfi.com.br/v1/data/events', headers=headers)
  events = response.json()
  print(events)
  ```
</CodeGroup>

## Rate Limits

A API implementa rate limits para garantir uso justo. Informações sobre limites de taxa são retornadas nos cabeçalhos de resposta quando os limites são aproximados.

## Próximos Passos

* Explore a [Referência da API](/pt/reference) para documentação detalhada dos endpoints
* Confira [Autenticação](/pt/authentication) para mais práticas de segurança
* Revise [Tratamento de Erros](/errors) para entender as respostas de erro da API