Giphy и Twilio: отправка GIF по SMS через RapidAPI

*Эта статья **изначально появилась** в блоге RapidAPI от **Линдси Кирхгофф**. RapidAPI — это маркетплейс, где разработчики могут тестировать и подключаться к нескольким API из одной точки. Линдси создала API Smash, используя **Twilio SMS** и **Giphy** для отправки GIF по SMS.*

Одной из причин, по которой мы создали RapidAPI, стало упрощение вызова нескольких API через единую консоль. Больше никаких переключений между различными библиотеками API!

Мы начинаем серию, в которой будем объединять два API для создания проекта. Сегодня? Мы объединим Giphy и Twilio, чтобы создать скрипт «Отправь GIF по SMS», который будет отправлять GIF пользователю по запросу.

Мы создали приложение «Отправь GIF по SMS», которое работает в Терминале. Пользователь вводит фразу и номер телефона, а приложение «Отправь GIF по SMS» отправляет связанный случайный GIF. Посмотрите демо ниже!

Мы построили этот проект, экспортировав фрагменты кода JavaScript из пакетов API Giphy и Twilio на RapidAPI. Вы можете воссоздать это приложение на предпочитаемом вами языке, заполнив параметры на RapidAPI и экспортировав фрагмент на выбранном языке (например, Python, PHP, Java, Objective-C и cURL).

А теперь, как мы это сделали!

Первые строки кода вызывают RapidAPI. (Если вы еще не установили его, вы пройдете через этот процесс при регистрации бесплатной учетной записи RapidAPI).

Далее, приложение «Отправь GIF по SMS» требует, чтобы пользователь ввел текст и номер телефона из командной строки. Следующие строки кода сохраняют эти пользовательские входные данные в двух переменных.

*Примечание: чтобы Twilio мог прочитать номер телефона, он должен быть в **формате E.164**. Это означает «» + код страны, затем номер, без тире или пробелов. Например, 18008675309.*

**Как вызвать API Giphy**

Нашим следующим шагом было подключение к Giphy через пакет RapidAPI и экспорт фрагмента кода на JavaScript.

Конечная точка, которую мы использовали для этого приложения, — `translateTextToGif`

. Эта конечная точка генерирует GIF на основе введенного вами слова. Вы можете даже фильтровать результаты по рейтингу (G, PG, PG-13, R) и языку (используя код страны ISO 639-1 — английский «en»).

Вы можете протестировать эту конечную точку прямо в своем браузере. Введите указанные выше параметры и используйте dc6zaTOxFJmzC в качестве `access_token`

. Giphy предоставляет публичный бета-ключ для использования кем угодно. (Если вы хотите подать заявку на производство, вы можете запросить производственный ключ здесь).

**Интеграция API Giphy в код**

Используя конечную точку `translateTextToGiF`

, API Giphy генерирует GIF на основе текста, введенного пользователем в Терминале (в данном случае, `gifText`

).

Если вызов успешен, скрипт вызовет API Twilio для отправки MMS с сгенерированным GIF. Если вызов неуспешен, скрипт прочитает сообщение об ошибке, которое сообщит пользователю, что проблема была с генерацией GIF.

**Как вызвать API Twilio**

Нашим следующим шагом было подключение к API Twilio для отправки текстового сообщения. Чтобы подключиться к API Twilio, вам понадобятся `accountToken`

, `accountSid`

, `messagingSid`

, а также сгенерировать номер телефона Twilio. Все это можно получить бесплатно в консоли Twilio. Вот краткая заметка о том, как получить необходимые вам учетные данные.

*Примечание: если вы сгенерируете **бесплатный** исходящий номер телефона с вашей учетной записью разработчика Twilio, то номер телефона, который вы ассоциируете с бесплатным исходящим номером, — единственный, на который вы можете отправлять сообщения. В этом случае приложение «Отправь GIF по SMS» будет отправлять GIF только на ваш номер телефона. Чтобы отправить сообщение на любой номер, вам необходимо приобрести обновление (см. подробнее в **консоли разработчика Twilio**). *

**Интеграция API Twilio в код**

Для проекта «Отправь GIF по SMS» мы вызвали конечную точку `sendMms`

. Используя эту конечную точку, Twilio может отправить мультимедийное сообщение на номер телефона, введенный пользователем (в данном случае, переменная `phoneNumber`

).

Конечная точка `translateTextToGiF`

API Giphy возвращает различные данные. Для хранения URL изображения мы создали переменную `gif`

. (Прокрутите вниз по коду, чтобы отобразить).

Если вызов API Giphy успешно сгенерирует GIF, то API Twilio получит URL изображения (`gif`

) и отправит его по SMS на номер телефона, который пользователь ввел изначально (`phoneNumber`

). Затем скрипт выведет пользователю сообщение «Проверьте свой телефон!». Если вызов API Twilio неуспешен, скрипт вернет сообщение «Ошибка отправки MMS.»

Эта статья не была бы полной без хотя бы одного праздничного GIF. Сообщите нам, что вы думаете об этом проекте или API Giphy в комментариях ниже. Или дайте нам предложения, какие API нам следует объединить в следующий раз!