RESTful API для BSC Designer
Для автоматизации ввода данных и для интеграции с другими инструментами BSC Designer предоставляет разработчикам RESTful API.
Общая информация
- Документация. Документация для API запросов доступна здесь.
- Webhook-и. Уведомления в BSC Designer могут отсылаться через webhook-и.
- Ограничения. В счёте есть ограничение в 100 API запросов в час для каждого ведущего пользователя.
Первые шаги
Инструкции ниже помогут начать использовать API.
Токен авторизации
Перед выполнением API запросов необходимо получить API ключ или временный авторизационный токен.
Для создания нового API ключа:
- Перейдите в раздел Настройки
- Переключитесь на закладку Интеграции
- Нажмите кнопку Добавить 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 вручную:
- Перейдите в раздел "Мои проекты"
- Откройте нужный scorecard
- Адрес scorecard будет в таком формате https://www.webbsc.com/s/123456
- Число на конце ссылки является ID scorecard-а
Получение KPI GUID
KPI GUID может быть получен используя API запрос или вручную. Чтобы получить GUID вручную:
- Откройте scorecard
- Выберите "Инструменты" > "Экспортировать величины индикаторов"
- Перейдите к шагу "Предпросмотр результатов экспорта"
- Колонка "GUID" в таблице предпросмотра будет содержать GUID KPI
Запись и чтение величин через API
Используйте KPI Value Controller для записи и чтения данных в/из KPI.
- Используйте token в заголовках каждого запроса
- Даты должны быть в формате yyyy-MM-dd (например "2017-06-30")
- Данные передаются и получаются в JSON формате
- Для оптимизации количества запросов используйте пакетные API запросы
Пример использования API: пример на php.