Просмотры по дням

GET/api/v1/content/{id}/views

Доступ: Ключ API
Право: content:read

Просмотры своего файла по дням — функция Pro view_stats. Считаются те же открытия, что в views: первое открытие страницы файла зрителем за сутки, без владельца и ботов превью. Хранятся почасовые суммы без данных зрителей, 400 дней; дни идут по часам, заданным offset.

Пример запроса

curl "https://lac.pics/api/v1/content/Xq3u9RkT0bLmA7cV2pWz1eFy/views?days=30&offset=180" \
  -H "Authorization: Bearer lac_api_YOUR_KEY"

Параметры

Путь

idstringобязательный
id файла или заметки.

Строка запроса

daysinteger
Сколько последних дней вернуть.
1–90 · по умолчанию 30
offsetinteger
Смещение часов зрителя от UTC в минутах (Москва — 180), например -new Date().getTimezoneOffset().
-840–840 · по умолчанию 0

Ответы

200ГотовоContentViewStats
- idstringобязательный
  id файла.
- viewsintegerобязательный
  Все засчитанные просмотры файла.
  от 0
- viewLimitintegerобязательныйили null
  Pro, функция view_limit: после стольких засчитанных просмотров ссылка отвечает как истёкшая. Лимит не выше уже набранных просмотров закрывает ссылку сразу; повышение или снятие (null, на любом тарифе) открывает снова.
  от 1
- viewLimitReachedAtstring · date-timeобязательныйили null
  Когда лимит просмотров исчерпан; null, пока просмотры есть или лимита нет.
- offsetintegerобязательный
  Смещение часов в минутах от UTC.
  -840–840
- periodintegerобязательный
  Просмотры за возвращённые дни.
  от 0
- daysмассив objectобязательный
  Дни от старых к новым; сегодня — последний, дни без просмотров — 0.
  1–90 элементов
  2 поля
  - datestring · dateобязательный
    Местная дата, ГГГГ-ММ-ДД.
  - viewsintegerобязательный
    Засчитанные открытия гостями, без повторов в пределах доступа зрителя (обычно сутки). Просмотры владельца не считаются.
    от 0
400Некорректный запрос
401Нужен действующий ключ
403Нет права или функции тарифаPLAN_FEATURE_REQUIRED
404Не найдено
409Конфликт
410Файл удалён или истёк
413Слишком большой файл или нет места
429Слишком много запросов
503Сервис занят или недоступен

Пример ответа

200 · application/json

{
  "id": "Xq3u9RkT0bLmA7cV2pWz1eFy",
  "views": 42,
  "viewLimit": null,
  "viewLimitReachedAt": null,
  "offset": 180,
  "period": 12,
  "days": [
    {
      "date": "2026-09-27",
      "views": 3
    }
  ]
}

Коды ошибок

Код	Статус	Текст
`PLAN_FEATURE_REQUIRED`	403	Это доступно в Pro.

Ответы любого метода с ключом — неверный или истёкший ключ, нет права, частые запросы — в разделе Ошибки.