Top.Mail.Ru
🔥 Летняя распродажа 2026 уже началась!

Скидка 20% на все покупки по коду SUMMER2026.

⚡ Всего 100 кодов активации — кто успел, тот получил.

API для сокращения ссылок и управления мультиссылками: автоматизация маркетинга

2026, 23 Июнь • API • 1 просмотров • 3 минут на чтение

Фрагмент кода API запроса и схема автоматизации создания ссылок с иконками CRM, чат-ботов и рассылок

Руководство по автоматизации создания коротких ссылок, мультиссылок и QR‑кодов через API Vibes.

Введение: когда кнопки «Создать» недостаточно

Ручное создание ссылок работает, пока их десять. Двадцать. Пятьдесят. Но когда интернет-магазин генерирует тысячи ссылок на товары для email-рассылок, когда чат-бот должен выдавать персонализированные короткие ссылки каждому клиенту, когда CRM автоматически создаёт UTM-размеченную ссылку для каждого нового лида — ручной режим превращается в бутылочное горлышко. На этом этапе бизнесу нужен API.

API (Application Programming Interface) — это программный интерфейс, который позволяет вашим приложениям, скриптам и сервисам общаться с платформой управления ссылками напрямую, без участия человека. Вы не заходите в личный кабинет и не нажимаете кнопки. Всё делает код. Автоматически. Мгновенно. Масштабируемо.

В этом руководстве — всё об API для работы со ссылками в 2026 году. От базового понимания REST API до готовых примеров кода на Python, JavaScript и PHP для интеграции с платформой Vibes.


Что такое API для ссылок и зачем он нужен

API для управления ссылками — это набор HTTP-эндпоинтов, которые позволяют программно: создавать короткие ссылки (с UTM-метками, пикселями, кастомными слагами), создавать мультиссылки (link-in-bio страницы), генерировать QR-коды, получать аналитику по существующим ссылкам, обновлять целевые URL существующих ссылок, удалять или архивировать ссылки, создавать ссылки массово (bulk operations).


Сценарии использования API

E-commerce: при добавлении нового товара в CMS автоматически создаётся короткая ссылка для маркетинговых каналов.

CRM-интеграция: при создании нового контакта в CRM генерируется персонализированная ссылка с UTM-меткой для отслеживания взаимодействий.

Чат-боты: бот в Telegram или WhatsApp при запросе пользователя создаёт короткую ссылку на лету и отправляет её в ответ.

Email-рассылки: сервис рассылок автоматически заменяет все длинные ссылки на короткие с UTM-метками конкретной кампании.

Рекламные кабинеты: при запуске нового объявления автоматически создаётся уникальная ссылка с пикселем ретаргетинга.

Аналитические дашборды: регулярный сбор статистики по всем ссылкам через API и визуализация в Google Data Studio или Power BI.


Как работает REST API для управления ссылками

API платформы Vibes построен по принципам REST. Это значит: HTTP-запросы к определённым URL (эндпоинтам), методы GET (получить данные), POST (создать), PUT/PATCH (обновить), DELETE (удалить), авторизация через API-ключ в заголовке запроса, данные передаются в формате JSON, ответы возвращаются в JSON с кодами состояния HTTP.

Базовый URL API (Vibes):

https://vibes.su/api/v1/

Авторизация: все запросы требуют API-ключ, который передаётся в заголовке:

Authorization: Bearer YOUR_API_KEY

API-ключ можно получить в личном кабинете Vibes в разделе «Настройки» → «API».

Формат ответа. Успешный запрос:

{
"status": "ok",
"data": { ... }
}

Ошибка:

{
"status": "error",
"message": "Invalid URL format",
"code": 400
}


Основные эндпоинты API (на примере Vibes)

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

Запрос:

POST /api/v1/links
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
"url": "https://example.com/very-long-landing-page-url",
"slug": "my-offer",
"utm": {
"source": "telegram",
"medium": "social",
"campaign": "launch_jan"
},
"pixels": ["meta", "tiktok"],
"expires_at": null
}

