API RESTful para a BSC Designer

Para uma automação mais simples da introdução e integração de dados através de ferramentas de terceiros, a BSC Designer oferece a API RESTful.

Informação geral

  • Documentação. A documentação para as chamadas API está disponível aqui.
  • Webhooks. Os alertas no BSC Designer podem ser configurados para enviar webhooks.
  • Limitações. Uma conta tem um limite de 100 chamadas API por hora por cada usuário power.

Começando

Encontre abaixo algumas instruções que ajudarão você a começar.

Token de Autorização

A API irá pedi a chave API ou um token de autorização temporário.

Para criar uma nova chave API siga estes passos:

  1. Ir à seção Configurações
  2. Trocar para a aba Integrações
  3. Clicar no botão Adicionar Chave API

Usar o parâmetro da Chave API obtida nos cabeçalhos de todas as outras chamadas para a API:

POST /rest/login HTTP/1.1

Host: https://www.webbsc.com

Content-Type: application/json

Token: replace_with_obtained_token

Token de autorização

Antes de submeter as chamadas API é necessário obter um token de autorização. Envie os seguintes dados para o endpoint de autenticação:

POST /rest/login HTTP/1.1

Host: https://pt.webbsc.com

Content-Type: application/json

{

"email" : "replace_with_access_email_here",

"password" : "replace_with_access_password_here"

}

a resposta em formato JSON irá conter os parâmetros errorMessage e token:

{

"email": "string",

"errorMessage": "string",

"success": true,

"token": "string"

}

Utilize o parâmetro token obtido nos cabeçalhos de todas as outras chamadas para a API:

POST /rest/login HTTP/1.1

Host: https://www.webbsc.com

Content-Type: application/json

Token: replace_with_obtained_token

Obtendo os ID para o scorecard e KPI

As chamadas API relacionadas com o KPI exigem o ID do scorecard e o GUID do KPI.

Obtendo o ID do Scorecard

O ID do Scorecard pode ser encontrado utlizando a chamada API ou manualmente. Para encontrar manualmente o ID do Scorecard:

  1. Vá na seção "Meus scorecards"
  2. Abra o scorecard alvo
  3. O URL do scorecard será algo como isso: https://pt.webbsc.com/s/123456
  4. O número no final é o ID do scorecard

Obtendo o GUID de um KPI

O GUID de um KPI pode ser encontrado utilizando a chamada API ou manualmente. Para encontrar manualmente o GUID:

  1. Abra o scorecard
  2. Selecione "Ferramentas" > "Exportar valores dos indicadores"
  3. Siga os passos para chegar na página "Pré-visualizar resultados de exportação"
  4. A coluna "GUID" na tabela de pré-visualização conterá o GUID do KPI

Escrevendo e Lendo valores utilizando a API

Utilize o KPI Value Controller para escrever e ler os dados para os KPI.

  • Lembre-se de utilizar o token no cabeçalho dos pedidos
  • As datas devem ter o formato aaaa-MM-dd(por exemplo "2017-06-30")
  • Os dados são enviados e recebidos no formato JSON
  • Para otimizar os números das chamadas utilize as chamadas em lote
  • Para ler valores agrupados, calculados ou herdados utilize o Grouped Values Controller

Verifique o exemplo.php em relação à utilização da API.