Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Mastodon: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Посты пользователяuser_posts | Получайте посты одного аккаунта Mastodon, указанного как имя пользователя или user@instance в username. | $1.39 за 1 000 запросов | Норма |
Профилиprofile | Найдите аккаунт Mastodon по имени пользователя или адресу user@instance и получите его отображаемое имя, полный handle, домашний инстанс и ссылку на профиль. | $1.39 за 1 000 запросов | Норма |
Хештегhashtag | Просматривайте посты по хештегу Mastodon, переданному без # в hashtag: автор, текст, язык, ссылки на медиа и число лайков, бустов и ответов. | $1.39 за 1 000 запросов | Норма |
Трендыtrending | Получайте популярные посты инстанса Mastodon: mastodon.social, если в instance не указан другой. | $1.39 за 1 000 запросов | Норма |
Лентаtimeline | Читайте публичную ленту инстанса Mastodon, по умолчанию fosstodon.org. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Mastodon?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
user_postsПосты пользователя Получайте посты одного аккаунта Mastodon, указанного как имя пользователя или user@instance в | username | instance | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
profileПрофили Найдите аккаунт Mastodon по имени пользователя или адресу user@instance и получите его отображаемое имя, полный | username | instance | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | username · display_name · handle · instance · url · platform |
hashtagХештег Просматривайте посты по хештегу Mastodon, переданному без # в | hashtag | instance | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
trendingТренды Получайте популярные посты инстанса Mastodon: mastodon.social, если в | instance | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags | |
timelineЛента Читайте публичную ленту инстанса Mastodon, по умолчанию fosstodon.org. У каждого поста есть автор, текст, язык, ссылки на медиа и число лайков, бустов и ответов. Это не персональная лента авторизованного пользователя и не архив всего Mastodon. | instance | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
Что означают параметры действия user_posts в API Mastodon?
Получайте посты одного аккаунта Mastodon, указанного как имя пользователя или user@instance в username. Для каждого поста есть число лайков, бустов и ответов, язык и флаг буста. Одноимённые аккаунты на других инстансах не объединяются. Полная история не гарантируется.
usernameОбязательный- Имя аккаунта Mastodon или полный формат user@instance, символ @ в начале необязателен. Если передано короткое имя без инстанса, используется mastodon.social. Одинаковые имена пользователей на разных инстансах принадлежат разным аккаунтам.Mastodon WebFinger: при определении идентификатора аккаунта необходимо учитывать домен — Официальная документация прямо указывает, что @user
@example.com и @user @example.org являются разными аккаунтами, поскольку аккаунт определяется и именем пользователя, и доменом. Этот документ поясняет правила идентификации аккаунтов и не означает, что шлюз возвращает все официальные метаданные объекта Account. · Проверено instanceНеобязательный- Домен инстанса Mastodon без схемы и пути. По умолчанию timeline использует fosstodon.org, остальные действия используют mastodon.social. Явно заданный instance имеет приоритет над доменом в username, поэтому значения должны совпадать.
Что означают параметры действия profile в API Mastodon?
Найдите аккаунт Mastodon по имени пользователя или адресу user@instance и получите его отображаемое имя, полный handle, домашний инстанс и ссылку на профиль. Имя пользователя без указания инстанса ищется на mastodon.social, если не задан instance. Совпадение не доказывает, что найден именно тот аккаунт, который вы имели в виду.
usernameОбязательный- Имя аккаунта Mastodon или полный формат user@instance, символ @ в начале необязателен. Если передано короткое имя без инстанса, используется mastodon.social. Одинаковые имена пользователей на разных инстансах принадлежат разным аккаунтам.Mastodon WebFinger: при определении идентификатора аккаунта необходимо учитывать домен — Официальная документация прямо указывает, что @user
@example.com и @user @example.org являются разными аккаунтами, поскольку аккаунт определяется и именем пользователя, и доменом. Этот документ поясняет правила идентификации аккаунтов и не означает, что шлюз возвращает все официальные метаданные объекта Account. · Проверено instanceНеобязательный- Домен инстанса Mastodon без схемы и пути. По умолчанию timeline использует fosstodon.org, остальные действия используют mastodon.social. Явно заданный instance имеет приоритет над доменом в username, поэтому значения должны совпадать.
Что означают параметры действия hashtag в API Mastodon?
Просматривайте посты по хештегу Mastodon, переданному без # в hashtag: автор, текст, язык, ссылки на медиа и число лайков, бустов и ответов. Посты берутся из ленты тега одного инстанса. В эту ленту не входят посты-бусты и ответы, поэтому она не отражает всё обсуждение в федерации.
hashtagОбязательный- Тег темы без символа # в начале для получения ленты хештега на целевом инстансе. Бусты и ответы исключаются, поэтому результат не является полной выборкой тегов федеративной сети.Mastodon: ленты хештегов и ограничения публичного предпросмотра инстанса — Официальная документация указывает, что ленты хештегов возвращают публичные статусы с указанным тегом, а путь тега указывается без символа #; если публичный предпросмотр отключён, доступ к инстансу ограничен. Параметры EveryInfra для исключения Boosts и ответов описаны на этой странице и не повторяют все официальные ключи запроса. · Проверено
instanceНеобязательный- Домен инстанса Mastodon без схемы и пути. По умолчанию timeline использует fosstodon.org, остальные действия используют mastodon.social. Явно заданный instance имеет приоритет над доменом в username, поэтому значения должны совпадать.
Что означают параметры действия trending в API Mastodon?
Получайте популярные посты инстанса Mastodon: mastodon.social, если в instance не указан другой. У каждого поста есть автор, текст, язык, медиа и число лайков, бустов и ответов. Позиции и счётчики отражают момент вызова. Они не объясняют алгоритм трендов и не ранжируют весь федиверс.
instanceНеобязательный- Домен инстанса Mastodon без схемы и пути. По умолчанию timeline использует fosstodon.org, остальные действия используют mastodon.social. Явно заданный instance имеет приоритет над доменом в username, поэтому значения должны совпадать.
Что означают параметры действия timeline в API Mastodon?
Читайте публичную ленту инстанса Mastodon, по умолчанию fosstodon.org. У каждого поста есть автор, текст, язык, ссылки на медиа и число лайков, бустов и ответов. Это не персональная лента авторизованного пользователя и не архив всего Mastodon.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеinstanceНеобязательный- Домен инстанса Mastodon без схемы и пути. По умолчанию timeline использует fosstodon.org, остальные действия используют mastodon.social. Явно заданный instance имеет приоритет над доменом в username, поэтому значения должны совпадать.
Как использовать API Mastodon
- 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":"mastodon","action":"user_posts","params":{"username":"<username>"}}'
Вопросы об API Mastodon
Какие данные можно получить через API Mastodon?
Укажите в platform значение mastodon. В текущем каталоге: посты пользователя, профили, хештег, тренды и лента. Эти названия действий соответствуют разным объектам или представлениям Mastodon; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса user_posts к платформе Mastodon?
Имя аккаунта Mastodon или полный формат user@instance, символ @ в начале необязателен. Если передано короткое имя без инстанса, используется mastodon.social. Одинаковые имена пользователей на разных инстансах принадлежат разным аккаунтам. Передайте это значение в поле username объекта params.
Какие поля может вернуть user_posts на платформе Mastodon?
Объявленная схема включает text, author_name, author_username и author_url. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Mastodon возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.