API lacuna
Загружай скриншоты, видео и заметки из своих скриптов, программ или своего сервера — и получай ссылку, которой управляешь сам: доступ, пароль, срок, лимит просмотров.
Адрес и формат
Все методы работают по HTTPS с адресом https://lac.pics/api/v1. Запросы и ответы — JSON в UTF-8; файлы загружаются как multipart/form-data.
В каждом ответе есть заголовок X-Request-ID. Если что-то пошло не так, пришли его в поддержку — по нему находится запрос.
Первый запрос
- Создай ключ в кабинете, в разделе API. Полный ключ показывается один раз — сохрани его как пароль.
- Проверь ключ: ответ вернёт твой аккаунт, лимиты и сам ключ.
curl "https://lac.pics/api/v1/account" \
-H "Authorization: Bearer lac_api_YOUR_KEY"- Загрузи файл — в ответе будет ссылка
url.
curl -X POST "https://lac.pics/api/v1/uploads" \
-H "Authorization: Bearer lac_api_YOUR_KEY" \
-H "Idempotency-Key: capture-2026-09-27-a7f3c1" \
-F "file=@capture.png" \
-F "visibility=unlisted"Разделы
- Аутентификация и ключиКаждый запрос подписывается ключом API в заголовке Authorization. Ключ работает только с файлами своего аккаунта и только в пределах своих прав.
- Загрузка файловОдним запросом — для скриншотов и коротких видео; по частям — для больших файлов и нестабильной сети. Ссылка на файл есть сразу после загрузки.
- Ссылки и доступУ каждого файла и заметки есть своя ссылка. Кто её откроет и как долго, решаешь ты: доступ, пароль, одноразовое открытие, срок и лимит просмотров.
- ЗаметкиЗаметка — текст, Markdown или код с подсветкой по своей ссылке. Доступ, пароль и срок — как у файлов.
- ОшибкиОшибка — это JSON с HTTP-статусом, машинным кодом и текстом. Решения в своём коде принимай по code: он стабилен, а тексты могут меняться.
- ЛимитыЛимиты считаются на аккаунт: все его ключи делят один бюджет. Точные числа твоего тарифа возвращает GET /api/v1/account в limits.
- Приложение Windows и ключ устройстваПриложение lacuna для Windows подключается к аккаунту через браузер и получает собственный ключ — ключ устройства. Создавать ключ вручную не нужно.
Спецификация OpenAPI
Эти страницы собраны из спецификации OpenAPI 3.0 при сборке сайта, поэтому совпадают с API. Полный файл спецификации в JSON скачивается после входа — в нём есть и методы, которые работают только из кабинета.