Автор оригинала: FreeCodeCamp Community Member.
Дженет Ледезма
В этом руководстве вы узнаете, как настроить Слабый Приложение, которое будет отображать информацию от API встречи , в котором подают сохраненные данные из встречи с другими прикладными программным обеспечением.
Встреча Народный веб-сайт, где люди с подобными интересами формируют группы для организации событий в местных городах.
После того, как мы успешно сделали запрос на API Meetup, мы получим ответ от встречи, мы будем вытащить определенные данные из полезной нагрузки JSON и отображать эти данные в Slash. Мы разработаем наше приложение приложения Slack, чтобы он отобразил имя события, описание, дату и время, местоположение и многое другое!
Как это работает:
Когда вы отправляете /NextMeetup 94709 & JavaScript (или любой почтовый индекс и тема интереса) в поле «Сообщение Slack», веб-канал будет запущен. Веб -ook, построенный и размещенный в стандартной библиотеке, сначала сделает запрос на API встречи, что вернет полезную нагрузку JSON с результатами запроса.
Затем WebHook создаст слабые сообщения для каждого события и опубликовать их на указанный канал.
Не нужно преодолевать! Давайте сделаем это шаг за раз.
Что вам нужно:
1x Slack Account
1x Meetup Account
1x Стандартная учетная запись библиотеки
Шаг 1: Настройте свое приложение Slack
Убедитесь, что вы Подписался на слабые и посетите вашу приборную панель Slack Apps на https://api.slack.com/apps Отказ Вы увидите экран, который выглядит как следующее.
Нажмите Создайте новое приложение. Вам будет представлен модаль, чтобы войти в свое имя приложения и рабочее пространство Slack Development, которое вы хотите его добавить.
Отсюда щелкните Создать приложение, Вы найдете себя на Основная информация страница.
Прокрутите вниз до Отображать информацию. Это то, где вы можете дать вашему приложению SLIC имя, описание и изображение, если вы хотите.
Держите Основная информация Страница открыта в вашем браузере. Мы будем использовать его в секунду, чтобы получить учетные данные вашего Slack App для подключения этого приложения к логике Backend, размещенной в стандартной библиотеке – код, выполняющий ваше приложение.
Шаг 2: Создать бесплатную стандартную учетную запись библиотеки
Мы будем принимать наше код приложения Slack на Стандартная библиотека – Кодекс, который будет запрашивать и получать конкретную информацию из API Meetups. Так что голова к Код на стандартной библиотеке и претендовать на ваш бесплатный аккаунт.
Шаг 3: Скопируйте и измените шаблон кода Slack App в стандартной библиотеке
После того, как вы вошли или зарегистрированы или зарегистрированы, вы будете приземлиться на « Попущенный источник API». Это шаблоны кода приложений, доступные на Стандартная библиотека Для любого, чтобы легко скопировать и изменить приложения. Вы собираетесь выбрать шаблон кода Slack Application и изменить его, чтобы создать свой API, который будет включать приложение Slack.
Введите уникальное имя для вашего проекта API и нажмите Хорошо.
Краткое объяснение шаблона кода исходного кода Slack App:
Давайте приостановимся на мгновение, чтобы понять, на что мы смотрим. Левая боковая панель – это лепестка проекта API, которую стандартная библиотека настроила для вас, чтобы построить Slack Apps.
Шаблон кода для Slack Apps имеет четыре каталогов. Мы будем работать только в рамках Функции каталог, который оснащен еще одним папками
Действия/, команды/, и события/ а также один файл __main __. Js. Инструкции по слабым действиям, командам Slash и события для вашего приложения живут внутри этих папок.
При развертывании вашего API стандартная библиотека автоматически генерирует конечные точки HTTPS (URL) для каждого каталога. Полученные URL-адреса позволят нам настроить веб-вики, которые слушают и отвечают на Действия слайдов , Команды Slash и События Отказ
Все пять папок (в том числе Функции Папка настроены с помощью __main __. JS Файл (главная конечная точка каталога). Эти конечные точки __main __. JS Отправляйте соответствующие функции, когда они получают сообщение От провисания. Для этого учебника файл __main __. JS будет отправлять команды Команды Конечная точка, когда мы называем наши API через нашу Slack Bot. Теперь вернемся к нашему настроек Bot!
Шаг 4: Добавить команду на стандартную библиотеку API
Команды: Команды Каталог – конечная точка для всех команд Slack Slash. Создайте дополнительную команду, поместив курсор на Команды каталог и щелкните правой кнопкой мыши. Выберите Новый файл и назвать командный файл slash NextMeetup.js и нажмите Хорошо Отказ
На данный момент вы заметите функцию JavaScript «Hello World» ( __main __. JS ), который автоматически генерируется.
Заменить содержимое NextMeetup.js со следующим:
Краткое объяснение кода:
Когда вы отправляете /NextMeetup Через ваше приложение Slack вы делаете запрос на API Meetup.
Каждый запрос на API для METEUPS должен быть аутентифицирован с ключом API, поэтому мы проходим наш ключ встречи с нашего env.json файл в нашу просьбу. Мы также отправляем нашу запрос на получение двух параметров, ZIP и тематику.
Meetup API возвращает массив объектов событий встречи, который мы можем просматривать из кода в стандартных библиотечных журналах, войдя на наш ответ: console.log (Ответ.дата) Отказ Вкладка «Ваши логи» расположена под разделением отладки.
Ответ.дата Является ли массив событий, которые соответствуют вашему запросу, и мы хотим создать два вложения для каждого события (один для местоположения и один для деталей). У нас есть функция под названием форматattathement что мы можем позвонить по каждому из событий. Результаты поставляются в массиве под названием Вложения это отправляется на слабые.
Как только вы скопировали и вставили код в свой файл NextMeetup.js Сохраните изменения и перейдите к env.json Файл в левом баре меню.
Шаг 5: Заполните файл env.json с учетными данными приложения и ключами
Внутри env.json Вы заметите переменные среды для вашего API. Вы можете установить разные значения для локальных, разработчиков и выпуска (производственных) сред. Этот файл проведет все ваши уникальные ключевые ключи доступа к вашей стандартной учетной записи библиотеки, учетную запись встречи и учетные данные Slack App.
Мы будем делать только модификации для «Дев» Переменные среды – Убедитесь, что вы изменяете правильный набор ! Обратите внимание, что «Дев» Значения для вашей среды развития и «Выпуск» Значения должны быть заполнены только тогда, когда вы готовы выпустить ваше приложение. «Местный» Переменные могут быть оставлены пустыми при развертывании из кода на стандартной библиотеке, но они должны быть заполнены при работе с Инструменты командной строки Отказ
Давайте начнем, заполнив "Stdlib_token" Переменная. Поместите курсор между кавычками (см. Экран) и щелкните правой кнопкой мыши и выберите Вставьте токен библиотеки … или использовать ярлык ⌘ + K.
Выберите В библиотеке токен заполнить «Дев» среда.
Теперь вернитесь к Основная информация Страница вашего приложения Slack и прокрутите вниз до Учетные данные приложений :
Скопируйте свой Идентификатор клиента, секрет клиента и Проверочный токен Отказ Вставьте их в соответствующие поля в «Дев» Раздел env.json файл.
Добавьте название, которое вы дали вашему приложению Slack для Slack_app_name Отказ
Ex: Slack_app_name: Meetup-Bot
"Slack_redirect" Значение станет конечной точкой HTTPS, сгенерированная стандартной библиотекой, как только вы развернуте ваш API. Несмотря на то, что мы еще не развернули, продолжайте заполнить его сейчас, используя эту структуру. https://<имя пользователя> .api.stdlib.com/
Мой Slack_redirect Похоже, это: https://janethl.api.stdlib.com/slack-meTup-bot@dev/auth/ – Убедитесь, что вы добавляете путь аутентификации с слебой в конце.
Возможности и разрешения вашего Slack App уже будут настроены со следующими СКОРОЙ :
“Slack_oauth_scope”: Бот, команды, чат: писать: бот, чат: напиши: пользователь, файлы: пишите: пользователь, каналы: история
Последняя переменная, которую вам нужно будет добавить, – это ваш ключ API Meetup. Встреча требует, чтобы каждый запрос аутентифицирован с ключом API.
Шаг 6: Получить ключ API встречи
Войдите или создайте учетную запись на METUP.COM. Голова на https://secure.meetup.com/meetup_api/key/ Чтобы получить ваш уникальный ключ API. Нажмите на замок, чтобы открыть ключ API и скопируйте его.
Вернитесь к вашему env.json Файл на Код на стандартной библиотеке Отказ Добавьте ключ встречи как «Ключ» Значение, точно так, как я сделал на изображении:
Обязательно сохраните изменения с ‘⌘ + S’ (или ударить Сохранить в правом нижнем углу).
На боковой панели меню __main __. JS Файл расположен ниже каталога событий. Разверните код вашего приложения Slack в стандартную библиотеку, нажав « Run ».
- Вскоре после развертывания вашего кода стандартная библиотека генерирует URL EndPoint HTTPS API, где ваш код жизни. Этот адрес состоит из вашего <имя пользователя> .api.stdlib.com, а затем имя, которое вы дали вам API @ Environment : https://janethl.api.stdlib.com/slack-meetup-bo T @ dev/
Теперь у нас есть URL, который позволит нам отправлять и получать сообщения из нашего приложения STRECT на API встречи. Теперь нам нужно установить наш URL как WebHook в Slack, поэтому давайте вернемся к приложению Slack App
Шаг 7: Создайте новую команду SLASH и установите веб -ookook
Теперь нам нужно установить наше приложение Slack, чтобы ответить на команду Slash ( / ). Для этого нам необходимо настроить веб-каучуку на странице API Slacks.
Что такое веб -ook?
Возможно, мы можем понять, что такое веб -ook, сравнивая его с API. API на основе запросов – это означает, что они работают, когда запрос сделан из приложения третьего лица. WebHook – это основана на событиях – код будет работать, когда определенное событие запускает его.
Чтобы установить веб -ook, поставщик услуг должен позволить своим потребителям регистрировать URL-адрес, где провайдер может отправлять информацию, когда событие происходит. В этом примере Slack позволяет нам зарегистрировать наш URL-адрес, и после того, как зарегистрирован команда SLASH, может вызвать наш веб -ook, который будет выполнять код в нашем URL.
Теперь, когда мы понимаем это, давайте отправимся на страницу API Slack, чтобы установить наш веб -ook. Найти и выберите Команды Slash в меню боковой панели.
После нажатия Создать новую команду , вам будет предложено ввести данные вашей команды, для этого примера использовать:
Команда: /nextmeetup.
Requesturl: https://<имя пользователя> .api.stdlib.com/ Команды/: BG
Краткое описание: Извлекает события встречи
Использование Подсказка: [ t; тема>]
Хит ” Сохранить ” После завершения.
Шаг 8: Включить OAuth & Permissions
Вернитесь к вашему Slack App В меню боковой панели нажмите OAuth & Permissions Отказ
Когда-то там вы захотите войти в Перенаправить URL Как следует: https://<имя пользователя> .api.stdlib.com/
Нажмите «Добавить» и «Сохранить URL».
Этот URL-адрес перенаправления должен соответствовать URL-адресу, которое мы установили на env.json. Файл по коду в стандартной библиотеке.
Шаг 9: Добавьте бот в ваше приложение Slack
Вернитесь в свою страницу приложения Slack и нажмите Пользователи бота на левой боковой панели Отказ Нажмите Добавить пользователя usot Отказ Держите настройки по умолчанию.
Последний шаг это разрешить приложение. В вашем браузере введите: https://<имя пользователя> .api.Stdlib.com/
Нажмите на Добавить в Slack кнопка. Вы будете доставлены на другой экран авторизации.
Нажмите Разрешать Отказ Вы должны увидеть сообщение успеха!
Шаг 10: Проверьте свое приложение Slack Meetup
Вы все сделали. Попробуйте! Ваше Slack App теперь доступен для использования в Slack Workspace, для которого вы авторизовали его. Ваше приложение Slack следует ответить на /NextMeetup <94709> &
Это так и спасибо!
Я надеюсь, что вы нашли этот учебник полезным. Я бы полюбил тебя к Комментарий здесь , E-Mail Me в Janeth [AT] STDLIB [DOT] COM или следовать Стандартная библиотека В Твиттере @Stdlibhq Отказ
Janeth Ledezma – это защитник разработчика для стандартной библиотеки и Cal Grad – Go Bears! Когда она не изучает арабский язык или разрабатывает, вы можете найти ее исследующий Norcal на своем CBR500R. ??? Фол Низкое путешествие со стандартной библиотекой через Twitter @MS S_ledezma.