Документация API
Legal Wording
Программный доступ к вашим активам и продажам. Подключите CRM, таблицы или собственные скрипты: два REST-эндпоинта с ответами в JSON и выгрузки CSV за период — всё в режиме только чтения.
- Базовый URL
- https://legalwording.ru
- Формат
- JSON, имена полей в camelCase
- Авторизация
- Authorization: Bearer
- Лимит
- 60 запросов в минуту
Аутентификация
Персональный ключ выпускается в личном кабинете автора — раздел «API и экспорт».
- 1
Войдите в личный кабинет и откройте раздел «API и экспорт». Выпуск ключа доступен аккаунтам со статусом автора.
- 2
Нажмите «Выпустить ключ». Ключ вида
lw_sk_…показывается один раз — сохраните его сразу: на сервере хранится только отпечаток, восстановить ключ нельзя. - 3
Передавайте ключ в заголовке
Authorizationкаждого запроса.
Заголовок запроса
Authorization: Bearer lw_sk_ВАШ_КЛЮЧБыстрая проверка
curl -H "Authorization: Bearer lw_sk_ВАШ_КЛЮЧ" \
"https://legalwording.ru/sapi/v1/assets"- Ключ действует бессрочно — до перевыпуска или отзыва в личном кабинете.
- «Перевыпустить» немедленно отзывает старый ключ — не забудьте обновить интеграции.
- Запись по API недоступна: создание и изменение активов — только через личный кабинет.
Мои активы
Названия, слаги, цены и статусы публикации ваших активов.
/sapi/v1/assetsBearer-ключВозвращает до 1000 последних активов автора, новые первыми. Параметров нет.
Пример запроса
curl -H "Authorization: Bearer lw_sk_ВАШ_КЛЮЧ" \
"https://legalwording.ru/sapi/v1/assets"Пример ответа 200 OK
{
"items": [
{
"id": 1024,
"title": "Договор поставки (поставка партиями)",
"slug": "dogovor-postavki-postavka-partiyami",
"price": 1200,
"status": "published",
"createdAt": "2026-06-18T09:41:07Z"
},
{
"id": 987,
"title": "Претензия по договору аренды",
"slug": null,
"price": 450,
"status": "draft",
"createdAt": "2026-05-30T16:12:44Z"
}
]
}Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| items | array | Список активов. |
| items[].id | number | Идентификатор актива. |
| items[].title | string | Название актива. |
| items[].slug | string | null | Слаг карточки актива в каталоге; может отсутствовать у черновиков. |
| items[].price | number | Цена в рублях. |
| items[].status | string | Статус публикации: draft — черновик, published — опубликован, hidden — скрыт из каталога. |
| items[].createdAt | string | Дата создания, ISO 8601 (UTC). |
Мои продажи
Позиции заказов с вашими активами: суммы, номера заказов, статусы.
/sapi/v1/salesBearer-ключВозвращает до 1000 последних продаж, новые первыми. Параметров нет.
Пример запроса
curl -H "Authorization: Bearer lw_sk_ВАШ_КЛЮЧ" \
"https://legalwording.ru/sapi/v1/sales"Пример ответа 200 OK
{
"items": [
{
"orderNo": 4312,
"date": "2026-07-02T14:05:31Z",
"documentId": 1024,
"title": "Договор поставки (поставка партиями)",
"amount": 1200,
"status": "Paid"
},
{
"orderNo": 4288,
"date": "2026-06-28T10:12:03Z",
"documentId": 1024,
"title": "Договор поставки (поставка партиями)",
"amount": 1200,
"status": "Payment"
}
]
}Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| items | array | Список продаж. |
| items[].orderNo | number | Номер заказа. |
| items[].date | string | Дата и время заказа, ISO 8601 (UTC). |
| items[].documentId | number | Идентификатор проданного актива. |
| items[].title | string | Название актива. |
| items[].amount | number | Сумма позиции в рублях. |
| items[].status | string | Статус заказа: New — создан, Payment — ожидает оплаты, Paid — оплачен, Cancelled — отменён, Failed — ошибка оплаты. |
Выгрузки CSV
Готовые файлы для Excel и «Р7-Офис»: кодировка UTF-8 с BOM, разделитель «;», до 5000 строк.
Выгрузки выполняются по сессии личного кабинета, а не по ключу lw_sk_. Проще всего скачивать файлы кнопками раздела «API и экспорт» — либо открыть ссылку в браузере, где вы вошли в кабинет.
/sapi/author/export/assets.csvсессия личного кабинетаСписок ваших активов. Колонки: «Название», «Тип» (Документ, Статья, Письмо, Книга, Статья блога, Спор), «Раздел» (корневая категория), «Категория» (самая глубокая привязка), «Цена».
Пример файла assets.csv
Название;Тип;Раздел;Категория;Цена
Договор поставки (поставка партиями);Документ;Договорное право;Поставка;1200.00
Претензия по договору аренды;Письмо;Договорное право;Аренда;450.00/sapi/author/export/sales.csvсессия личного кабинетаПродажи за период. Колонки: «Дата», «Заказ», «Наименование», «Цена», «Комиссия», «К выплате», «Статус». Комиссия и сумма к выплате берутся из проведённого платежа — у неоплаченных заказов эти колонки пустые. Статусы: «ожидает оплаты», «на удержании», «выплачено», «выплата отменена», «ошибка выплаты», «ошибка оплаты», «отменён».
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| from | дата, ГГГГ-ММ-ДД | Начало периода включительно. Необязательный — без него нижней границы нет. |
| to | дата, ГГГГ-ММ-ДД | Конец периода включительно: дата без времени считается целым днём. Необязательный. |
Пример ссылки
https://legalwording.ru/sapi/author/export/sales.csv?from=2026-07-01&to=2026-07-31Пример файла sales-2026-07.csv
Дата;Заказ;Наименование;Цена;Комиссия;К выплате;Статус
2026-07-02 14:05;4312;Договор поставки (поставка партиями);1200.00;234.00;966.00;выплачено
2026-06-28 10:12;4288;Договор поставки (поставка партиями);1200.00;;;ожидает оплатыИмя файла отражает период: sales-2026-07.csv — месяц, sales-2026-q3.csv — квартал, sales-2026.csv — год, sales-2026-07-01_2026-07-15.csv — произвольный диапазон, sales.csv — без периода.
Ошибки и лимиты
Коды ответов при проблемах с доступом и правила честного использования.
| Код | Статус | Когда возвращается |
|---|---|---|
| 401 | Unauthorized | Ключ не передан, неверен или отозван — либо выгрузка запрошена без входа в личный кабинет. Проверьте заголовок Authorization и статус ключа в разделе «API и экспорт». |
| 403 | Forbidden | Доступ запрещён: операция недоступна этому аккаунту — например, выгрузка CSV вне сессии действующего пользователя. |
Лимит — 60 запросов в минуту на ключ. Распределяйте запросы равномерно и кешируйте ответы на своей стороне: списки отдаются целиком, частый опрос не требуется. При превышении лимита доступ может быть временно ограничен.
Готовы подключиться?
Выпустите ключ в личном кабинете и сделайте первый запрос за минуту. Ещё не автор? Разместите свои материалы и начните зарабатывать.