REST API СЖМИ

Ссылки работают.
Рутина исчезает.

Создавайте короткие ссылки прямо из CRM, ботов, приложений и внутренних сервисов. Один запрос — готовая ссылка с нужными настройками.

Выбрать тариф Смотреть документацию

JSONBearer tokenHTTPS

curl -X POST https://szhmi.ru/api/new_url \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/catalog",
    "live": 1,
    "utm": {
      "utm_source": "telegram",
      "utm_campaign": "autumn_sale"
    }
  }'

200 · application/json

{
  "status": "ok",
  "short_url": "https://szhmi.ru/aB3xYz"
}

1 запросдо готовой ссылки

JSONпонятный формат данных

Bearerпростая авторизация

ГибкоUTM, домены и устройства

Автоматизация

Встройте короткие ссылки в свой процесс

API берёт на себя повторяющиеся действия и сохраняет единые правила для всех ссылок команды.

CRM и рассылки

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

Боты и приложения

Возвращайте компактные адреса в интерфейсах, уведомлениях и сообщениях бота.

Рекламные кампании

Передавайте UTM-метки из медиаплана и автоматически соблюдайте структуру аналитики.

Умные переходы

Направляйте iOS, Android и Desktop на разные страницы через один короткий адрес.

Быстрый старт

Три шага до первой ссылки

Получите токен

API-токен создаётся вместе с аккаунтом и находится в разделе «Профиль».

Соберите запрос

Передайте токен в заголовке Authorization, а параметры ссылки — в JSON.

Получите короткий URL

Сохраните short_url из ответа и используйте его в своём продукте.

Для создания ссылок через API функция api должна быть включена в тарифе.

Документация

Создание короткой ссылки

Основной endpoint для интеграции СЖМИ с вашими сервисами.

POST https://szhmi.ru/api/new_url

Authorization Bearer YOUR_API_TOKEN

Параметры JSON

Параметр	Тип	Обязателен	Описание
`url`	string	Да	Абсолютный целевой URL с протоколом.
`live`	integer	Нет	Срок жизни: `1` — бессрочно, `2` — месяц, `3` — 24 часа, `4` — 12 часов, `5` — 6 часов, `6` — 2 часа, `7` — 1 час. По умолчанию — `1`.
`utm`	object	Нет	Поля `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`.
`slug`	string	Нет*	Свой короткий адрес. Для пользовательского домена обязателен.
`domain_id`	integer	Нет	ID подключённого, подтверждённого и включённого домена.
`targets`	object	Нет	Адреса `ios` и `android`; основной `url` используется для Desktop.

Умная ссылка для устройствJSON

{
  "url": "https://example.com/desktop",
  "targets": {
    "ios": "https://apps.apple.com/app/example",
    "android": "https://play.google.com/store/apps/example"
  },
  "slug": "download-app"
}

✓

Предсказуемый ответ

При успехе API возвращает status: ok и готовый short_url. При ошибке вы получите status: error и понятное поле message.

{
  "status": "ok",
  "short_url": "https://szhmi.ru/aB3xYz"
}

A/B-тесты

Передавайте конверсии обратно

Для перехода из A/B-теста СЖМИ добавляет к целевому адресу параметр szhmi_click_id. Отправьте его вместе с кодом цели, чтобы увидеть конверсию по каждому варианту.

POST/api/ab-conversion

Bearer-токен здесь не нужен: случайный идентификатор клика служит ограниченным одноразовым ключом контекста. Повторная отправка одной цели не создаёт дубль.

Фиксация цели на сайтеJavaScript

const clickId = new URLSearchParams(location.search)
  .get('szhmi_click_id');

await fetch('https://szhmi.ru/api/ab-conversion', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    click_id: clickId,
    goal: 'payment'
  })
});

Готовы подключить?

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

Выберите тариф с доступом к API и создайте первую ссылку из своего сервиса.

Выбрать тариф

Ссылки работают.Рутина исчезает.