Это руководство предназначено для тех, кто хочет создать приложение, которое обеспечивает взаимодействие server_to_server с API Zoom для управления вашей учетной записью.
Создайте приложение Zoom
- Доступ к Zoom marketplace
- Войти
- Нажмите кнопку
Develop
в заголовке и выберитеBuild App
меню. - Выберите
JWT
и создайте приложение с тем именем, которое хотите. - Введите необходимую информацию и нажимайте
Continue
, пока ваше приложение не будет активировано. Не забудьте запомнить свои учетные данные. Он используется для вызова API.
Создать проект
Конечная точка API тестирования
Теперь нам нужно изменить файл маршрутов api, чтобы проверить правильность наших настроек.
Зайдите на http: // localhost: 8000 / api и убедитесь, что наши настройки установлены правильно. Если ваш исходный код работает правильно, давайте приступим к настройке некоторых параметров для использования API Zoom.
Добавить библиотеки и настройки
Чтобы использовать server_to_server Zoom API, нам нужно сгенерировать JWT. А для аутентификации нам нужно связаться с Zoom.
Поэтому я добавляю в свой проект библиотеки firebase/php-jwt
и guzzlehttp/guzzle
.
Кроме того, нам нужно изменить .env
файлы, чтобы установить URL-адрес API, ключ и секрет масштабирования.
Прежде чем создавать конечные точки, подумайте, что мы хотим сделать.
Мы хотим GET
список собраний, GET
информацию о собрании, UPDATE
информацию о собрании, DELETE
собрание. Требуются 4 типа запросов, верно?
Итак, я создам черты, включающие в себя несколько распространенных методов.
Сделайте черты, чтобы легко использовать общие методы
Первый метод трейта ZoomJWT - generateZoomToken
. Чтобы использовать Zoom API, мы должны включить токен JWT в запрос.
Используя firebase/php-jwt
библиотеку, очень просто сгенерировать JWT. Он возвращает закодированный токен JWT строкового типа.
Во-вторых, мы создадим метод для получения переменной окружения ZOOM_API_URL
.
Третий метод возвращает Request
. Мы будем использовать этот Request
экземпляр для отправки запроса в конечную точку API Zoom.
Эти методы возвращают Response
, который используется для выполнения GET/POST/PATCH/DELETE
запроса.
Последние методы используются для генерации нового формата строки даты и времени.
Я буду использовать <input type="datetime-local">
формат, чтобы установить время начала встречи, но эта форма просто получит yyyy-MM-dd\THH:mm
формат данных.
Чтобы использовать Zoom API, мы должны изменить формат времени на yyyy-MM-dd\THH:mm:ss
. Вот почему я создаю эти 2 метода.
Сделать конечные точки API
Я создам 5 конечных точек.
У конференц-залов Zoom есть идентификатор, который состоит из данных типа integer
.
Сделать контроллер
Сейчас я буду управлять переговорными комнатами просто потому, что это всего лишь тестовое приложение.
Это раздел объявлений.
use
: использовать черты характераconst xxx = <numeric>
: Zoom поддерживает 4 типа встреч. В этот раз мы будем управлятьMEETING_TYPE_SCHEDULE
типом собрания, потому что это тип по умолчанию.
В этом разделе содержится список конференц-залов и их информация.
Чтобы легко справиться с start_time
с timezone
, я добавляю свойство start_at
в информацию.
Чтобы создать комнату для собраний, нам нужны различные свойства, но в этот раз мы просто используем topic
, agenda
и start_time
.
Если вы хотите установить больше различных параметров для создания встречи, прочтите Справочник по API Zoom.
Далее следует получить раздел информации о встрече. Используя идентификатор конференц-зала, мы можем легко получить информацию о конференц-зале.
Раздел обновления почти такой же, как и раздел создания.
Последний раздел - это раздел удаления. Он используется, когда пользователь хочет удалить конкретное собрание.
Документ API
Вы можете проверить мой Документ API, сделанный Почтальоном.
Написать средний в Markdown? Попробуйте Маркдиум!