Короткие ссылки

Создание и управление короткими ссылками в проекте.

GET /shorts/availability

Проверить доступность short_name

Проверяет, свободна ли пара `(subdomain, short_name)` для создания ссылки.

Действия

Результат `available: false` означает, что пара уже занята; в этом случае попытка создания вернёт 409.

Query-параметры

Ответы

DELETE /shorts/bulk

Массовое удаление коротких ссылок

Удаляет перечисленные ссылки одним запросом.

Действия

HTTP 204 — все удалены; HTTP 207 — часть ID не найдена (проверяйте `errors`).

Тело запроса (JSON)

Ответы

PATCH /shorts/bulk

Массовое обновление коротких ссылок

Обновляет несколько коротких ссылок за один запрос.

Действия

Все поля в `ShortUpdate` опциональны кроме `id`; отсутствующие поля не изменяются.

Тело запроса (JSON)

Ответы

POST /shorts/{scope_id}/bulk

Массовое создание коротких ссылок

Создаёт несколько коротких ссылок за один запрос.

Действия

HTTP 201 — все создано; HTTP 207 — частичный успех (проверяйте `errors`).

Параметры пути

Тело запроса (JSON)

Ответы

GET /shorts/{scope}

Получить список коротких ссылок

Возвращает список коротких ссылок пользователя с опциональной фильтрацией.

Действия

Фильтры передаются в query параметрах. Булевые поля (`with_password`, `with_captcha`, `with_expiration`, `with_beginning`, `with_max_clicks`) позволяют отбирать ссылки с/без соответствующих ограничений. Параметр `is_archived = true` возвращает архивированные ссылки (по умолчанию архивированные скрыты).

Параметры пути

Query-параметры

Ответы

POST /shorts/{scope}

Создать короткую ссылку

Создаёт одну короткую ссылку в указанном scope.

API — все разделы · Документация