Проверять статус Desktop
Понять, подключён ли desktop relay и какие возможности доступны.
Используйте HTTPS endpoints, OpenAPI-документацию и scoped credentials, чтобы создавать, планировать, редактировать и отслеживать задания автоматизации в Queber Desktop
Создайте scoped credential в личном кабинете, держите Queber Desktop онлайн и вызывайте API endpoints с Authorization Bearer header.
Откройте Swagger UI и выполните запросы от имени своего Queber account.
Импортируйте schema, чтобы создавать, планировать, обновлять, проверять, отменять и повторять задания Queber из своих инструментов.
Рекомендуется для Airtable, Make, n8n, Zapier, scripts, cron и CI.
Вызовы API выполняются через desktop relay с активным входом.
Используйте Swagger для тестовых вызовов в браузере, затем импортируйте OpenAPI JSON schema в свой client или tooling.
Создайте scoped token в личном кабинете, сохраните его как secret во внешнем инструменте и отправляйте как Authorization Bearer header. OAuth остается доступен для интерактивных клиентов и hosted apps, которым нужен user consent.
Ваш клиент вызывает endpoint /actions в Queber REST API с персональным API-токеном или OAuth access token.
Queber проверяет токен, платный план и scopes, которые нужны этому endpoint.
Сервер передаёт команду в авторизованное Queber Desktop-приложение через защищённое фоновое соединение.
Endpoint возвращает структурированный JSON со статусом, профилями, задачами или результатом автоматизации.
Понять, подключён ли desktop relay и какие возможности доступны.
Смотреть список профилей, детали профиля, открывать профиль вручную или закрывать локальные сессии.
Получать список задач по страницам, читать задачу с результатом, логами и прогрессом, редактировать, отменять, архивировать, удалять и повторять задачи.
Создавать публикации в Reddit и проверки постов Reddit сразу или по расписанию.
Доступ контролируется OAuth-токенами, запрошенными scopes, проверкой платного плана и активным подключением Queber Desktop. Отзовите клиент, если больше ему не доверяете.
Задание проверки открывает каждую ссылку в фоновой вкладке браузерного профиля и возвращает то, что показывает страница поста: жив ли пост, удалён или его больше нет, рейтинг, долю апвоутов, комментарии и просмотры ваших собственных постов. Создайте одно задание и опрашивайте его, пока оно не завершится.
Отправьте POST /actions/jobs/run с automationType post_read и ссылками в platformData.reddit.post_read.links: подойдут полные ссылки на посты, old.reddit, redd.it, посты в профилях и ссылки «Поделиться». Добавьте Idempotency-Key; в ответ придёт задание со статусом pending.
Вызывайте GET /actions/jobs/{jobId} раз в несколько секунд, пока статус не станет completed или failed. Ссылки проверяются по очереди с человеческой паузой, поэтому длинный список проверяется дольше.
В resultData.reddit.post_read.items по одному элементу на ссылку со статусом ok, removed, not_found или failed, а summary их считает. У удалённого поста сообщение Reddit об удалении лежит в removalMessage; значение, которое Reddit не показал, равно null, а warnings объясняет почему.
Reddit показывает просмотры только автору поста, поэтому они приходят только для постов профиля, который проверяет, в том округлённом виде, в каком их показывает Reddit, например 5.2K. Каждая проверка своего поста добавляет на Reddit один просмотр.
Задание завершается ошибкой, только если не удалось проверить ни одной ссылки; неудачная ссылка получает статус failed, и проверка идёт дальше. Запуск оплачивается, если проверен хотя бы один пост, а сколько ссылок можно взять в один запуск, задаёт ваш тариф.
POST https://mcp.queber.app/actions/jobs/run
Authorization: Bearer <token>
Idempotency-Key: post-read-2026-08-12-01
{
"profileId": "3f1a2b4c-5d6e-4f70-8a91-b2c3d4e5f607",
"platform": "reddit",
"automationType": "post_read",
"platformData": { "reddit": { "post_read": { "links": [
"https://www.reddit.com/r/SideProject/comments/1abc234/queber_desktop_116_queue_view/",
"https://old.reddit.com/r/webdev/comments/1abd345/how_do_you_schedule_reddit_posts/",
"https://redd.it/1abe456"
] } } }
}
HTTP/1.1 201 Created
{ "job": { "id": "e2d4f6a8-1b3c-4d5e-8f70-9a1b2c3d4e5f", "automationType": "post_read", "status": "pending", … } }
GET https://mcp.queber.app/actions/jobs/e2d4f6a8-1b3c-4d5e-8f70-9a1b2c3d4e5f
Authorization: Bearer <token>
HTTP/1.1 200 OK
{ "job": { "status": "completed", "resultData": { "reddit": { "post_read": {
"items": [
{ "url": "https://www.reddit.com/r/SideProject/comments/1abc234/", "status": "ok", "readAs": "author",
"score": 13, "upvoteRatio": 0.93, "comments": 8, "views": 5200, "shares": 4, "reposts": 1,
"topCountries": [{ "country": "US", "name": "United States", "percent": 41.2 }, …], "authorRank": 2,
"warnings": [{ "field": "views", "code": "rounded", "message": "Reddit shows views rounded: 5.2K views" }], … },
{ "url": "https://www.reddit.com/r/webdev/comments/1abd345/", "status": "ok", "readAs": "other",
"score": 1001, "upvoteRatio": 0.96, "comments": 5348, "views": null,
"warnings": [{ "field": "views", "code": "author_only", "message": "Reddit shows views only to the post author" }], … },
{ "url": "https://www.reddit.com/comments/1abe456/", "status": "removed", "readAs": "author",
"removalMessage": "Sorry, this post has been removed by the moderators of r/example.", … }
],
"summary": { "total": 3, "read": 3, "removed": 1, "notFound": 0, "failed": 0 }
} } }, … } }Queber Desktop работает на вашем компьютере, поэтому запрос может застать спящий ноутбук, смену сети или медленный ответ. С этими правилами повтор запроса никогда не опубликует пост дважды.
Передавайте заголовок Idempotency-Key, например UUID, в каждом запросе, который что-то создаёт или меняет. Повтор с тем же ключом вернёт первый результат, а не опубликует пост второй раз, поэтому после таймаута или ответа 503 повторяйте запрос с тем же ключом. Для каждого задания и каждого изменённого запроса нужен новый ключ, а не один ключ на весь пакет.
Ответы 429 и 503 содержат заголовок Retry-After и retryAfterSeconds в теле ошибки, когда время ожидания известно. Подождите столько, затем повторите тот же запрос с тем же ключом. error.retryable показывает, может ли тот же запрос пройти позже; после desktop_offline сначала нужно открыть приложение.
Перед отправкой пакета вызовите GET /actions/status. connected — отправляйте. reconnecting — приложение отключилось и скоро вернётся, подождите retryAfterSeconds. offline — откройте Queber Desktop и войдите в аккаунт. conflict — закройте все старые desktop-приложения, кроме одного.
Пока приложение переподключается, запрос ждёт до 25 секунд, затем отвечает 503 desktop_reconnecting. Заголовок X-Queber-Desktop-Wait-Ms от 0 до 60000 меняет это время; таймаут вашего HTTP-клиента должен быть больше этого ожидания плюс 30 секунд (150 для импорта медиа).
POST https://mcp.queber.app/actions/jobs/schedule
Authorization: Bearer <token>
Idempotency-Key: post-2026-08-13-r-webdev-01
X-Queber-Desktop-Wait-Ms: 20000
{ "profileId": "3f1a2b4c-5d6e-4f70-8a91-b2c3d4e5f607", "platform": "reddit", … }
HTTP/1.1 503 Service Unavailable
Retry-After: 12
{
"error": {
"code": "desktop_reconnecting",
"message": "Queber Desktop lost its connection and is reconnecting. Retry the request shortly; you do not need to restart the app.",
"retryable": true,
"retryAfterSeconds": 12
}
}Если настройка токена, импорт схемы, API-вызовы или выполнение через Queber Desktop работают не так, как ожидается, напишите в поддержку Queber или в Telegram.
Комментарии и ответы в Reddit
Задание на комментарий оставляет один комментарий под постом или ответом на один из его комментариев, в фоновой вкладке браузерного профиля. Сначала бесплатно проверьте пост, выберите, куда ответить, создайте задание и опрашивайте его до завершения.
Проверьте пост
Отправьте POST /actions/reddit/comments/check с profileId и link. Он откроет пост этим профилем, бесплатно и вне очереди, и вернёт blocked (почему комментировать нельзя, или null), медиа, которые принимает поле комментария, и до 300 комментариев в thread. Если профиль нужно запустить, это может занять до 3 минут.
Выберите, куда ответить
Передайте id комментария из thread в replyToCommentId или не передавайте его, чтобы прокомментировать сам пост. У каждого комментария в thread есть автор, так что ответ конкретному пользователю — это фильтр по author. Ссылка на комментарий в link работает так же, как его id.
Создайте комментарий
Отправьте POST /actions/jobs/run с automationType comment и platformData.reddit.comment: link, body (текст или HTML) и не больше одной картинки, GIF или видео из importMedia. Добавьте Idempotency-Key; в ответ придёт задание со статусом pending.
Прочитайте результат
Опрашивайте задание до завершения. resultUrl — страница нового комментария, а resultData.reddit.comment содержит его id, комментарий, на который он отвечает, и alreadyPosted, если его оставил прошлый запуск и повторно ничего не отправлялось. Упавшее задание называет причину, например rate_limited с минутами, которые Reddit просит подождать.
Проверка бесплатна. Комментарий списывается, когда Reddit его показал; неудачный запуск и запуск, нашедший тот же комментарий на месте, ничего не стоят. С тем же Idempotency-Key второе задание не создаётся.