Linework Developers
RU
Получить доступ

Linework Open API · v1

Создавайте на Linework

Простой REST API для автоматизации вашего аккаунта Linework: публикуйте посты и истории, общайтесь с сообществом, ведите магазин Bloop и отвечайте клиентам в чате.

Что можно создать#

API действует от имени вашего собственного аккаунта: каждый запрос выполняется от лица пользователя, создавшего ключ API, с разрешениями (scopes), выбранными для этого ключа. Платежи, кошелёк и токены через API недоступны.

Быстрый старт за 3 шага#

  1. Запросите доступ разработчика. В веб-приложении Linework откройте Настройки → Разработчикам и расскажите, что вы хотите создать (сценарий использования, сайт, имя бота). Мы рассматриваем каждую заявку.
  2. Создайте ключ API. После одобрения создайте ключ на той же странице и выберите его scopes. Ключ начинается с lwk_ и показывается только один раз: сохраните его в надёжном месте.
  3. Выполните первый запрос.
    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())

Основное с первого взгляда#

ПараметрЗначение
Базовый URLhttps://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. Никакого спама, скрейпинга и выдачи себя за других. Ключи, нарушающие правила, отзываются.