Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Lemmy: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите посты Lemmy на одном инстансе по keyword: сообщество, автор, рейтинг, голоса за и против, число комментариев, внешняя ссылка и флаги NSFW, блокировки и закрепления. | $1.39 за 1 000 запросов | Норма |
Сообществоcommunity | Читайте посты сообщества Lemmy по имени или в формате name@instance. | $1.39 за 1 000 запросов | Норма |
Лента новостейfeed | Просматривайте ленту постов инстанса Lemmy, по умолчанию lemmy.world. | $1.39 за 1 000 запросов | Норма |
Комментарииcomments | Получайте комментарии к постам сообщества Lemmy с рейтингом, голосами, глубиной, ID родительского комментария, флагом удаления и постом, к которому относится каждый комментарий. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Lemmy?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите посты Lemmy на одном инстансе по | keyword | instance, sort, top_range | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform |
communityСообщество Читайте посты сообщества Lemmy по имени или в формате name@instance. Получайте рейтинг, голоса, число комментариев, ссылки и флаги поста; по умолчанию сортировка по популярности (hot). Одноимённые сообщества на других инстансах не объединяются. | community | instance, sort, top_range | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform |
feedЛента новостей Просматривайте ленту постов инстанса Lemmy, по умолчанию lemmy.world. У каждого поста есть сообщество, рейтинг, голоса, число комментариев и флаги; по умолчанию сортировка по активности. Это не персональная лента и не полный обзор федиверса. | instance, sort, top_range | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform | |
commentsКомментарии Получайте комментарии к постам сообщества Lemmy с рейтингом, голосами, глубиной, ID родительского комментария, флагом удаления и постом, к которому относится каждый комментарий. | community | instance, max_comments, sort, top_range | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · text · author_username · author_url · score · upvote_count · downvote_count · depth · parent_comment_id · is_deleted · post_url · post_title · community · posted_at · platform |
Что означают параметры действия search в API Lemmy?
Ищите посты Lemmy на одном инстансе по keyword: сообщество, автор, рейтинг, голоса за и против, число комментариев, внешняя ссылка и флаги NSFW, блокировки и закрепления. Поиск идёт на выбранном instance, по умолчанию lemmy.world, и не охватывает весь федиверс.
keywordОбязательный- Поисковый запрос для действия search в Lemmy. Поиск выполняется на указанном инстансе, полный поиск по всем федеративным инстансам не гарантируется.Lemmy: видимость в инстансе не равна всему федиверсу — Официальные руководства для новичков поясняют, что инстансами управляют разные операторы: при обычном просмотре видны только сообщества, известные локальному инстансу, а объекты с других инстансов нужно находить отдельно. Этот контекст поясняет, какие данные видны с точки зрения отдельного инстанса и как устроены объекты публикаций, но не переносит полную функциональность веб-поиска в параметры шлюза. · Проверено
instanceНеобязательный- Выбирает домен инстанса Lemmy, например lemmy.world (он же используется по умолчанию). Полный URL инстанса тоже принимается, но сокращается до имени хоста. Определяет точку входа для запроса, а не название сообщества.
sortНеобязательный- Сортирует публикации: hot, active, new, top, most_comments или new_comments. По умолчанию используется hot для search и community, active для feed и most_comments для comments.Допустимые значения:
activehotmost_commentsnewnew_commentstop top_rangeНеобязательный- Задаёт период подсчёта рейтинга, только если sort равен top: hour, sixhour, twelvehour, day, week (по умолчанию), month, threemonths, sixmonths, ninemonths, year или all. Это не фильтр по дате публикации комментариев.Допустимые значения:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Что означают параметры действия community в API Lemmy?
Читайте посты сообщества Lemmy по имени или в формате name@instance. Получайте рейтинг, голоса, число комментариев, ссылки и флаги поста; по умолчанию сортировка по популярности (hot). Одноимённые сообщества на других инстансах не объединяются. top_range применяется только при сортировке по top.
communityОбязательный- Название сообщества или межинстансовый идентификатор в формате name@instance. В действии community выводит публикации сообщества; в действии comments получает публикации сообщества и раскрывает их комментарии, а не запрашивает напрямую URL одной публикации.Lemmy: идентификаторы сообществ и доступ с других инстансов — Официальные руководства приводят URL сообществ и формат идентификатора !name@instance и различают локальные и федеративные сообщества. В EveryInfra этот параметр задаётся как name или name@instance; префикс ! и форматы URL из официального интерфейса этот API автоматически не поддерживает. · Проверено
instanceНеобязательный- Выбирает домен инстанса Lemmy, например lemmy.world (он же используется по умолчанию). Полный URL инстанса тоже принимается, но сокращается до имени хоста. Определяет точку входа для запроса, а не название сообщества.
sortНеобязательный- Сортирует публикации: hot, active, new, top, most_comments или new_comments. По умолчанию используется hot для search и community, active для feed и most_comments для comments.Допустимые значения:
activehotmost_commentsnewnew_commentstop top_rangeНеобязательный- Задаёт период подсчёта рейтинга, только если sort равен top: hour, sixhour, twelvehour, day, week (по умолчанию), month, threemonths, sixmonths, ninemonths, year или all. Это не фильтр по дате публикации комментариев.Допустимые значения:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Что означают параметры действия feed в API Lemmy?
Просматривайте ленту постов инстанса Lemmy, по умолчанию lemmy.world. У каждого поста есть сообщество, рейтинг, голоса, число комментариев и флаги; по умолчанию сортировка по активности. Это не персональная лента и не полный обзор федиверса.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеinstanceНеобязательный- Выбирает домен инстанса Lemmy, например lemmy.world (он же используется по умолчанию). Полный URL инстанса тоже принимается, но сокращается до имени хоста. Определяет точку входа для запроса, а не название сообщества.
sortНеобязательный- Сортирует публикации: hot, active, new, top, most_comments или new_comments. По умолчанию используется hot для search и community, active для feed и most_comments для comments.Допустимые значения:
activehotmost_commentsnewnew_commentstop top_rangeНеобязательный- Задаёт период подсчёта рейтинга, только если sort равен top: hour, sixhour, twelvehour, day, week (по умолчанию), month, threemonths, sixmonths, ninemonths, year или all. Это не фильтр по дате публикации комментариев.Допустимые значения:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Что означают параметры действия comments в API Lemmy?
Получайте комментарии к постам сообщества Lemmy с рейтингом, голосами, глубиной, ID родительского комментария, флагом удаления и постом, к которому относится каждый комментарий. max_comments ограничивает число комментариев на пост (от 1 до 200, по умолчанию 50), а не общее число в запросе.
communityОбязательный- Название сообщества или межинстансовый идентификатор в формате name@instance. В действии community выводит публикации сообщества; в действии comments получает публикации сообщества и раскрывает их комментарии, а не запрашивает напрямую URL одной публикации.
instanceНеобязательный- Выбирает домен инстанса Lemmy, например lemmy.world (он же используется по умолчанию). Полный URL инстанса тоже принимается, но сокращается до имени хоста. Определяет точку входа для запроса, а не название сообщества.
max_commentsНеобязательный- Задаёт максимальное количество комментариев к одному посту в действии comments: по умолчанию 50, допустимый диапазон от 1 до 200. Ограничивает число комментариев на пост, а не общее количество постов или комментариев в запросе. Значения вне диапазона автоматически приводятся к его границам.Lemmy: иерархия вложенных комментариев и ограничения по количеству — Официальная документация поясняет комментарии верхнего уровня, иерархию вложенных ответов и расчёт рейтинга (голоса «за» минус голоса «против»). Лимит комментариев на публикацию — собственная настройка EveryInfra, а не официальный вариант сортировки; достижение лимита не гарантирует включения всех родительских и дочерних узлов. · Проверено
sortНеобязательный- Сортирует публикации: hot, active, new, top, most_comments или new_comments. По умолчанию используется hot для search и community, active для feed и most_comments для comments.Допустимые значения:
activehotmost_commentsnewnew_commentstop top_rangeНеобязательный- Задаёт период подсчёта рейтинга, только если sort равен top: hour, sixhour, twelvehour, day, week (по умолчанию), month, threemonths, sixmonths, ninemonths, year или all. Это не фильтр по дате публикации комментариев.Допустимые значения:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Как использовать API Lemmy
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"lemmy","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Lemmy
Какие данные можно получить через API Lemmy?
Укажите в platform значение lemmy. В текущем каталоге: поиск, сообщество, лента новостей и комментарии. Эти названия действий соответствуют разным объектам или представлениям Lemmy; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Lemmy?
Поисковый запрос для действия search в Lemmy. Поиск выполняется на указанном инстансе, полный поиск по всем федеративным инстансам не гарантируется. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Lemmy?
Объявленная схема включает title, body, external_url и community. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Lemmy возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.