Интеграция через API

Что понадобится

API доступен на тарифах, в которых включена соответствующая функция. Персональный токен находится в разделе «Профиль».

Авторизация

Передавайте токен в каждом запросе в заголовке:

Authorization: Bearer YOUR_API_TOKEN

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

Отправьте JSON методом POST на /api/new_url. Обязательное поле url содержит исходный адрес. Дополнительно можно передать срок жизни, UTM-метки, собственный адрес, ID домена и адреса для iOS и Android.

{
  "url": "https://example.com/catalog",
  "utm": {
    "utm_source": "telegram",
    "utm_campaign": "autumn_sale"
  }
}

При успехе ответ содержит status: ok и поле short_url. При ошибке читайте пояснение в поле message.