Продлить ключ приложения

POST/api/v1/device-auth/renew

Доступ: Ключ приложения, подключённого через браузер

Только ключ подключения через браузер, без тела. За 30 дней до конца срока ключ получает преемника — то же имя, те же права, новый срок 365 дней, — а сам работает ещё 10 минут, затем отвечает API_KEY_EXPIRED. Раньше срока — 409 DEVICE_RENEW_TOO_EARLY, ничего не меняется. Уже продлённый ключ отклоняется и отзывается вместе с преемником (401 API_KEY_REVOKED): продление отправляется один раз и не повторяется при потерянном ответе. Сессия сайта и ключи из формы получают 403 DEVICE_KEY_REQUIRED. До 10 продлений на аккаунт за 10 минут.

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

curl -X POST "https://lac.pics/api/v1/device-auth/renew" \
  -H "Authorization: Bearer lac_api_YOUR_KEY"

Ответы

200ГотовоDeviceAuthToken
- tokenstringобязательныйтолько в ответе
  Ключ API, показывается один раз. Храни его как пароль (в Windows — в диспетчере учётных данных), никогда в адресе или логе.
  шаблон ^lac_api_[A-Za-z0-9_-]{43}$
- keyApiCredentialобязательный
  Метаданные ключа.
  ApiCredential 6 полей
  - idstringобязательный
    id файла или заметки.
  - namestringобязательный
    Название ключа; у ключа приложения — «lacuna для Windows · {компьютер}».
    длина 1–100
  - scopesмассив stringобязательный
    Права.
    значения: "content:read" "content:write" "content:delete" "account:read"
    1–4 элементов · без повторов
  - expiresAtstring · date-timeобязательный
    После этого момента — 401 API_KEY_EXPIRED. Ключ приложения живёт 365 дней и продлевается сам за 30 дней до конца.
  - clientstringобязательныйили null
    Приложение ключа подключения; null — ключ из формы.
    значения: "windows"
  - deviceNamestringобязательныйили null
    Компьютер; null — ключ из формы.
    длина 1–128
- userobjectобязательный
  Аккаунт.
  1 поле
  - usernamestringобязательный
    Никнейм.
400Некорректный запрос
401Нужен действующий ключBEARER_REQUIRED
403Нет права или функции тарифаDEVICE_KEY_REQUIRED ORIGIN_FORBIDDEN
404Не найденоACCOUNT_UNAVAILABLE
409КонфликтDEVICE_RENEW_TOO_EARLY
413Слишком большой файл или нет места
429Слишком много запросов
500Сбой на сервере
503Сервис занят или недоступен

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

200 · application/json

{
  "token": "lac_api_NEW_KEY_SHOWN_ONCE",
  "key": {
    "id": "cmf8a1x2k0001q7lh5b2n8r6t",
    "name": "Upload script",
    "scopes": [
      "content:write"
    ],
    "expiresAt": "2026-12-26T09:30:00.000Z",
    "client": null,
    "deviceName": null
  },
  "user": {
    "username": "alex"
  }
}

Коды ошибок

Код	Статус	Текст
`BEARER_REQUIRED`	401	Требуется Bearer-ключ.
`DEVICE_KEY_REQUIRED`	403	Продлить можно только ключ приложения, подключённого через браузер.
`ORIGIN_FORBIDDEN`	403	Недопустимый источник запроса.
`ACCOUNT_UNAVAILABLE`	404	Аккаунт недоступен.
`DEVICE_RENEW_TOO_EARLY`	409	Продлить подключение можно за 30 дней до конца срока.

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