Linework Open API · v1
Создавайте на Linework
Простой REST API для автоматизации вашего аккаунта Linework: публикуйте посты и истории, общайтесь с сообществом, ведите магазин Bloop и отвечайте клиентам в чате.
Что можно создать#
Боты для публикаций
Загружайте фото и видео, публикуйте посты и истории, редактируйте и удаляйте их.
СообществоИнструменты для сообщества
Читайте комментарии к своим постам, отвечайте, ставьте лайки и подписывайтесь.
BloopАвтоматизация магазина
Синхронизируйте товары и остатки из своих систем, получайте заказы и отмечайте их отправленными.
ЧатБоты поддержки
Отвечайте тем, кто вам пишет, никому не рассылая спам.
API действует от имени вашего собственного аккаунта: каждый запрос выполняется от лица пользователя, создавшего ключ API, с разрешениями (scopes), выбранными для этого ключа. Платежи, кошелёк и токены через API недоступны.
Быстрый старт за 3 шага#
- Запросите доступ разработчика. В веб-приложении Linework откройте Настройки → Разработчикам и расскажите, что вы хотите создать (сценарий использования, сайт, имя бота). Мы рассматриваем каждую заявку.
- Создайте ключ API. После одобрения создайте ключ на той же странице и выберите его scopes. Ключ начинается с
lwk_и показывается только один раз: сохраните его в надёжном месте. - Выполните первый запрос.
curl https://api.linework.app/open/v1/me \ -H "Authorization: Bearer $LINEWORK_API_KEY"const res = await fetch("https://api.linework.app/open/v1/me", { headers: { Authorization: `Bearer ${process.env.LINEWORK_API_KEY}` }, }); console.log(await res.json());import os, requests r = requests.get( "https://api.linework.app/open/v1/me", headers={"Authorization": f"Bearer {os.environ['LINEWORK_API_KEY']}"}, ) print(r.json())
Основное с первого взгляда#
| Параметр | Значение |
|---|---|
| Базовый URL | https://api.linework.app/open/v1 |
| Аутентификация | Authorization: Bearer lwk_… — подробнее |
| Формат | JSON, поля в camelCase, id в виде строк, даты в ISO 8601 (UTC) |
| Ограничение частоты | 120 запросов в минуту на ключ — ограничения и дневные квоты |
| Пагинация | На основе cursor: ?limit=&cursor= → { data, next_cursor } — подробнее |
| Ошибки | { "error": { "code", "message" } } — коды ошибок |
| Файл OpenAPI | /openapi/linework-open-v1.yaml |
Ведите себя корректно. Боты в Linework обязаны соблюдать правила сообщества и Условия использования API. Никакого спама, скрейпинга и выдачи себя за других. Ключи, нарушающие правила, отзываются.