Всем привет! Выкладываю продолжение статьи Qlik Sense в FutureToday — опыт работы с API SurveyMonkey.
Пройдя сквозь боль и страдания в борьбе с выгрузкой данных, залечив шишки от метких ударов граблей на своих лбах, перейдем к чему-то более созидательному. Рассмотрим как пошагово настроить REST API подключение в Qlik Sense.
Для этого нам необходимо:
- Создать приложение в SurveyMonkey и настроить разрешения на чтение
- Получить постоянный токен доступа к API SM (потребуется утилита cURL)
- Настроить REST-подключение в Qlik Sense
Создаем приложение и даем необходимые разрешения (1)
Перейдем по ссылке https://developer.surveymonkey.com/apps/ и нажмем на кнопку «Add a New App»:
Вводим название приложения (любое) и выбираем «Private App»:
После этого заходим в раздел «Settings» и настраиваем разрешения:
Нажимаем на «Upgrade Scopes». Первый шаг готов, идем дальше!
Получаем постоянный токен доступа к API SM (2)
Возвращаемся в настройки приложения и видим следующую картину:
Для получения постоянного OAuth-токена нам потребуются следующие данные (описания параметров взял отсюда):
- OAuth Redirect URL — это URL, на который сервис будет перенаправлять пользователя после авторизации (или отказа в авторизации) вашего приложения
- Client ID — представляет собой публично доступную строку, которая используется API сервиса для идентификации приложения, а также используется для создания авторизационных URL для пользователей
- Secret — используется для аутентификации подлинности приложения для API сервиса, когда приложение запрашивает доступ к аккаунту пользователя. Секрет клиента должен быть известен только приложению и API
- Access Token — на данном этапе бесполезен (почему?— не знаю...), потребуется получать его самостоятельно, для этого нам и потребуется утилита cURL
Далее нам надо получить временный токен. Для этого переходим по ссылке:
https://api.surveymonkey.com/oauth/authorize?response_type=code&redirect_uri=YOUR_REDIRECT_URI&client_id=YOUR_CLIENT_ID
Где вместо YOUR_REDIRECT_URI и YOUR_CLIENT_ID подставляем свои значения.
В результате в адресной строке мы получим в URL-ссылку типа:
https://www.surveymonkey.com/dashboard/?code=AUTH_CODE
где AUTH_CODE— временный код доступа к API SM, работающий всего несколько минут.
Далее, устанавливаем cURL (скачать его можно отсюда), заходим в командную строку и пишем команду вида:
curl -i -X POST https://api.surveymonkey.com/oauth/token -d \ "client_secret=YOUR_CLIENT_SECRET \ &code=AUTH_CODE \ &redirect_uri=YOUR_REDIRECT_URI \ &client_id=YOUR_CLIENT_ID \ &grant_type=authorization_code"
где
- YOUR_CLIENT_SECRET – ваш Secret,
- AUTH_CODE – ваш временный код доступа к API SM,
- YOUR_REDIRECT_URI – ваш OAuth Redirect URL
- YOUR_CLIENT_ID – ваш Client ID
После выполнения команды Вы получите постоянный токен доступа к API SM, в командной строке это выглядит следующим образом:
Запишите его, ну или запомните, если у вас хорошая память :D
Настраиваем REST-подключение в Qlik Sense (3)
Хочу вас обрадовать, это последний шаг в настройке REST-подключения.
Заходим в редактор скрипта Qlik Sense и создаем новое подключение:
Выбираем REST и настраиваем как на картинках ниже:
Тестируем подключение и делаем пробную выборку:
На сегодня это все!
Спасибо за внимание, надеюсь статья окажется кому-то полезной :)
Если вы еще не читали первую часть, обязательно прочтите: Qlik Sense в FutureToday — опыт работы с API SurveyMonkey.
Если будут положительные отзывы — напишу продолжение о том, как настроить партиционную выгрузку и собрать модель данных.
Если у вас есть вопросы или предложения, не стесняйтесь и пишите мне на почту: me@andbel.it