REST API для QR-кодов, ссылок и мини-сайтов
Создавайте и меняйте QR-коды и короткие ссылки из своих систем, группируйте их по проектам и забирайте статистику сканирований. Запросы и ответы — в JSON, доступ — по API-ключу.
Примеры кода
Динамический QR-код создаётся одним запросом. Базовый адрес API — https://app.qrkoder.ru/api/v1.
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
}'// 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}`);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=ean13PNG-эндпоинт
Растровый формат для сайтов и документов.
GET /api/v1/public/barcode.png?data=...&format=code128<!-- 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-запросы с заголовком авторизации.
Готовых коннекторов нет: в n8n, Make и Zapier API подключается через HTTP-модуль, в 1С и Битрикс24 — через HTTP-запросы из обработок и бизнес-процессов. Примеры запросов — в документации.
API по тарифам
Лимит запросов — общий для всех ключей рабочего пространства. Лимиты на число QR-кодов и ссылок — как на странице тарифов.
| Тариф | Доступ к API | API-ключей | Запросов в минуту |
|---|---|---|---|
| Бесплатный | Нет | — | — |
| Базовый | Да | 3 | 60 |
| Pro | Да | 10 | 60 |
| Бизнес | Да | 50 | 60 |
| Безлимит | Да | Без ограничения | 60 |
В 14-дневном пробном периоде Pro API тоже доступен. Сравнить тарифы — на странице тарифов, особые условия — по запросу.
Как начать
Три шага до первого API-запроса.
Регистрация
Создайте аккаунт. Первые 14 дней действует пробный период тарифа Pro — API в нём доступен.
Выпустите API-ключ
В личном кабинете: Настройки → API ключи. Полный ключ показывается один раз — сохраните его на сервере.
Первый запрос
Отправьте POST /qr-codes с заголовком Authorization: Bearer и получите созданный код в JSON.
Пример ответа
Ответ на создание динамического QR-кода. В изображение кодируется короткий адрес https://qrmee.ru/{shortLink.slug}.
{
"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-коды с аналитикой, дизайном и без ограничений по сканированиям.
Начать бесплатно