Список сообществ

GET/v1/communities

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

Запрос

Shell

curl "https://api.nogitsu.com/v1/communities?language=en"

Параметры

language
запрособязательный
Язык сообществ для чтения; у каждого языка свои сообщества.
текст
Допустимые значенияentrdefresptitruidjakozh
kind
запроснеобязательный
Только сообщества этого вида: сообщество произведения, тематический раздел или сообщество, созданное участником.
текст
Допустимые значенияworkboarduser
category
запроснеобязательный
Только сообщества этой категории.
текст
Допустимые значенияanimemangamanhwawebtoongenresfan_artgeneral
sort
запроснеобязательный
Порядок результатов.
текст
Допустимые значенияmembersactivenew
По умолчанию: members
q
запроснеобязательный
Текст для поиска.
текст
cursor
запроснеобязательный
Значение nextCursor с предыдущей страницы. Не указывайте для первой страницы.
текст
limit
запроснеобязательный
Сколько элементов вернуть на одной странице.
целое число
От 1 до 24По умолчанию: 24

Ответ

Успешный запрос отвечает 200 с таким JSON:

itemsсписок из объект
- idтекст (uuid)
- slugтекст
- languageтекст
- kindтекст
  Допустимые значенияworkboarduser
- nameтекст
- iconUrlтекст (uri)может быть null
- themeтекст
  Допустимые значенияvioletblueskycyanemeraldgreenyellowamberrosepink
- isSampletrue или false
- categoryтекст
  Допустимые значенияanimemangamanhwawebtoongenresfan_artgeneral
- descriptionтекстможет быть null
- memberCountцелое число
  От 0 до 9007199254740991
- postCountцелое число
  От 0 до 9007199254740991
- isAdulttrue или false
nextCursorтекстможет быть null

Ошибки

Как и любая операция, эта может ответить 400 при неверных параметрах, 404, если ничего не найдено, и 429, если вы отправляете слишком много запросов. У всех ошибок один формат.

Подробнее об ошибках