Ответ:

{
"status": "ok",
"data": {
"id": "lnk_7xK9mQ",
"short_url": "https://vibes.su/my-offer",
"original_url": "https://example.com/...",
"created_at": "2026-01-20T10:30:00Z",
"clicks": 0
}
}

2. Создание мультиссылки

Запрос:

POST /api/v1/pages
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
"title": "Иван Петров",
"description": "Маркетолог, спикер, автор канала",
"avatar_url": "https://example.com/avatar.jpg",
"theme": "gradient-purple",
"links": [
{"title": "Запись на консультацию", "url": "https://calendly.com/...", "icon": "calendar"},
{"title": "Telegram-канал", "url": "https://t.me/...", "icon": "telegram"},
{"title": "YouTube", "url": "https://youtube.com/...", "icon": "youtube"}
]
}

3. Массовое создание ссылок

Запрос:

POST /api/v1/links/bulk
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
"links": [
{"url": "https://example.com/product/1", "slug": "prod-1"},
{"url": "https://example.com/product/2", "slug": "prod-2"},
{"url": "https://example.com/product/3", "slug": "prod-3"}
],
"utm": {
"source": "email",
"medium": "newsletter",
"campaign": "weekly_42"
}
}

Ответ:

{
"status": "ok",
"data": {
"created": 3,
"failed": 0,
"links": [
{"slug": "prod-1", "short_url": "https://vibes.su/prod-1"},
{"slug": "prod-2", "short_url": "https://vibes.su/prod-2"},
{"slug": "prod-3", "short_url": "https://vibes.su/prod-3"}
]
}
}

4. Получение аналитики по ссылке

Запрос:

GET /api/v1/links/lnk_7xK9mQ/stats?from=2026-01-01&to=2026-01-31
Authorization: Bearer YOUR_API_KEY

Ответ:

{
"status": "ok",
"data": {
"total_clicks": 1547,
"unique_visitors": 1203,
"countries": {"RU": 890, "KZ": 145, "BY": 89},
"devices": {"mobile": 1100, "desktop": 447},
"daily_clicks": [
{"date": "2026-01-01", "clicks": 12},
{"date": "2026-01-02", "clicks": 45}
]
}
}

5. Обновление целевого URL

Запрос:

PATCH /api/v1/links/lnk_7xK9mQ
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
"url": "https://example.com/new-landing-page"
}

6. Удаление ссылки

Запрос:

DELETE /api/v1/links/lnk_7xK9mQ
Authorization: Bearer YOUR_API_KEY


Примеры кода для разных языков

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

import requests

API_KEY = "YOUR_API_KEY"
API_URL = "https://vibes.su/api/v1/links"

headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}

data = {
"url": "https://example.com/very-long-url",
"slug": "my-campaign",
"utm": {
"source": "python_script",
"medium": "api",
"campaign": "automated"
}
}

response = requests.post(API_URL, headers=headers, json=data)
result = response.json()

if result["status"] == "ok":
print(f"Короткая ссылка создана: {result['data']['short_url']}")
else:
print(f"Ошибка: {result['message']}")

JavaScript (Node.js): массовое создание

const API_KEY = 'YOUR_API_KEY';
const API_URL = 'https://vibes.su/api/v1/links/bulk';

const links = [
{ url: 'https://example.com/product/1', slug: 'prod-1' },
{ url: 'https://example.com/product/2', slug: 'prod-2' },
{ url: 'https://example.com/product/3', slug: 'prod-3' }
];

const response = await fetch(API_URL, {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
links: links,
utm: { source: 'email', medium: 'newsletter', campaign: 'weekly' }
})
});

const result = await response.json();
console.log(`Создано ссылок: ${result.data.created}`);

PHP: получение аналитики

<?php
$api_key = 'YOUR_API_KEY';
$link_id = 'lnk_7xK9mQ';
$url = "https://vibes.su/api/v1/links/{$link_id}/stats?from=2026-01-01&to=2026-01-31";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer {$api_key}",
"Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$result = json_decode($response, true);

