Дополнительно
FAQ
Краткие ответы на вопросы, которые нам задают чаще всего.
Доступ и ключи#
API бесплатный?
Да. Использование Linework Open API бесплатно в пределах ограничений и квот.
Зачем нужно запрашивать доступ?
Каждый бот действует в реальной социальной сети с реальными людьми. Короткая проверка защищает от спама и злоупотреблений и помогает нам понять, что создают разработчики. После одобрения доступа вы сразу можете создавать ключи.
Сколько времени занимает одобрение?
Мы стараемся рассматривать заявки в течение нескольких рабочих дней. Статус отображается в разделе Настройки → Разработчикам.
Я потерял ключ API. Можно показать его ещё раз?
Нет. Ключи показываются только один раз, и мы храним лишь их хеш. Отзовите потерянный ключ и создайте новый.
Можно ли изменить scopes ключа?
Нет. Создайте новый ключ с нужными scopes, переключите на него интеграцию, затем отзовите старый ключ. У вас может быть до 5 активных ключей.
Можно ли действовать от имени других пользователей Linework (OAuth)?
В v1 — нет. Ключ всегда действует от имени аккаунта, который его создал. Если вам это нужно, напишите нам на developers@linework.app.
Возможности API#
Можно ли проводить платежи или пользоваться кошельком?
Нет. Платежи, кошелёк, токены и переводы намеренно недоступны через API. Заказы Bloop оплачиваются покупателями в приложении; через API вы управляете товарами, остатками и доставкой.
Начисляются ли вознаграждения за действия через API?
Нет. Посты, лайки, комментарии и подписки, сделанные через API, не приносят вознаграждений за активность.
Может ли мой бот писать кому угодно?
Нет. Бот может писать только тем, кто уже писал в этой переписке или подписан на аккаунт. См. правило антиспама.
Можно ли читать данные всех пользователей для исследований или аналитики?
Нет. Массовый сбор данных (скрейпинг) запрещён — как через API, так и иными способами. См. Условия использования API.
Есть ли webhook?
Пока нет: опрашивайте endpoint со списками с разумным интервалом (например, каждые 30–60 секунд). Webhook — в наших планах.
Можно ли вызывать API из браузера или мобильного приложения?
Не делайте этого. Ключ будет виден кому угодно. Вызывайте API со своего сервера, а приложение пусть обращается к вашему серверу.
Ошибки и ограничения#
Я получаю 403 PROFILE_INCOMPLETE.
Для endpoint записи нужен аккаунт с фото профиля и обложкой. Добавьте их в приложении и повторите попытку.
Я получаю 401 на каждый вызов.
Проверьте заголовок: строго Authorization: Bearer lwk_…, без кавычек и пробелов в ключе. Убедитесь, что ключ не был отозван.
Мне нужно больше 50 постов в день.
Напишите на developers@linework.app и опишите свой сценарий. Повышенные лимиты рассматриваются индивидуально.
Поддержка#
Как получить помощь?
Напишите на developers@linework.app, указав endpoint, время запроса (UTC) и code ошибки. Никогда не отправляйте свой ключ API.