API & personalizado
Power BI / Data API
Disponibilize dados em tempo real do Gfacility no Power BI ou noutra ferramenta de reporting — endpoints, autenticação e atualização automática.
Atualizado em 4/05/2026
Integrações · API & personalizado · 2.2
A Data API do Gfacility disponibiliza dados em tempo real ao Power BI ou a outra ferramenta de reporting. Para o Power BI fornecemos modelos padrão que pode usar como ponto de partida. Aquilo que vê na API depende das suas permissões — o token herda os direitos da conta que o gerou.
1. Gerar um token de acesso
A API autentica-se através de um token de acesso pessoal (PAT). Crie-o primeiro nas suas definições de perfil — consulte Token de Acesso Pessoal.
2. Endpoints disponíveis
| Dataset | Endpoint |
|---|---|
| Localizações | /api/v1/report/power-bi/services/locations |
| Organizações | /api/v1/report/power-bi/services/organizations |
| Avaliações | /api/v1/report/power-bi/services/ratings |
| Eventos | /api/v1/report/power-bi/services/events |
| Catering | /api/v1/report/power-bi/services/catering |
| Finanças | /api/v1/report/power-bi/services/finances |
| Notificações | /api/v1/report/power-bi/services/tickets |
| Tarefas | /api/v1/report/power-bi/services/tasks |
URL completo = https://app.gfacility.com + endpoint. Cabeçalhos:
Authorization: <jouw-token>
Content-Type: application/json
3. Começar no Power BI
1. Power BI Desktop
Descarregue o Power BI Desktop. Junto com o seu token, fornecemos um ficheiro de modelo que invoca as tabelas padrão.
2. Construir relatórios
Visualize KPIs, dashboards e análises de tendências sobre os datasets ligados.
3. Publicar
Publique em app.powerbi.com e partilhe dentro da sua organização. Atenção: os relatórios mostram a todos os mesmos dados — os da conta com a qual o token foi criado.
4. Atualização automática
Configure a atualização nas definições do dataset. O número de atualizações por dia depende da sua licença do Power BI.
4. Configurar a atualização automática
No Power BI online: abra o dataset → três pontos → Definições.
Credenciais da fonte de dados — para cada linha, “editar credenciais”:
- Método de autenticação: Anónimo
- Nível de privacidade: None
- Ignorar teste de ligação: ativar
Atualizar — escolha a frequência de atualização desejada. Em seguida pode opcionalmente enviar relatórios por e-mail através de subscrições.