Fontes de Dados

Uma fonte de dados é o sítio de onde um gráfico vai buscar os números. Antes de um gráfico poder mostrar alguma coisa, dizes ao Dashboard.PT onde estão os valores e como lê-los. Esta página explica as três formas de alimentar dados na plataforma, como funciona o mapeamento de campos e como os limites de actualização dependem do teu plano.

Visão geral

Os dados podem chegar ao Dashboard.PT de três formas: a plataforma pode puxá-los de um endpoint de API REST, tu podes enviá-los através de um webhook, ou podes importar um ficheiro de dados à mão. Uses o que usares, o passo final é o mesmo: mapeias os campos dos dados recebidos para os valores que os teus gráficos representam.

Três formas de alimentar dados

  • Endpoint de API REST — a plataforma sonda um URL que configuras e lê a resposta JSON.
  • Webhook — os teus sistemas enviam dados para o Dashboard.PT à medida que os eventos acontecem.
  • Importação manual — carregas um ficheiro de dados para um carregamento pontual ou ocasional.

Escolher um método

Cada método serve para uma situação diferente. Usa esta tabela para escolheres o certo antes de configurares uma fonte.

Método Direcção Melhor para
API REST A plataforma puxa Dados já atrás de uma API que consegues alcançar
Webhook O teu sistema envia Eventos quase em tempo real à medida que acontecem
Importação manual Tu carregas Dados históricos ou pontuais

Endpoints de API REST

Com uma fonte REST, é o Dashboard.PT que trata de ir buscar os dados por ti. Configuras um URL e a plataforma sonda-o num intervalo de actualização, lê a resposta JSON e mapeia os campos que escolheres para os teus gráficos. É a melhor opção quando os teus dados já vivem atrás de uma API que consegues alcançar.

Definição O que faz
URL O endpoint que a plataforma chama para ir buscar os dados.
Método HTTP Normalmente GET, ou POST quando o endpoint espera um corpo de pedido.
Cabeçalhos Cabeçalhos personalizados enviados em cada pedido, como o tipo de conteúdo.
Autenticação Um token, chave de API ou autenticação básica para o endpoint aceitar a chamada.

Webhooks

Um webhook inverte a direcção: em vez de a plataforma puxar os dados, são os teus próprios sistemas que enviam dados para o Dashboard.PT à medida que as coisas acontecem. Recebes um URL de webhook único e a tua aplicação envia valores para lá, por isso o gráfico actualiza-se no momento em que ocorre um evento, sem esperar por um ciclo de sondagem. É ideal para sinais quase em tempo real, como uma venda feita ou uma tarefa concluída.

Importação manual

Quando os teus dados não estão ligados a nada, podes importá-los à mão. Carregas um ficheiro de dados e os valores são carregados no gráfico de uma só vez. Serve para dados históricos, actualizações ocasionais ou uma forma rápida de começar antes de ligares uma API ou um webhook.

Mapeamento de campos

O mapeamento de campos é como dizes a um gráfico quais os valores da fonte que realmente interessam. Uma resposta traz muitas vezes vários campos; o mapeamento permite-te apontar para aquele que se torna a série representada e para o que é usado nas etiquetas ou no eixo do tempo, ignorando os restantes.

  1. Abre a fonte de dados e observa uma amostra da resposta.
  2. Selecciona o campo que contém o valor a representar (por exemplo value ou count).
  3. Selecciona o campo usado para a etiqueta ou a data/hora (por exemplo timestamp ou name).
  4. Guarda o mapeamento. A partir daí, cada actualização lê exactamente esses campos.

Limites do intervalo de actualização

Para fontes REST, o intervalo de actualização decide a frequência com que a plataforma sonda o endpoint. Tal como nos gráficos, os intervalos mais curtos ficam reservados aos planos superiores: o teu plano define o intervalo mínimo que podes escolher, por isso um plano inferior sonda com menos frequência. As fontes de webhook e de importação manual não são sondadas, por isso este limite não se aplica a elas, ainda que o débito dos webhooks continue a ser governado pelo teu plano.

Nota: Para integrações programáticas ou personalizadas, também podes gerir as fontes de dados através da API REST da plataforma usando Chaves de API. Consulta a Referência da API REST para veres os endpoints disponíveis e como te autenticares.

Nota: Nunca coloques segredos no URL. Guarda os tokens e as chaves de API nas definições de Autenticação ou Cabeçalhos, onde são tratados de forma segura, e não na query string.

Quer experimentar? O plano gratuito não tem limite de tempo.

Criar conta gratuita