Докиво Витрина · обновлено 6 августа 2026
Программный доступ — это те же короткие ссылки и постоянные страницы, но без интерфейса: запросом из вашей программы. Работает по токену, который выпускается в кабинете; токен передаётся заголовком Authorization и в любой момент отзывается.
Токен выпускается в кабинете и показывается один раз: сервер хранит только его отпечаток. Запросы идут на адреса, начинающиеся с /api/v1/, тело и ответ — JSON. Всё, что создано по токену, сразу принадлежит вашему аккаунту и видно в кабинете.
Товароучётная программа при поступлении партии создаёт короткую ссылку на карточку товара и печатает её на этикетке. Через месяц карточка переезжает — программа меняет цель запросом, напечатанные этикетки продолжают работать.
Токен доступа из кабинета и данные объекта: адрес цели для ссылки или содержимое для страницы.
Короткий адрес, постоянная страница и статистика — теми же числами, что показывает кабинет.
Не больше 300 запросов в час на токен. Предел бесплатного доступа по страницам общий с интерфейсом: программный доступ — другой способ работы, а не обход ограничений. Короткие ссылки безлимитны и здесь.
Токен доступа — не то же самое, что вход в кабинет. Сессия браузера живёт в устройстве и гаснет при смене пароля; токен нужен программе на сервере и обязан это переживать. Поэтому он выпускается отдельно и отзывается отдельно.
При выпуске токен показывается ровно один раз. В базе остаётся только его отпечаток, поэтому «напомнить» токен сервис не может физически — утраченный отзывают и выпускают новый. Это то же правило, что и у кодов управления страницами.
Отзыв мгновенный: следующий запрос с отозванным токеном получает тот же отказ, что и запрос с выдуманным. Чужой токен отозвать нельзя, и попытка это сделать неотличима от обращения к несуществующему.
В ответе придут короткий адрес и код управления. Код нужен, чтобы править ссылку и без API — например с телефона на посадочной странице.
Адреса построены единообразно: список и создание живут на общем адресе, отдельный объект — на адресе с коротким кодом. Правка принимается методом PATCH, и отсутствующее поле означает «оставить как было»: скрипт, меняющий заголовок, не сотрёт текст страницы.
| Запрос | Что делает | Что в теле |
|---|---|---|
| GET /api/v1/account | тариф, пределы и счётчики | — |
| GET /api/v1/short-links | список ваших коротких ссылок | — |
| POST /api/v1/short-links | создать короткую ссылку | targetUrl, title |
| GET /api/v1/short-links/<код> | ссылка и статистика переходов | — |
| PATCH /api/v1/short-links/<код> | сменить цель или подпись | targetUrl, title |
| GET /api/v1/pages | список ваших постоянных страниц | — |
| POST /api/v1/pages | создать постоянную страницу | pageType, title, textContent, links |
| GET /api/v1/pages/<код> | страница, настройки и открытия | — |
| PATCH /api/v1/pages/<код> | правка содержимого и настроек | любые поля страницы |
Ответ всегда JSON и всегда содержит поле ok. При отказе рядом лежат короткий код ошибки для программы и объяснение по-русски для человека, который будет читать журнал.
Отдельно стоит запомнить одно решение: чужой объект отвечает «не найдено», а не «нет доступа». Разница принципиальная — иначе перебором адресов можно было бы выяснить, какие ссылки существуют у других владельцев.
| Код | Когда приходит |
|---|---|
| api_token_required | токена нет, он выдуман, отозван или аккаунт заблокирован |
| rate_limited | больше 300 запросов в час на этот токен |
| invalid_target_url | цель ссылки не http(s) или это уже наш короткий адрес |
| page_limit_reached | исчерпан предел бесплатного доступа по страницам |
| short_link_not_found | ссылки нет или она принадлежит другому аккаунту |
| qr_page_not_found | страницы нет или она принадлежит другому аккаунту |
Статистика через API ровно та же, что в кабинете: число открытий и переходов, разбивка по дням и по источникам. Сведений о посетителях в ней нет, потому что их нет и в базе: переходы считаются без кук, без отпечатков браузера и без записи адреса перешедшего.
Это не пробел, который когда-нибудь заполнится «расширенной аналитикой». Обещание «считаем переходы, не людей» закреплено тестами сервиса, и программный доступ его не обходит: отдать через API то, чего не собираешь, невозможно.
Честные границы
Пошаговая инструкция
Перед печатью или публикацией
Частые вопросы
Нет. Токен доступен любому аккаунту, пределы те же, что и в интерфейсе: страницы ограничены бесплатным доступом, короткие ссылки безлимитны.
Ничего: ссылки и страницы продолжат работать и останутся в кабинете. Токен — это ключ к управлению, а не владелец объектов.
Пока нет: программный доступ покрывает короткие ссылки и постоянные страницы. Витрины остаются в интерфейсе — обещать неготовое мы не будем.
Пока нет. Коннектор MCP запланирован отдельным шагом после того, как API поработает у первых пользователей и перестанет меняться. Сейчас доступен обычный REST.
Пока вы его не отзовёте. Срока годности у него нет — именно поэтому его стоит держать в переменной окружения и отзывать при любом подозрении на утечку.
Материал обновлён: 6 августа 2026 · Проверка источников выполняется по методике сервиса.