QRkoder

REST API для QR-кодов, ссылок и мини-сайтов

Создавайте и меняйте QR-коды и короткие ссылки из своих систем, группируйте их по проектам и забирайте статистику сканирований. Запросы и ответы — в JSON, доступ — по API-ключу.

Примеры кода

Динамический QR-код создаётся одним запросом. Базовый адрес API — https://app.qrkoder.ru/api/v1.

cURL
curl -X POST https://app.qrkoder.ru/api/v1/qr-codes \
  -H "Authorization: Bearer $QRKODER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Меню ресторана",
    "type": "URL",
    "content": "https://example.ru/menu",
    "isDynamic": true
  }'
JavaScript (fetch)
// Node.js 18+ (встроенный fetch). Ключ храните в переменной окружения.
const response = await fetch("https://app.qrkoder.ru/api/v1/qr-codes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.QRKODER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    title: "Меню ресторана",
    type: "URL",
    content: "https://example.ru/menu",
    isDynamic: true,
  }),
});

if (!response.ok) {
  const err = await response.json();
  throw new Error(`${response.status} ${err.error}: ${err.message}`);
}

const qr = await response.json();
console.log("Адрес для печати:", `https://qrmee.ru/${qr.shortLink.slug}`);
Python (requests), короткая ссылка
import os
import requests

response = requests.post(
    "https://app.qrkoder.ru/api/v1/short-links",
    headers={"Authorization": f"Bearer {os.environ['QRKODER_API_KEY']}"},
    json={
        "targetUrl": "https://example.ru/sale",
        "slug": "sale",
        "utmSource": "print",
    },
    timeout=30,
)
response.raise_for_status()

link = response.json()
print(link["id"], link["slug"])

API штрихкодов

Бесплатный публичный API для генерации штрихкодов: без регистрации и API-ключа. SVG и PNG по прямой ссылке.

SVG-эндпоинт

Векторный формат для печати и масштабирования.

GET /api/v1/public/barcode?data=...&format=ean13

PNG-эндпоинт

Растровый формат для сайтов и документов.

GET /api/v1/public/barcode.png?data=...&format=code128
HTML
<!-- SVG штрихкод -->
<img src="https://app.qrkoder.ru/api/v1/public/barcode?data=5901234123457&format=ean13" alt="EAN-13" />

<!-- PNG штрихкод -->
<img src="https://app.qrkoder.ru/api/v1/public/barcode.png?data=5901234123457&format=ean13" alt="EAN-13" />

Поддерживаемые форматы: EAN-13, EAN-8, UPC-A, Code 128, Code 39, ITF-14, Code 93, MSI. Настраиваемые параметры: ширина линий, высота, цвет штрихов и фона, отображение текста.

Что можно через API

QR-коды, ссылки и проекты — чтение и запись; статистика и мини-сайты — чтение.

QR-коды

Создание, изменение, пауза и удаление статических и динамических QR-кодов всех типов конструктора. Динамический код получает короткий адрес: содержимое меняется без перепечатки.

Короткие ссылки

Создание и изменение ссылок: свой адрес, UTM-метки, срок действия, пароль, лимит переходов, собственный домен.

Проекты

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

Статистика

Сводка по рабочему пространству и по отдельному коду или ссылке: география, устройства, ОС, браузеры, источники, журнал сканирований. Глубина истории — по тарифу.

Мини-сайты

Чтение списка мини-сайтов, их содержимого и истории версий. Создание и редактирование — в личном кабинете.

Пакетные операции

Изменение и удаление до 100 QR-кодов или ссылок за один запрос. Создаются объекты по одному.

Интеграции

API подключается к любой системе, которая умеет отправлять HTTPS-запросы с заголовком авторизации.

n
n8n
M
Make
Z
Zapier
1
1С
Б
Битрикс24

Готовых коннекторов нет: в n8n, Make и Zapier API подключается через HTTP-модуль, в 1С и Битрикс24 — через HTTP-запросы из обработок и бизнес-процессов. Примеры запросов — в документации.

API по тарифам

Лимит запросов — общий для всех ключей рабочего пространства. Лимиты на число QR-кодов и ссылок — как на странице тарифов.

ТарифДоступ к APIAPI-ключейЗапросов в минуту
БесплатныйНет——
БазовыйДа360
ProДа1060
БизнесДа5060
БезлимитДаБез ограничения60

В 14-дневном пробном периоде Pro API тоже доступен. Сравнить тарифы — на странице тарифов, особые условия — по запросу.

Как начать

Три шага до первого API-запроса.

Шаг 1

Регистрация

Создайте аккаунт. Первые 14 дней действует пробный период тарифа Pro — API в нём доступен.

Шаг 2

Выпустите API-ключ

В личном кабинете: Настройки → API ключи. Полный ключ показывается один раз — сохраните его на сервере.

Шаг 3

Первый запрос

Отправьте POST /qr-codes с заголовком Authorization: Bearer и получите созданный код в JSON.

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

Ответ на создание динамического QR-кода. В изображение кодируется короткий адрес https://qrmee.ru/{shortLink.slug}.

POST /api/v1/qr-codes — 201 Created
{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-5a7b8c9d0e1f",
  "title": "Меню ресторана",
  "type": "URL",
  "content": "https://example.ru/menu",
  "style": "CLASSIC",
  "isActive": true,
  "scansTotal": 0,
  "shortLinkId": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e",
  "shortLink": {
    "id": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e",
    "slug": "Xk3dP9a",
    "domainId": null,
    "domain": null
  },
  "project_id": null,
  "folderId": null,
  "tags": [],
  "createdAt": "2026-09-29T10:00:00.000Z",
  "updatedAt": "2026-09-29T10:00:00.000Z"
}

Частые вопросы об API

На каких тарифах доступен API?

API доступен на платных тарифах начиная с «Базового» и в 14-дневном пробном периоде Pro. Число ключей зависит от тарифа: «Базовый» — 3, Pro — 10, «Бизнес» — 50, «Безлимит» — без ограничения. На бесплатном тарифе API нет. Публичный API штрихкодов работает без ключа и регистрации.

Какие лимиты на количество запросов?

60 запросов в минуту на рабочее пространство — это общий лимит для всех его ключей. При превышении API отвечает кодом 429 с заголовком Retry-After, в котором указано, через сколько секунд повторить запрос. Лимиты на число QR-кодов и ссылок те же, что в личном кабинете.

Как проходить аутентификацию?

Передавайте ключ в заголовке Authorization: Bearer qrk_… в каждом запросе. Ключ выпускает владелец или администратор рабочего пространства в личном кабинете. Храните ключ только на сервере: он даёт доступ к кодам, ссылкам и статистике всего рабочего пространства.

Что доступно по API-ключу?

QR-коды, короткие ссылки и проекты — чтение и запись; статистика и мини-сайты — только чтение. Тариф и оплата, команда, домены, файлы и сами ключи управляются только в личном кабинете.

Отдаёт ли API изображения QR-кодов?

Нет, API работает с данными в формате JSON. Динамический код получает короткий адрес — его вы кодируете в изображение своей библиотекой. Готовые файлы PNG и SVG с дизайном скачиваются в личном кабинете.

Создавайте QR-коды бесплатно

Динамические QR-коды с аналитикой, дизайном и без ограничений по сканированиям.

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