# Endpoints para Power BI — Metas

## Endpoints

| Endpoint | Tabela | Descrição |
| --- | --- | --- |
| `/metas/api/powerbi.php` | `tbmetas` + `tbconsultores` | Retorna metas dos consultores, incluindo URL da foto. |
| `/metas/api/powerbi_rede.php` | `tbmetas_rede` | Retorna metas consolidadas da rede. |

## Parâmetros comuns

| Parâmetro | Descrição |
| --- | --- |
| `competencia` | Competência `YYYY-MM`. Quando ausente, retorna mais registros, ordenando por competência. |
| `format` | Pode acionar formatação de exibição. |
| `raw`, `include_raw`, `raw_columns` | Controlam retorno com colunas brutas quando habilitado no helper. |
| `currency` ou `moeda` | Controla formatação monetária. |
| `debug` | Usado para diagnóstico. Não manter aberto em produção. |

## Exemplo

```bash
curl "https://pbi.motionfitacademia.com.br/metas/api/powerbi.php?competencia=2026-06"
```

## Regra de fotos

O endpoint de metas dos consultores faz `JOIN` com `tbconsultores` e monta campos:

- `foto_consultor_path`
- `foto_consultor_url`
- `foto_consultor`
- `foto_consultor_original_path`
- `foto_consultor_padrao`

## Correções recomendadas

- Adicionar token/API key para endpoints consumidos pelo Power BI quando não forem estritamente públicos.
- Desabilitar `debug` público.
- Garantir limite de retorno por competência para evitar consumo excessivo.