Перейти к содержимому
POST AI agent ready /v1/short-url/create

API Shortener URL: создание коротких ссылок с отслеживанием кликов

Отправьте URL-адрес и получите сокращенную ссылку с автоматически созданным или настраиваемым ярлыком. Короткие ссылки перенаправляются через 302 и отслеживают количество кликов. Пользовательские фрагменты поддерживают буквы, цифры, дефисы и символы подчеркивания. Если пул уже занят, API возвращает ошибку, поэтому вы можете повторить попытку с другим.

Parameters

stringrequired

The target URL to shorten. Must be a valid http or https URL.

string

An optional custom slug for the short URL. Letters, numbers, hyphens, and underscores only.

Code examples

curl -X POST https://api.botoi.com/v1/short-url/create \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.botoi.com/getting-started","custom_slug":"getting-started"}'

When to use this API

Создавайте отслеживаемые короткие ссылки для маркетинговых кампаний.

Создайте собственную короткую ссылку для каждой кампании (например, /launch-2026). Используйте конечную точку статистики для отслеживания кликов и измерения вовлеченности без внешних инструментов аналитики.

Встройте функцию сокращения ссылок в свой SaaS-продукт.

Позвольте вашим пользователям создавать фирменные короткие ссылки из вашего приложения. API занимается генерацией пулей, обнаружением коллизий и отслеживанием перенаправления, поэтому вам не нужно создавать эту инфраструктуру.

Frequently asked questions

Срок действия коротких ссылок истекает?
Короткие ссылки, созданные через API, не имеют встроенного срока действия. Они сохраняются в хранилище до тех пор, пока не будут удалены вручную или пока не будет очищено базовое хранилище.
Что произойдет, если мой индивидуальный пул уже занят?
API возвращает ошибку SLUG_TAKEN. Вы можете повторить попытку с другим ярлыком или опустить поле custom_slug, чтобы получить автоматически сгенерированный 6-значный ярлык.
Какие символы разрешены в пользовательских слагах?
Буквы (A–Z, a–z), цифры (0–9), дефисы (-) и подчеркивания (_). Любые другие символы вызывают ошибку INVALID_SLUG.
Отслеживается ли количество кликов автоматически?
Да. Каждый раз, когда кто-то посещает короткий URL-адрес, счетчик кликов увеличивается. Используйте конечную точку GET /v1/short-url/{slug}/stats, чтобы получить текущий счетчик.
Какой тип перенаправления использует короткий URL-адрес?
Короткий URL-адрес возвращает 302 (временное) перенаправление. Это означает, что поисковые системы не будут передавать ссылочную массу целевому URL-адресу, и при необходимости вы сможете изменить место назначения позже.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs