RESTful API для BSC Designer

Для автоматизации ввода данных и для интеграции с другими инструментами BSC Designer предоставляет разработчикам RESTful API.

Общая информация

  • Документация. Документация для API запросов доступна здесь.
  • Webhook-и. Уведомления в BSC Designer могут отсылаться через webhook-и.
  • Ограничения. В счёте есть ограничение в 100 API запросов в час для каждого ведущего пользователя.

Первые шаги

Инструкции ниже помогут начать использовать API.

Токен авторизации

Перед выполнением API запросов необходимо получить API ключ или временный авторизационный токен.

Для создания нового API ключа:

  1. Перейдите в раздел Настройки
  2. Переключитесь на закладку Интеграции
  3. Нажмите кнопку Добавить API ключ

Используйте полученный API ключ в заголовках всех API запросов:

POST /rest/login HTTP/1.1

Host: https://www.webbsc.com

Content-Type: application/json

Token: заменить_полученным_tocken

Получение IDs для scorecard и KPI

API запросы связанные с индикаторами требуют в качестве параметра ID scorecard-а и GUID индикатора.

Получение Scorecard ID

Scorecard ID может быть получен используя API запрос или вручную. Чтобы получить GUID вручную:

  1. Перейдите в раздел "Мои проекты"
  2. Откройте нужный scorecard
  3. Адрес scorecard будет в таком формате https://www.webbsc.com/s/123456
  4. Число на конце ссылки является ID scorecard-а

Получение KPI GUID

KPI GUID может быть получен используя API запрос или вручную. Чтобы получить GUID вручную:

  1. Откройте scorecard
  2. Выберите "Инструменты" > "Экспортировать величины индикаторов"
  3. Перейдите к шагу "Предпросмотр результатов экспорта"
  4. Колонка "GUID" в таблице предпросмотра будет содержать GUID KPI

Запись и чтение величин через API

Используйте KPI Value Controller для записи и чтения данных в/из KPI.

  • Используйте token в заголовках каждого запроса
  • Даты должны быть в формате yyyy-MM-dd (например "2017-06-30")
  • Данные передаются и получаются в JSON формате
  • Для оптимизации количества запросов используйте пакетные API запросы

Пример использования API: пример на php.