Если вы используете GIF, стикеры или короткие анимации в своих проектах, мы рады представить Gifs API v2 — обновленную версию API, которая стала проще, быстрее и удобнее для интеграции.
Новая версия создана с учетом современных стандартов разработки API и позволяет легче работать с медиаконтентом, сократить объем передаваемых данных и упростить поддержку проектов.
Что нового в Gifs API v2
Единый метод поиска
Теперь для поиска GIF, стикеров и лупов больше не нужно использовать разные методы. В Gifs API v2 реализован единый метод поиска, который работает со всеми типами контента.
Это упрощает интеграцию и делает код приложения значительно чище.
Новая структура ответов API
Мы полностью переработали формат ответов.
Теперь структура данных стала:
- более логичной;
- проще для обработки;
- информативнее для разработчиков;
- удобнее для масштабирования в будущем.
Это позволяет быстрее интегрировать API и уменьшает количество дополнительной обработки данных на стороне клиента.
Media Formats — все форматы в одном месте
Одним из главных нововведений стал блок media_formats.
Теперь для каждого объекта доступны все варианты медиафайлов, например:
- GIF;
- MP4;
- Tiny GIF;
- и другие доступные форматы.
Разработчику больше не нужно искать нужный формат в разных полях ответа — все собрано в одном месте.
Параметр media_filter
Для оптимизации скорости работы мы добавили параметр media_filter.
Он позволяет заранее указать, какие форматы файлов необходимо получить.
Например, если приложению требуется только MP4, API не будет передавать GIF и остальные форматы. Это позволяет:
- уменьшить размер ответа;
- ускорить загрузку;
- снизить потребление трафика;
- повысить производительность мобильных приложений и веб-сервисов.
До 50 объектов по ID
Максимальное количество объектов, которые можно запросить по идентификаторам, увеличено:
было: до 30 объектов
стало: до 50 объектов
Это особенно удобно для проектов, которые загружают подборки GIF или отображают сразу большое количество медиа.
Единая обработка ошибок
В новой версии реализован единый формат ошибок.
Теперь приложения могут проще обрабатывать любые исключительные ситуации без дополнительных проверок различных форматов ответов.
Это делает интеграцию более предсказуемой и уменьшает количество кода.
Версионирование API
Gifs API теперь использует версионирование:
Такой подход позволяет добавлять новые функции без нарушения совместимости существующих интеграций.
В дальнейшем API сможет развиваться значительно быстрее, сохраняя стабильность для разработчиков.
Совместимость с Gifs API v1
Если ваш проект уже использует Gifs API v1, ничего менять не нужно.
Первая версия продолжает работать в штатном режиме, поэтому существующие интеграции останутся полностью совместимыми.
Однако для:
- новых проектов;
- новых интеграций;
- дальнейшего развития продуктов
мы рекомендуем использовать Gifs API v2.
Почему стоит перейти на Gifs API v2
Новая версия API помогает разработчикам быстрее создавать современные приложения и сервисы.
Основные преимущества:
- единый поиск GIF, стикеров и лупов;
- современная структура ответов;
- поддержка всех медиаформатов через
media_formats; - выбор только нужных файлов с помощью
media_filter; - запрос до 50 объектов одновременно;
- единая обработка ошибок;
- стабильное версионирование API;
- более простая и удобная интеграция.
Начните использовать Gifs API v2
Мы сделали Gifs API v2 максимально удобным для разработчиков и приблизили его к лучшим практикам современных публичных API.
Если вы запускаете новый проект или планируете обновление существующей интеграции, рекомендуем начать работу именно с Gifs API v2.
Если во время перехода возникнут вопросы или понадобится помощь с интеграцией, команда Gifs.ru всегда готова помочь.
