Api:Чтение:Арт:Список

Материал из wiki

Перейти к: навигация, поиск

Адрес этого api: http://api.4otaku.org/read/art/list

Если вы еще не работали с Api для чтения, то для начала следует прочесть вот эти три статьи: Api:Запрос, Api:Ответ, Категория:Api:Чтение.

Содержание

[править] Обязательные поля запроса

Отсутствуют. Запрос может не содержать ни одного параметра.

[править] Дополнительные поля запроса

[править] Поле add_meta

Если задано, то к ответу будут присоединены дополнительные данные: теги артов, количество вариаций, рейтинг, логин залившего арт пользователя.

[править] Поле no_group

По умолчанию вариации одного и того же арта сгруппированы так, что если больше чем одна вариация одного и того же удовлетворяет условиям запроса, показана будет все равно только одна вариация.

[править] Поле filter

Это поле состоит из массива фильтров. Каждый фильтр в свою очередь - ассоциативный массив и состоит из полей name, type и value. Таким образом поле filter - это массив ассоциативных массивов. Давайте рассмотрим поля, из которых состоит отдельный фильтр.

name - название фильтра. Может принимать следующие значения: art_tag, state, art_pack, art_group, art_manga, art_artist, art_rating, comment_count, comment_date, tag_count, date, md5, width, height, weight, id_parent, id_user, user.

type - тип операции фильтра. Равно, не равно, меньше или больше должно быть значение для арта, чтобы он удовлетворил условиям фильтра. Может принимать следующие значения: is, equal, more, less, not. Значение is и equal тождественны.

value - значение переданное в фильтр, то с чем надо сравнивать указанное в name значение арта.

Описание возможных значений поля name:

art_tag Тег или вариант написания тега. value должно быть текстовым.
state Состояние арта. value должно быть текстовым и ограничено одним из этих значений: tagged, untagged, approved, unapproved, disapproved.
art_pack CG-пак, к которому относится арт. value должно быть целочисленным и содержать номер CG-пака.
art_group Группа, к которой относится арт. value должно быть целочисленным и содержать номер группы.
art_manga Манга, к которой относится арт. value должно быть целочисленным и содержать номер манги.
art_artist Галерея, к которой относится арт. value должно быть целочисленным и содержать номер галереи.
art_rating Суммарный рейтинг арта. value должно быть целочисленным.
comment_count Количество комментариев к этому арту. value должно быть целочисленным.
comment_date День когда был добавлен последний комментарий арта. В формате ГГГГ-ММ-ДД (например 2012-06-27). По техническим причинам пока не работает с типом "not", только с "is", "equal", "more" и "less".
translation_date День когда была последняя правка переводов арта. В формате ГГГГ-ММ-ДД (например 2012-06-27). По техническим причинам пока не работает с типом "not", только с "is", "equal", "more" и "less".
tag_count Количество тегов у этого арта. value должно быть целочисленным.
date День когда арт был добавлен или попал в основной список. В формате ГГГГ-ММ-ДД (например 2012-06-27). По техническим причинам пока не работает с типом "not", только с "is", "equal", "more" и "less".
md5 md5 арта. value должно содержать 32-х символьный хешкод.
id Порядковый номер арта. value должно содержать целое число.
width Ширина арта, в пикселях. value должно быть целочисленным.
height Высота арта, в пикселях. value должно быть целочисленным.
weight Размер файла арта, в байтах. value должно быть целочисленным.
id_parent Родитель, которому принадлежит этот арт как вариация. value должно быть целочисленным и являться номером арта. Сам арт с таким номером тоже будет в результатах выборки.
id_user ID-номер пользователя, добавившего арт. value должно быть целочисленным.
user Тоже, что и предыдущее, но value задается строкой равной нику пользователя.

По умолчанию не используется ни одного фильтра.

Пример: Выбирает протеганные арты юзера с идентификатором 8.

   http://api.4otaku.org/read/art/list?filter[0][name]=id_user&filter[0][type]=equal&filter[0][value]=8&filter[1][name]=state&filter[1][type]=equal&filter[1][value]=tagged

[править] Поле sort_value

Дополнительное значение для сортировки, может содержать номер группы, пака или манги.

[править] Допустимые варианты сортировки

Принимает следующие значения: none, random, date, width, height, weight, size, parent_order, rating, comment_count, comment_date, tag_count, group, manga, pack.

none Оставить без сортировки. По идее из-за особенностей нашей работы с БД должно получится по порядку следования номеров арта, но не обязательно. Выполняется на долю секунды быстрее всех остальных вариантов.
random Случайный порядок. Все арты перемешиваются и показываются вразнобой.
date По максимальному значению из даты добавления и даты одобрения + проставления тегов.
width В порядке ширины изображения.
height В порядке высоты изображения.
weight В порядке веса файла с изображением.
size В порядке размера изображения, то есть по ширине умноженной на высоту.
rating По суммарному рейтингу изображения.
parent_order В порядке заданном для вариаций. В этом случае большее значение будет у артов, являющихся вариациями, и идущих в конце списка вариаций, меньшее - у артов вариациями не являющимися.
comment_count По количеству комментариев.
comment_date По дате последнего комментария.
translation_date По дате последней правки перевода.
tag_count По количеству тегов.
group Требует поле sort_value. По порядку добавления артов в группу, номер которой берется из дополнительного значения.
pack Требует поле sort_value. По порядку заданному в CG-паке, номер которой берется из дополнительного значения.
manga Требует поле sort_value. По порядку заданному в манге, номер которой берется из дополнительного значения.

По умолчанию равен date.

[править] Содержимое элемента массива data

[править] id

ID-номер картинки.

[править] id_parent

ID-номер картинки являющейся родителем для данной вариации. В случае если этот арт не является вариацией, повторяет значение поля id.

[править] id_user

ID-номер пользователя добавившего эту картинку.

[править] md5

md5 хеш-сумма файла картинки.

[править] ext

Расширение файла с картинкой.

[править] animated

Является ли картинка анимацией. 0 - не является, 1 - является.

[править] sortdate

Дата добавления или же дата простановки тегов + одобрения модераторами, если есть. Пример формата: 2010-05-31 20:52:25.

[править] tag

Появляется, только если установлено не нулевое значение параметру запроса "add_meta".

Массив тегов этого арта. Каждый элемент массива имеет следующие четыре поля: name, color, have_description, count.

name - имя тега. color - пустота или hex-код цвета этого тега. have_description - имеет ли описание на вики, 0 - не имеет, 1 - имеет. count - примерное количество артов с этим тегом.

[править] similar_count

Появляется, только если установлено не нулевое значение параметру запроса "add_meta".

Количество вариаций в семействе. Если на этот арт нет вариаций, то значение будет равно 1, в противном случае оно будет равно 1 + количество дополнительных вариаций.

[править] rating

Появляется, только если установлено не нулевое значение параметру запроса "add_meta".

Рейтинг арта, целочисленное значение.

[править] user

Появляется, только если установлено не нулевое значение параметру запроса "add_meta".

Ник добавившего этот арт пользователя.

Личные инструменты
Пространства имён
Варианты
Действия
Навигация
Инструменты