Начать бесплатно

Начало работы

Для начала работы с API LinkFlow вам потребуется API-ключ. Получите его в личном кабинете в разделе «Настройки» → «Безопасность». Все запросы должны отправляться на базовый URL https://api.linkflow.io/v1 с использованием протокола HTTPS.

Аутентификация осуществляется через заголовок Authorization. Используйте формат Bearer ВАШ_API_КЛЮЧ. Лимит запросов составляет 1000 запросов в минуту для базового тарифа и безлимитно для корпоративных планов.

Пример кода интеграции API LinkFlow в среде разработки

Справочник API

Основные методы для управления ссылками. Каждый метод возвращает ответ в формате JSON.

POST

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

/links
Создает новую короткую ссылку. Обязательные параметры: domain, path, target_url. Поддерживает массовое создание через массив объектов.

PUT

Обновление ссылки

/links/{id}
Изменяет целевой URL или параметры редиректа существующей ссылки. Позволяет обновлять UTM-метки без изменения короткой ссылки.

DELETE

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

/links/{id}
Безвозвратно удаляет ссылку из базы данных. Статус кода 204 означает успешное удаление. Ссылка перестает работать немедленно.

GET

Статистика кликов

/links/{id}/analytics
Возвращает детальные данные: количество кликов, геолокацию, устройства и источники трафика за заданный период.

Примеры кода

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

Python

Использование библиотеки requests для создания ссылки.

import requests
headers = {'Authorization': 'Bearer YOUR_KEY'}
data = {'url': 'https://example.com'}
response = requests.post('https://api.linkflow.io/v1/links', json=data, headers=headers)

JavaScript (Node.js)

Асинхронный запрос с использованием fetch.

const res = await fetch('https://api.linkflow.io/v1/links', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_KEY' },
  body: JSON.stringify({ url: 'https://example.com' })
});

cURL

Быстрый тест прямо из терминала.

curl -X POST https://api.linkflow.io/v1/links \ -H "Authorization: Bearer YOUR_KEY" \ -d '{"url": "https://example.com"}'

Поддержка и сообщество

Не нашли ответ на свой вопрос? Наша команда разработчиков и активное сообщество готовы помочь.

Техническая поддержка

Напишите нам на dev-support@linkflow.io. Среднее время ответа — 2 часа в рабочее время.

Написать в поддержку

Форум разработчиков

Обсуждайте лучшие практики интеграции, делитесь сниппетами кода и задавайте вопросы другим разработчикам.

Перейти на форум