# Inicio Rapido

Integre-se com a API Monetarie NPC em 5 minutos.

## 1. Obtenha sua API Key

Para acessar a API, voce precisa de uma API Key. Entre em contato com o suporte para obter suas credenciais:

- **Email:** suporte@fluxiq.com.br
- **Portal:** [npcadmin-dev.fluxiq.com.br](https://npcadmin-dev.fluxiq.com.br)

## 2. Ambientes

| Ambiente    | URL Base                                 | Descricao                    |
|-------------|------------------------------------------|------------------------------|
| Local       | `http://localhost:4000/api/v1/central`   | Desenvolvimento local        |
| Sandbox     | `https://sandbox.monetarie_npc.com.br/api/v1/central` | Testes e homologacao |
| Producao    | `https://api.monetarie_npc.com.br/api/v1/central`     | Ambiente produtivo   |

## 3. Primeira Requisicao

Vamos verificar se sua API Key esta funcionando corretamente fazendo uma requisicao ao endpoint de health check.

::: code-group

```bash [cURL]
curl -X GET "https://sandbox.monetarie_npc.com.br/api/v1/central/health" \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json"
```

```javascript [JavaScript]
const response = await fetch(
  "https://sandbox.monetarie_npc.com.br/api/v1/central/health",
  {
    method: "GET",
    headers: {
      "X-API-Key": "sua_api_key_aqui",
      "Content-Type": "application/json",
    },
  }
);

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

```python [Python]
import requests

url = "https://sandbox.monetarie_npc.com.br/api/v1/central/health"
headers = {
    "X-API-Key": "sua_api_key_aqui",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
```

:::

## 4. Resposta Esperada

Se tudo estiver configurado corretamente, voce recebera a seguinte resposta:

```json
{
  "status": "ok",
  "timestamp": "2026-02-03T12:00:00Z",
  "version": "1.0.0"
}
```

### Codigos de Resposta

| Codigo | Significado                                      |
|--------|--------------------------------------------------|
| 200    | Sucesso - API funcionando normalmente            |
| 401    | Nao autorizado - API Key invalida ou ausente     |
| 429    | Limite de requisicoes excedido                   |
| 500    | Erro interno do servidor                         |

## Proximos Passos

Agora que sua integracao esta funcionando, explore os recursos da API:

- [Autenticacao](/authentication) - Entenda como funciona a autenticacao por API Key
- [Criar Boleto](/api/boletos) - Registre seu primeiro boleto
- [Webhooks](/webhooks/) - Configure notificacoes em tempo real
