Ссылки и доступ
У каждого файла и заметки есть своя ссылка. Кто её откроет и как долго, решаешь ты: доступ, пароль, одноразовое открытие, срок и лимит просмотров.
Доступ
| visibility | Кто видит |
|---|---|
private | Только ты. |
unlisted | Все, у кого есть ссылка. |
public | Все по ссылке, а ещё лента и твой профиль. Нельзя вместе с oneTime. |
Если не передать visibility при загрузке, действует настройка аккаунта — private или unlisted.
Пароль и одноразовая ссылка
password— 8–128 символов. Хранится как Argon2id и никогда не возвращается; пустая строка снимает пароль, смена закрывает доступ тем, кто уже открывал.oneTime— файл откроет только первый гость и только на 10 минут. Твой просмотр и предпросмотр ссылки в мессенджере её не тратят.
Срок и лимит просмотров
ttl—day,week,monthилиforever, от момента запроса. После срока ссылка перестаёт открываться, файл удаляется.expiresAt— точная дата конца, от 5 минут до 10 лет вперёд. Функция Prolink_expiry.viewLimit— после стольких просмотров ссылка отвечает как истёкшая. Функция Proview_limit; снять лимит (null) можно на любом тарифе.
Без нужной функции тарифа ответ — 403 PLAN_FEATURE_REQUIRED с params.feature. Функции аккаунта — в entitlements.features ответа GET /account. Уже заданные сроки и лимиты продолжают работать после окончания тарифа.
Просмотры
views считает открытия страницы файла гостями — не чаще раза в сутки на зрителя; твои просмотры и боты превью ссылок не считаются. Просмотры по дням — функция Pro view_stats.