# Quick Start

## Visão Geral

A PrismaData API fornece dados geoespaciais e socioeconômicos do Brasil através de endpoints REST. Com uma única coordenada (latitude/longitude) você obtém informações sobre favelas, renda, presídios, fronteiras, setor censitário e mais.

**Base URL:** `https://api.prismadata.io/v1`

## Pré-requisitos

1. Conta PrismaData ativa
2. API Key (formato `ak_xxxxxxxxxxxxxxxx`) — obtida no painel ou via suporte

## Primeira chamada em 3 passos

### 1. Autenticar

Use sua API Key diretamente no header `X-Apikey` de cada requisição. O gateway valida a chave e gerencia o token JWT internamente — não é necessário chamar `/auth/token` separadamente.

### 2. Chamar um endpoint

Envie uma coordenada para qualquer endpoint de localização. Exemplo: consultar o presídio mais próximo de um ponto.

### 3. Parsear a resposta

A resposta é um JSON com campos prefixados por `prismadata__<serviço>__`. Veja a seção **Formato de Resposta** para detalhes.

## Exemplos

**curl:**

```bash
curl "https://api.prismadata.io/v1/location/prison?lat=-25.5&lng=-54.5" \
  -H "X-Apikey: ak_xxxxxxxxxxxxxxxx"
```

**Python (httpx):**

```python
import httpx

resp = httpx.get(
    "https://api.prismadata.io/v1/location/prison",
    params={"lat": -25.5, "lng": -54.5},
    headers={"X-Apikey": "ak_xxxxxxxxxxxxxxxx"},
)
dados = resp.json()
nome = dados["prismadata__prison__nome_estabelecimento"]
print(nome or "Nenhum presídio próximo")
```

**JavaScript (fetch):**

```javascript
const resp = await fetch(
  "https://api.prismadata.io/v1/location/prison?lat=-25.5&lng=-54.5",
  { headers: { "X-Apikey": "ak_xxxxxxxxxxxxxxxx" } }
);
const dados = await resp.json();
const nome = dados.prismadata__prison__nome_estabelecimento;
console.log(nome ?? "Nenhum presídio próximo");
```

---

- Índice geral: https://prismadata.io/llms.txt
- Documentação Redoc interativa: https://prismadata.io/redoc.html