API САЙТА

Документация для разработчиков сайта yapx.ru.

Япикс API позволяет получить все доступные сведения из базы данных о GIF-изображений сайта yapx.ru в формате JSON. На данный момент база насчитывает более 17 000+ GIF-изображений и постоянно пополняется.


База содержит только те изображения, которые выложены в публичный доступ и принадлежат таким категориям как: "Смешные", "Милые", "Ого, круто!", "Мысли и Знания", "Текущие события", "Реакция" и "Жесть". База не содержит изображения загруженные на фотохостинг yapx.ru, т.к это бы противоречило политике конфиденциальности и взглядам администрации сайта.

Возможности и ограничения GIF API

Доступ к API предостовляется посредством уникального токена. Для получения токена необходимо связаться с администрацией сайта по адресу admin [хрюшка] yapx.ru. В письме, пожалуйста, укажите какой сайт вы представляете и для каких целей вы хотите использовать API Япикса.

Пример GET запроса:
http://yapx.ru/API/gifs.json/?get=100&category=funny&size=30mb&order_by=random&access_token=[YOUR_TOKEN]
Пояснение: запросить 100 GIF-изображений из категории "Смешные" до 30mb в случайном порядке.
Возможности:
Параметр
Обязательный
По умолчанию
Значение
Описание
get
Нет
10
от 1 до 100
Количество запрашиваемых изображений.
size
Нет
20 MB
all
5 MB
10 MB
15 MB
20 MB
30 MB
40 MB
Размер изображений в мегабайтах.
order_by
Нет
random
random
Получить изображения в случайном порядке.
Ограничения:

▶ Не чаще, чем 1 запрос в 5 секунд.

▶ Максимально 100 изображений за один запрос.

Пример GIF-изображения:
Пример ответа в формате JSON:

[

{

"image_id": "45658382",

"content_type": "gif",

"thumbnail_url": "http://i.yapx.ru/FT73i.jpg",

"image_url": "http://i.yapx.ru/FT73i.gif",

"image_size": "12550015",

"image_width": "520",

"image_height": "520",

"video_url": "http://i.yapx.ru/FT73i.mp4",

"video_size": "2230386",

"video_width": "960",

"video_height": "960",

"keywords": "по лицу, боль, трюки, фэйл, идиоты"

},

...

]

Краткое описание:

image_id - Уникальный ID изображения.

category - Категория к которой относиться изображение.

content_type - Формат изображения.

thumbnail_url - Ссылка на изображения предварительного просмотра.

image_url - Прямая ссылка на изображение.

image_size - Размер изображения в байтах (bytes).

image_width - Размер ширины изображения в пикселях (px).

image_height - Размер высоты изображения в пикселях (px).

video_url - Ссылка на видео для GIF-изображения в формате MP4.

video_size - Размер видео в байтах (bytes).

video_width - Размер ширины видео в пикселях (px).

video_height - Размер высоты видео в пикселях (px).

keywords - Доступные ключевые слова к изображению.

Кидай мне свои картинки!
или
Нажми Ctrl+V
|