echo "Всего кликов: " . $result['data']['total_clicks'];
curl_close($ch);

Пример: автоматическое создание ссылки при новом заказе (вебхук)

Вебхук — это HTTP-запрос, который ваш сервер получает от внешнего сервиса при наступлении события. Например, в CRM появился новый лид → CRM отправляет вебхук на ваш обработчик → обработчик создаёт короткую ссылку через API.

Обработчик вебхука (Python Flask):

from flask import Flask, request
import requests

app = Flask(__name__)
API_KEY = "YOUR_API_KEY"

@app.route('/webhook/new-lead', methods=['POST'])
def new_lead():
data = request.json
lead_name = data['name']
lead_id = data['id']

# Создаём персонализированную короткую ссылку
response = requests.post(
'https://vibes.su/api/v1/links',
headers={'Authorization': f'Bearer {API_KEY}', 'Content-Type': 'application/json'},
json={
'url': f'https://crm.example.com/lead/{lead_id}',
'slug': f'lead-{lead_id}',
'utm': {'source': 'crm', 'medium': 'webhook', 'campaign': 'auto'}
}
)

short_url = response.json()['data']['short_url']
print(f"Для лида {lead_name} создана ссылка: {short_url}")

return {'status': 'ok', 'short_url': short_url}

if __name__ == '__main__':
app.run(port=5000)

Ограничения API и rate limiting

Большинство API для управления ссылками имеют ограничения на количество запросов в единицу времени (rate limiting). Это защита от перегрузки серверов.

Типичные лимиты (Vibes API): бесплатный тариф — 100 запросов/час, до 1000 ссылок всего. Pro тариф — 1 000 запросов/час, до 10 000 ссылок. Business тариф — 10 000 запросов/час, безлимитные ссылки.

Как работать с лимитами: отслеживайте заголовки ответов X-RateLimit-Remaining и X-RateLimit-Reset, при получении 429 Too Many Requests делайте паузу до времени, указанного в Retry-After, внедрите экспоненциальную задержку (exponential backoff) при повторных попытках, используйте массовые эндпоинты вместо одиночных запросов.

Безопасность API

API-ключ — это пароль. Обращайтесь с ним соответственно: храните ключ в переменных окружения, а не в коде, не публикуйте ключ в открытых репозиториях (GitHub), используйте разные ключи для production и разработки, регулярно ротируйте ключи, ограничьте IP-адреса, с которых можно использовать ключ (если сервис позволяет).


Частые вопросы (FAQ)

Что такое API-ключ и где его взять? API-ключ — это уникальная строка для авторизации запросов к API. В Vibes: Личный кабинет → Настройки → API → Создать ключ.

Сколько стоит использование API? API входит в тарифы Pro и Business. Бесплатный тариф имеет базовый доступ с ограничениями.

Можно ли создать 1000 ссылок за один запрос? Да, через эндпоинт /api/v1/links/bulk (массовое создание). Максимальное количество зависит от тарифа (обычно до 500-1000 ссылок за запрос).

Что делать, если API возвращает ошибку 401? Проверьте API-ключ. Возможно, он просрочен, отозван или передан не в том заголовке. Формат должен быть: Authorization: Bearer КЛЮЧ.

Как протестировать API, не написав ни строчки кода? Используйте инструменты вроде Postman, Insomnia или curl из командной строки. Они позволяют отправлять HTTP-запросы и видеть ответы.

Поддерживает ли API вебхуки? Да. Vibes API поддерживает вебхуки для уведомлений о событиях: создание ссылки, достижение порога кликов, окончание срока действия ссылки. Вебхуки настраиваются в личном кабинете.


Заключение

API для управления ссылками — это мост между вашей маркетинговой экосистемой и платформой управления трафиком. Он превращает рутинные операции в автоматические процессы, экономя часы ручного труда и исключая человеческие ошибки. Для бизнеса, генерирующего сотни и тысячи ссылок, API — не опция, а необходимость.

0 из 0 оценок

Рубрики

Обсуждаемое