Сократитель.рф

 К статьям
⚡ API

API для сокращения ссылок

Обновлено: 1 января 2025 • 10 минут чтения

API для сокращения ссылок позволяет автоматизировать создание коротких URL прямо из ваших приложений, CRM, систем автоматизации маркетинга и других сервисов.

Зачем нужен API

⚡ Получите API ключ

Начните автоматизировать создание ссылок прямо сейчас

Получить API ключ

REST API Сократитель.рф

Базовый URL

https://api.сократитель.рф/v1/

Аутентификация

Все запросы требуют API ключ в заголовке:

Authorization: Bearer YOUR_API_KEY

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

Endpoint

POST /links

Параметры запроса

{ "url": "https://example.com/very/long/url", "alias": "custom-alias", "title": "My Custom Link", "tags": ["marketing", "campaign"], "utm_source": "instagram", "utm_medium": "social", "utm_campaign": "summer_sale" }

Пример на Python

import requests api_key = "YOUR_API_KEY" url = "https://api.сократитель.рф/v1/links" headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } data = { "url": "https://example.com/product", "alias": "summer-sale", "utm_source": "email", "utm_campaign": "newsletter" } response = requests.post(url, json=data, headers=headers) short_link = response.json()["short_url"] print(f"Короткая ссылка: {short_link}")

Пример на JavaScript (Node.js)

const axios = require('axios'); const apiKey = 'YOUR_API_KEY'; const apiUrl = 'https://api.сократитель.рф/v1/links'; const data = { url: 'https://example.com/product', alias: 'summer-sale', utm_source: 'twitter', utm_campaign: 'promo' }; const headers = { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' }; axios.post(apiUrl, data, { headers }) .then(response => { console.log('Короткая ссылка:', response.data.short_url); }) .catch(error => { console.error('Ошибка:', error.response.data); });

Пример на PHP

$api_key = 'YOUR_API_KEY'; $api_url = 'https://api.сократитель.рф/v1/links'; $data = [ 'url' => 'https://example.com/product', 'alias' => 'sale', 'utm_source' => 'facebook' ]; $headers = [ 'Authorization: Bearer ' . $api_key, 'Content-Type: application/json' ]; $ch = curl_init($api_url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); $result = json_decode($response, true); echo "Короткая ссылка: " . $result['short_url']; curl_close($ch);

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

Endpoint

GET /links/{link_id}/analytics

Пример ответа

{ "link_id": "abc123", "short_url": "brand.rf/sale", "clicks": 1523, "unique_clicks": 892, "countries": { "RU": 654, "US": 123, "UA": 89 }, "devices": { "mobile": 856, "desktop": 512, "tablet": 155 }, "referrers": { "instagram.com": 432, "direct": 298, "vk.com": 187 } }

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

Endpoint

POST /links/bulk

Пример запроса

{ "links": [ { "url": "https://example.com/product1", "alias": "product1" }, { "url": "https://example.com/product2", "alias": "product2" }, { "url": "https://example.com/product3", "alias": "product3" } ] }

Можно создать до 1000 ссылок за один запрос.

🚀 Начните использовать API

Полная документация и примеры кода на разных языках

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

Кейсы использования API

1. CRM интеграция

Задача: Создавать персональную ссылку для каждого клиента.

Решение: При создании лида в CRM автоматически генерируется короткая ссылка с ID клиента. Отслеживайте, когда клиент открыл коммерческое предложение.

2. Email маркетинг

Задача: Отслеживать клики по каждой рассылке.

Решение: API автоматически создает уникальную ссылку для каждой рассылки с UTM-метками. Аналитика в реальном времени.

3. Динамические QR-коды

Задача: Генерировать QR-коды для печатных материалов.

Решение: API создает короткую ссылку, генерирует QR-код, возвращает изображение. Готово к печати.

4. Социальные сети

Задача: Автопостинг с короткими ссылками.

Решение: Перед публикацией поста API сокращает ссылку, добавляет UTM-метки, пост публикуется автоматически.

5. Affiliate маркетинг

Задача: Создавать уникальные реферальные ссылки.

Решение: Каждый партнер получает персональную короткую ссылку с трекингом всех переходов и конверсий.

Лимиты и Rate Limiting

Бесплатный план:

Pro план:

Business план:

Обработка ошибок

Коды ошибок

Пример обработки ошибок

try: response = requests.post(url, json=data, headers=headers) response.raise_for_status() result = response.json() print(f"Success: {result['short_url']}") except requests.exceptions.HTTPError as e: if e.response.status_code == 401: print("Неверный API ключ") elif e.response.status_code == 429: print("Превышен лимит запросов") else: print(f"Ошибка: {e.response.json()['message']}")

Webhook уведомления

Настройте webhook для получения уведомлений:

Пример webhook payload

{ "event": "link.clicked", "link_id": "abc123", "short_url": "brand.rf/sale", "timestamp": "2025-01-01T12:00:00Z", "data": { "country": "RU", "device": "mobile", "referrer": "instagram.com" } }

Best practices

1. Кешируйте результаты

Не создавайте новую ссылку каждый раз для одного URL. Сохраняйте уже созданные ссылки в базе данных.

2. Используйте retry логику

При ошибке 429 (rate limit) повторите запрос через несколько секунд.

3. Асинхронные запросы

Для создания большого количества ссылок используйте асинхронные запросы или массовое API.

4. Мониторинг

Следите за ошибками API и настройте алерты при проблемах.

5. Безопасность API ключа

Никогда не публикуйте API ключ в коде. Используйте переменные окружения.

Заключение

API Сократитель.рф позволяет полностью автоматизировать работу с короткими ссылками. Простая интеграция, мощная функциональность и подробная документация делают внедрение максимально быстрым и легким.

⚡ Начните использовать API

Получите API ключ и полную документацию бесплатно

Получить API ключ