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

Полное руководство по интеграции API генерации динамических QR-кодов.

Быстрый старт
Основная информация для подключения

Base URL

https://qr-api.ru/v1

Версия

v1.0.0 Public Beta

API принимает и отдает данные в формате JSON. Заголовки CORS настроены для публичного доступа.

Эндпоинты

POST
/qrcodes
Создает новый динамический QR-код с возможностью настройки дизайна.

Запрос

{
  "target_url": "https://yoursite.com",  // Обязательно: Ссылка для редиректа
  "design": {                           // Опционально: Настройки дизайна
    "color": "#000000",                 // Цвет QR-кода (HEX)
    "bgColor": "#ffffff"                // Цвет фона (HEX)
  }
}

Успешный Ответ (200 OK)

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "short_code": "x7yz9a",
    "target_url": "https://yoursite.com",
    "qr_image_url": "https://qr-api.ru/v1/qrcodes/x7yz9a.png",
    "created_at": "2026-01-30T12:00:00Z"
  }
}
GET
/analytics/{id}
Возвращает подробную статистику по конкретному QR-коду.

Параметры пути

id
UUID QR-кода, полученный при создании

Успешный Ответ (200 OK)

{
  "success": true,
  "data": {
    "total_scans": 150,
    "unique_visitors": 120,
    "scans_by_os": {
        "Android": 80,
        "iOS": 40,
        "Windows": 30
    },
    "scans_by_device": {
        "Mobile": 120,
        "Desktop": 30
    }
  }
}