QRFLOW.codes

официальный

Создавайте QR-коды, перенаправляйте напечатанные динамические коды, называйте ссылки на своём домене и читайте аналитику сканирований.

Что можно делать с QRFLOW Codes MCP?

  • Создавайте динамические QR-коды — Попросите ассистента создать код url с destination_data и вернуть его short_url для печати.
  • Изменяйте адрес перехода для уже напечатанного кода — Меняйте адрес, на который перенаправляет существующий динамический код, без повторной печати, поскольку изображение содержит short_url.
  • Приостанавливайте действие кода или задавайте срок его действия — Установите paused: true или дату окончания вместо удаления, чтобы напечатанная ссылка перестала перенаправлять пользователей.
  • Просматривайте аналитику сканирований — Получайте общее число Scans за всё время или разбивку по дням, странам и устройствам для конкретного кода.
  • Задавайте ссылкам имена в собственном домене — Установите slug, например menu, и выберите домен для ссылок, чтобы код печатался как go.example.com/menu.
  • Создавайте коды массово — Генерируйте тысячи динамических кодов из списка и сопоставляйте возвращённые коды со строками по метке.

Размещённый MCP-сервер

npx add-mcp 'https://qrflow.codes/mcp'

Устанавливается в Claude Code, Codex, Cursor и другие

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

QRFLOW.codes для разработчиков

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

QRFLOW.codes создаёт QR-коды, которые можно изменить после печати, использовать на собственном домене, отслеживать их сканирования, а также позволяет вашему ПО и ИИ-ассистенту выполнять всё это через единый API.

QR-код — это изображение строки. Большинство генераторов помещают в изображение ваш веб-адрес; если адрес изменится, напечатанный код станет бесполезным. QRFLOW помещает в изображение короткую ссылку (go.yourbrand.com/menu или qrflow.codes/q/x7k2p9a) и перенаправляет по ней. Вы можете в любой момент изменить адрес назначения, а каждое сканирование будет учтено. Это динамический код — именно для него и нужен API.

API делает всё то же, что и панель управления: создаёт коды любых типов, меняет адрес назначения, задаёт имена ссылок, выбирает домен для печати, получает статистику сканирований, создаёт тысячи кодов за раз и сообщает о событиях (вебхуки). Те же инструменты доступны через MCP-сервер, поэтому Claude, ChatGPT, Cursor и Claude Code могут управлять вашим аккаунтом обычными словами.

Доступ: для REST API нужен Business API-ключ ($29 в месяц, создаётся на странице Account) или OAuth-токен. MCP-сервер работает на любом тарифе после входа через OAuth; возможности ассистента по созданию кодов зависят от тарифа, как и в остальных случаях.

Решаете, стоит ли вообще его использовать? Страница API для QR-кодов — краткое описание: что он делает, в чём клиентская библиотека лучше и сколько это стоит.

Если вы ИИ-ассистент, помогающий кому-то работать с QRFLOW

Добро пожаловать. Эта страница написана и для вас, и для человека, которому вы помогаете. Вот как выглядит хорошая помощь:

  1. Уточните тариф аккаунта: для API-ключей нужен тариф Business. Если его нет, направьте пользователя на https://qrflow.codes/pricing и в раздел Account › API keys; не придумывайте несуществующий ключ или бесплатный тариф.
  2. Храните ключ на сервере. Читайте его из переменной окружения (QRFLOW_KEY) в обработчике маршрута, серверном действии, edge-функции или бэкенде. API намеренно отклоняет запросы из браузера (CORS), поэтому вызвать его только из фронтенд-кода нельзя.
  3. Создавайте динамические коды с type "url" и destination_data.url. Сохраняйте возвращённые id и short_url в базе данных пользователя. Печатайте или показывайте short_url; позже адрес назначения можно изменить с помощью PATCH /codes/:id, и напечатанный код останется действительным.
  4. Чтобы показать или сохранить изображение: у каждого объекта Code есть png_download_url и svg_download_url — подписанные ссылки, действующие 24 часа и не требующие заголовка (подходят для разового сохранения или предпросмотра). Для постоянного использования в приложении проксируйте GET /codes/:id/image.svg через сервер с ключом или закодируйте short_url на клиенте с помощью любой QR-библиотеки; отслеживание продолжит работать, поскольку ссылка проходит через QRFLOW.
  5. При PATCH отправляйте только изменяемые поля. Никогда не меняйте slug или domain_id после печати: оба параметра меняют напечатанную ссылку.
  6. Если код уже напечатан, предпочитайте paused: true вместо DELETE. Удаление отключает ссылку.
  7. Для получения событий используйте вебхуки (Account › Webhooks или POST /webhooks) и проверяйте заголовок X-QRFLOW-Signature по исходному телу запроса. Не опрашивайте GET /codes в цикле.
  8. Если пользователь хочет работать с QRFLOW из чата, а не из кода, подключите MCP-сервер по адресу https://qrflow.codes/mcp;; ключ для этого не нужен.
  9. Если запрос завершился ошибкой, прочитайте поля error и message в теле JSON. В разделе устранения неполадок ниже для каждого кода ошибки указано решение.
  10. Полная справка в формате Markdown доступна по адресу https://qrflow.codes/llms-full.txt, а документ OpenAPI 3.1 — по адресу https://qrflow.codes/api/v1/openapi.json.. Оба документа создаются из того же источника, что и эта страница.

Для людей: этот блок помогает нам убедиться, что ассистент, с которым вы работаете, даёт безопасные ответы. Заодно это хорошее краткое изложение.

Какой тариф нужен

Только API-ключ доступен исключительно на тарифе Business. Всё, что ассистент делает через MCP-сервер, и всё, что стороннее приложение делает через OAuth, работает на любом тарифе и использует доступные на нём функции. Полные сведения о ценах и правилах добросовестного использования: /pricing.

FreePremium $4Business $29
API-ключи (REST из вашего кода)НетНетДа, до 10 ключей
MCP-сервер (Claude, ChatGPT, Cursor, Claude Code)Да, после входаДаДа, после входа или с ключом
OAuth для вашего приложения (пользователи подключают свой QRFLOW)ДаДаДа
Динамические коды (изменение адреса назначения после печати)ОдинВсе кодыВсе коды
Собственный домен для ссылокНет1 домен5 доменов, выбор для каждого кода
Имена ссылок (go.brand.com/menu)НетДаДа
Аналитика сканированийНетДаДа
ВебхукиНетНетДа, до 10
Массовое созданиеНет500 в месяц, 500 за запрос10 000 в месяц, 2 000 за запрос
Сохранённые коды (добросовестное использование)Несколько1 00025 000
Места для участников команды115
Цена$0$4/месяц$29/месяц

Двенадцать слов, которые объясняют всё

Основные понятия

Прочитайте этот раздел один раз — и все приведённые ниже конечные точки станут понятны.

Static code

Содержимое находится внутри изображения. Коды Wi-Fi, контактные карточки (vCard) и обычный текст всегда статические, а на тарифе Free статичен каждый код. Статическому коду не нужен сервер, он никогда не истекает, его нельзя изменить или отслеживать.

Dynamic code

В изображении находится короткая ссылка, перенаправляемая QRFLOW. Коды типов url, phone, email, sms и location динамические на тарифах Premium и Business. Вы можете менять адрес назначения, приостанавливать и задавать срок действия, переименовывать и отслеживать их, не меняя напечатанный код.

short_url

Точная строка, закодированная в динамическом коде, — именно её нужно печатать. Это https://qrflow.codes/q/<short_code> до подключения домена, а после подключения — https://<your domain>/<slug or short_code>.. Она есть в каждом объекте Code.

short_code

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

slug (link name)

Понятный путь на вашем домене: go.example.com/menu. От 3 до 40 строчных букв, цифр и дефисов; должен быть уникальным в аккаунте и доступен только при подключённом домене. Задайте его до печати: изменение пути меняет напечатанную ссылку.

Link domain

Принадлежащий вам хост (go.example.com), направленный на QRFLOW с помощью CNAME и подтверждённый на странице Account. На тарифе Premium доступен один домен; на Business — пять, и для каждого кода можно выбрать домен с помощью domain_id. По умолчанию используется самый старый активный домен.

Kind, type and subtype

type — это формат кодирования: url, text, wifi, vcard, email, phone, sms, location. Тип назначения — более понятное название того, что нужно пользователю (instagram, googlereview, whatsapp, pdf, menu, appstore,...). Большинство типов назначения — это коды url с заданным destination_data.subtype. GET /catalog возвращает список всех типов назначения и их полей; поле kind в объекте Code указывает, какой тип назначения используется.

destination_data

Поля для типа в виде строк: { url } для веб-сайта, { ssid, password, encryption } для Wi-Fi, { placeId } для отзыва в Google, { handle } для Instagram. В динамическом коде их можно заменить в любой момент.

Scans

При каждом перенаправлении из самого запроса записываются тип устройства, страна, город, источник перехода, браузер, ОС и язык, а также односторонний ежедневный хеш для подсчёта уникальных посетителей. Файлы cookie не устанавливаются, IP-адрес не сохраняется. Поле scans в объекте Code содержит общее число сканирований за всё время; GET /codes/:id/scans возвращает подробную статистику.

Source

Каждый код хранит сведения о том, как он был создан: dashboard, api:<key name>, mcp, canva, app:<connected app> (например, app:Google Sheets) или bulk; для кодов, созданных массовым запросом, добавляется префикс bulk:. Эти сведения отображаются в панели управления и в данных вебхуков, поэтому можно отличить коды интеграции от созданных вручную.

Workspace

Владелец аккаунта Business может пригласить до четырёх участников команды. Ключи и вебхуки принадлежат аккаунту владельца; коды, созданные любым участником рабочего пространства, видны всей команде.

Пять минут

Быстрый старт

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

  1. На тарифе Business откройте Account › API keys.
  2. Назовите ключ в соответствии с его назначением ("Shop backend", "Reporting") и выберите области доступа. Изменить области доступа позже нельзя; если понадобится другой набор, создайте новый ключ.
  3. Скопируйте ключ — это можно сделать только один раз. Он выглядит так: qrf_live_…. Сохраните его в переменной окружения с именем QRFLOW_KEY.
  4. Передавайте его в заголовке Authorization: Bearer $QRFLOW_KEY при каждом запросе. Вот и всё, что нужно знать об аутентификации.

Ключи предназначены для серверов. Никогда не помещайте их на веб-страницу, в мобильное приложение или общую таблицу. Если ключ утёк, отзовите его и выпустите новый.

Те же пять шагов на curl, TypeScript и Python. Каждый пример создаёт динамический код, скачивает его изображение, меняет адрес назначения и получает статистику сканирований.

export QRFLOW_KEY=qrf_live_...   # from Account › API keys

# 1. Who am I, what can this key do?
curl https://qrflow.codes/api/v1/me -H "Authorization: Bearer $QRFLOW_KEY"

# 2. Make a dynamic code. Print what comes back as short_url.
curl -X POST https://qrflow.codes/api/v1/codes \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{ "type": "url", "destination_data": { "url": "https://example.com/menu" }, "label": "Table tents" }'

# 3. The print-ready image (SVG, with your colors and frame).
curl "https://qrflow.codes/api/v1/codes/$CODE_ID/image.svg?size=1024" \
  -H "Authorization: Bearer $QRFLOW_KEY" -o menu.svg

# 4. Fall menu. The printed code keeps working.
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{ "destination_data": { "url": "https://example.com/menu-fall" } }'

# 5. How did it do?
curl "https://qrflow.codes/api/v1/codes/$CODE_ID/scans?group=day" -H "Authorization: Bearer $QRFLOW_KEY"

TypeScript (Node 18+, Bun, Deno, Workers)

// npm install qrflow   (zero dependencies; ESM + CommonJS; full types)
import { QRFlow, QRFlowError } from "qrflow";

const qr = new QRFlow(process.env.QRFLOW_KEY!);

const { code } = await qr.createCode({
  type: "url",
  destination_data: { url: "https://example.com/menu" },
  label: "Table tents",
});
console.log(code.id, code.short_url);        // save both; print short_url

await qr.updateCode(code.id, { destination_data: { url: "https://example.com/menu-fall" } });

const stats = await qr.scans(code.id, { group: "day" });
console.log(stats.total, stats.rows);         // [{ key: "2026-09-21", scans: 18 }, ...]

try {
  await qr.updateCode(code.id, { slug: "menu" });
} catch (e) {
  if (e instanceof QRFlowError) console.log(e.status, e.code, e.message); // 400 no_domain: connect a domain first
}
# Download https://qrflow.codes/sdk/qrflow.py next to your code.
import os
from qrflow import QRFlow, QRFlowError

qr = QRFlow(os.environ["QRFLOW_KEY"])

code = qr.create_code(type="url", destination_data={"url": "https://example.com/menu"}, label="Table tents")["code"]
print(code["id"], code["short_url"])          # save both; print short_url

qr.update_code(code["id"], destination_data={"url": "https://example.com/menu-fall"})

stats = qr.scans(code["id"], group="day")
print(stats["total"], stats["rows"])

try:
    qr.update_code(code["id"], slug="menu")
except QRFlowError as e:
    print(e.status, e.code, e)                # 400 no_domain: connect a domain first

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

API-ключи (Business)

До 10 ключей на аккаунт, по 600 запросов в минуту на каждый. Ключи хранятся в хешированном виде и показываются только один раз. Каждый ключ содержит заданные при создании области доступа:

Область доступаРазрешения
profileGET /me: тариф, функции, лимиты. Есть у каждого ключа.
codes:readПросмотр списка и данных кодов, скачивание изображений.
codes:writeСоздание, изменение, преобразование в динамические, удаление и массовое создание кодов.
analytics:readGET /codes/:id/scans.
domains:readGET /domains (нужно для корректного использования domain_id).
codes:read / codes:writeТакже доступны товары GS1: конечные точки /products используют те же области доступа, что и коды, поэтому ключ для управления кодами подходит и для кодов на упаковке.
webhooks:manageПросмотр списка, создание, тестирование и удаление вебхуков.

OAuth 2.0 (любой тариф, для приложений и ассистентов)

Если коды должны принадлежать аккаунтам ваших пользователей, а не вашему аккаунту, или если клиентом выступает чат-ассистент, используйте OAuth. Клиенты регистрируются самостоятельно; для публичных клиентов обязателен PKCE S256; токены можно привязать к MCP-серверу с помощью resource=. В руководстве по OAuth описан весь процесс.

Конечная точкаURLПримечания
Авторизацияhttps://qrflow.codes/oauth/authorizeПеренаправьте пользователя сюда; он войдёт в систему и нажмёт Allow.
Токенhttps://qrflow.codes/api/oauth/tokenПотоки authorization_code и refresh_token. Срок действия токенов доступа — 1 час, токенов обновления — 90 дней.
Отзывhttps://qrflow.codes/api/oauth/revokeRFC 7009. Пользователи также могут отключить приложение в разделе Account › Connected apps.
Регистрация клиентаhttps://qrflow.codes/api/oauth/registerДинамическая регистрация по RFC 7591, аккаунт не нужен. Публичные клиенты получают dyn_client_id и должны использовать PKCE S256.
Обнаружениеhttps://qrflow.codes/.well-known/oauth-authorization-serverRFC 8414. Документ ресурсов MCP доступен по адресу /.well-known/oauth-protected-resource.

Токены доступа действуют 1 час, токены обновления — 90 дней. Пользователи видят подключённые приложения в разделе Account › Connected apps и могут отключить их в любой момент. Токен, выпущенный для https://qrflow.codes/mcp, отклоняется на /api/v1, и наоборот.

То, о чём чаще всего спрашивают

Примеры для разработки

Каждый пример полностью готов и взят из работающего кода. Выберите подходящий для вашего стека; структура всегда одна и та же: серверный запрос с ключом, сохранение id и short_url, отображение изображения.

Next.js: маршрут для создания кода и маршрут для его отображения

Когда использовать: у вас есть приложение Next.js (App Router), и вам нужна кнопка для создания QR-кода и страница для его отображения.

  1. Поместите ключ в .env.local как QRFLOW_KEY. Не добавляйте к нему префикс NEXT_PUBLIC_.
  2. Добавьте обработчик маршрута POST, который создаёт код и возвращает id и short_url.
  3. Добавьте маршрут GET, который проксирует изображение, чтобы браузер никогда не видел ключ.
  4. Сохраните id и short_url в собственной записи (заказ, стол, товар, событие).
import { NextResponse } from "next/server";

export async function POST(req: Request) {
  const { url, label } = await req.json();
  const r = await fetch("https://qrflow.codes/api/v1/codes", {
    method: "POST",
    headers: { Authorization: \`Bearer ${process.env.QRFLOW_KEY}\`, "Content-Type": "application/json" },
    body: JSON.stringify({ type: "url", destination_data: { url }, label }),
  });
  const data = await r.json();
  if (!r.ok) return NextResponse.json(data, { status: r.status }); // { error, message }
  return NextResponse.json({ id: data.code.id, short_url: data.code.short_url });
}
// Proxies the SVG so the key stays on the server. Check that the signed-in
// user owns this id before you serve it, or anyone with an id can fetch it.
export async function GET(_: Request, { params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const r = await fetch(\`https://qrflow.codes/api/v1/codes/${id}/image.svg?size=1024\`, {
    headers: { Authorization: \`Bearer ${process.env.QRFLOW_KEY}\` },
  });
  return new Response(r.body, {
    status: r.status,
    headers: { "Content-Type": "image/svg+xml", "Cache-Control": "private, max-age=3600" },
  });
}
<img src={\`/api/qr/${code.id}/image\`} alt={\`QR code for ${code.label}\`} width={256} height={256} />
<a href={code.short_url}>{code.short_url}</a>
  • Server Actions работают так же: вызывайте fetch с ключом внутри action.
  • Для Pages Router тот же код размещается в pages/api/qr.ts с req/res.

Показывайте QR-код без прокси: самостоятельно отображайте short_url

Когда: изображение нужно сразу показать в браузере, а кадры или логотип QRFLOW не нужны.

Подойдёт любая библиотека для QR-кодов, потому что код — это и есть короткая ссылка

import QRCode from "qrcode"; // npm i qrcode

// short_url came back from POST /codes. Encode it as-is.
const dataUrl = await QRCode.toDataURL(code.short_url, { width: 512, margin: 2 });
// <img src={dataUrl} />  scans go through QRFLOW, so analytics and re-pointing still work.
  • Это самый быстрый способ получить предварительный просмотр. Для печати скачайте /codes/:id/image.svg: в нём сохранены цвета, рамка, подписи и логотип, а сам файл векторный.
  • Если позже изменить slug или domain_id, short_url изменится; отобразите код заново.

Express или любой сервер Node

Когда: обычный бэкенд Node.

import express from "express";
const app = express();
app.use(express.json());
const H = { Authorization: \`Bearer ${process.env.QRFLOW_KEY}\`, "Content-Type": "application/json" };

app.post("/qr", async (req, res) => {
  const r = await fetch("https://qrflow.codes/api/v1/codes", {
    method: "POST", headers: H,
    body: JSON.stringify({ type: "url", destination_data: { url: req.body.url }, label: req.body.label }),
  });
  res.status(r.status).json(await r.json());
});

app.get("/qr/:id.svg", async (req, res) => {
  const r = await fetch(\`https://qrflow.codes/api/v1/codes/${req.params.id}/image.svg\`, { headers: H });
  res.status(r.status).type("image/svg+xml").send(await r.text());
});

app.listen(3000);

Cloudflare Workers, Vercel Edge, Deno Deploy, Supabase Edge Functions

Когда: среда выполнения, поддерживающая только fetch и не имеющая встроенных модулей Node.

export default {
  async fetch(req: Request, env: { QRFLOW_KEY: string }) {
    const { url, label } = await req.json();
    const r = await fetch("https://qrflow.codes/api/v1/codes", {
      method: "POST",
      headers: { Authorization: \`Bearer ${env.QRFLOW_KEY}\`, "Content-Type": "application/json" },
      body: JSON.stringify({ type: "url", destination_data: { url }, label }),
    });
    return new Response(r.body, { status: r.status, headers: { "Content-Type": "application/json" } });
  },
};
Deno.serve(async (req) => {
  const { url, label } = await req.json();
  const r = await fetch("https://qrflow.codes/api/v1/codes", {
    method: "POST",
    headers: { Authorization: \`Bearer ${Deno.env.get("QRFLOW_KEY")}\`, "Content-Type": "application/json" },
    body: JSON.stringify({ type: "url", destination_data: { url }, label }),
  });
  return new Response(await r.text(), { status: r.status, headers: { "Content-Type": "application/json" } });
});
// supabase secrets set QRFLOW_KEY=qrf_live_...
  • Пакет npm qrflow\ использует только fetch и WebCrypto, поэтому работает во всех этих средах без изменений.

Python: FastAPI, Flask, Django, скрипт

Когда: ваш бэкенд написан на Python.

import os
from fastapi import FastAPI, HTTPException, Response
from qrflow import QRFlow, QRFlowError   # https://qrflow.codes/sdk/qrflow.py

app = FastAPI()
qr = QRFlow(os.environ["QRFLOW_KEY"])

@app.post("/qr")
def make_qr(url: str, label: str | None = None):
    try:
        code = qr.create_code(type="url", destination_data={"url": url}, label=label)["code"]
    except QRFlowError as e:
        raise HTTPException(e.status, {"error": e.code, "message": str(e)})
    return {"id": code["id"], "short_url": code["short_url"]}

@app.get("/qr/{code_id}.svg")
def qr_image(code_id: str):
    import urllib.request
    req = urllib.request.Request(qr.image_url(code_id), headers={"Authorization": f"Bearer {os.environ['QRFLOW_KEY']}"})
    with urllib.request.urlopen(req) as r:
        return Response(r.read(), media_type="image/svg+xml")

Отдельный QR-код для каждого заказа, столика, товара, билета или мероприятия

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

  1. Добавьте в таблицу два столбца: qrflow_code_id (uuid) и qr_short_url (text).
  2. При создании строки отправьте POST /codes с общедоступным URL этой строки и меткой, которая её описывает ("Order 10432", "Table 7"). Сохраните id и short_url.
  3. Если страница строки переместилась (новый домен или путь), выполните PATCH destination_data. Напечатанные коды продолжат работать.
  4. Когда строка больше не нужна, выполните PATCH { paused: true }, если код уже напечатан; DELETE — только если он не был напечатан.
  5. Нужно создать тысячи кодов за раз (например, меню для каждого столика в 300 ресторанах)? Используйте POST /codes/bulk пакетами и сопоставьте возвращённые коды со строками по метке или порядку.
const { code } = await qr.createCode({
  type: "url",
  destination_data: { url: \`https://example.com/orders/${order.id}\` },
  label: \`Order ${order.number}\`,
});
await db.orders.update(order.id, { qrflow_code_id: code.id, qr_short_url: code.short_url });
  • Правила добросовестного использования разрешают хранить до 25,000 кодов на Business; API ограничивает количество вдвое большим значением. Если вам нужен отдельный код для каждого чека навсегда, сначала свяжитесь с нами: hello@qrflow.codes.

Измените адрес, на который ведёт напечатанный код

Когда: кампания завершилась, страница переместилась, PDF заменили или сменился сезон.

curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{ "destination_data": { "url": "https://example.com/spring" } }'

Приостановите код или задайте дату окончания

# Scans show a "paused" page instead of redirecting
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" -d '{ "paused": true }'

# Stops working after the date; null clears it
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" -d '{ "expires_at": "2026-12-31T23:59:59Z" }'
  • Перенаправлять можно только динамические коды; для статических кодов возвращается 400 not_dynamic. Коды Wi-Fi, vCard и обычного текста содержат данные непосредственно в изображении и не могут быть динамическими, поэтому POST /codes/:id/dynamic возвращает 400 not_dynamic_capable. Для кодов url, phone, email, sms и location на Free первый код будет динамическим, а остальные — статическими; на платном плане все коды динамические. POST /codes/:id/dynamic преобразует статический код в динамический, если в аккаунте ещё есть доступная квота. После этого заново отобразите и распечатайте код, поскольку его изображение изменится.
  • Сканер увидит новый адрес при следующем сканировании. Ждать обновления кэша не нужно.

Печатайте коды на собственном домене

Когда: вместо qrflow.codes/q/x7k2p9a в коде должен быть адрес go.example.com/menu.

  1. На странице Account в разделе Your own link domain добавьте go.example.com и создайте у DNS-провайдера запись CNAME, которую он покажет. Проверка обычно завершается за несколько минут.
  2. После этого в short_url каждого нового динамического кода будет использоваться этот домен. Существующие коды тоже переключатся: на их изображениях закодирован адрес qrflow.codes/q/..., который продолжит перенаправлять, поэтому уже напечатанные коды останутся рабочими.
  3. Присвойте кодам понятные имена с помощью slug: PATCH { "slug": "menu" } создаст адрес go.example.com/menu. Сделайте это до печати.
  4. На плане Business с несколькими доменами GET /domains возвращает их список с id; передайте domain_id в POST или PATCH, чтобы выбрать домен для конкретного кода.

Назовите ссылку и выберите домен

curl https://qrflow.codes/api/v1/domains -H "Authorization: Bearer $QRFLOW_KEY"
# { "default_base": "https://go.example.com", "domains": [ { "id": "…", "host": "go.example.com", "is_default": true, … }, { "id": "…", "host": "qr.example.fr", … } ] }

curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{ "slug": "menu", "domain_id": "<id of qr.example.fr>" }'
# short_url is now https://qr.example.fr/menu

Диаграмма сканирований в собственной панели администратора

Когда: рядом с собственными показателями нужны данные о сканированиях по дням, странам или устройствам.

const stats = await qr.scans(code.id, { from: "2026-09-01", to: "2026-09-30", group: "day" });
// stats.total -> 412
// stats.rows  -> [{ key: "2026-09-01", scans: 18 }, { key: "2026-09-02", scans: 25 }, ...]
// Feed rows straight into Recharts, Chart.js, or a <table>.

const byCountry = await qr.scans(code.id, { group: "country" });   // [{ key: "US", scans: 300 }, { key: "MX", scans: 41 }]
const byDevice  = await qr.scans(code.id, { group: "device" });    // mobile, desktop, tablet
  • Один запрос охватывает до 92 дней; для более длинных периодов выполняйте запросы в цикле. Даты указаны в UTC.
  • Чтобы получать актуальные данные без периодических запросов, подпишитесь на webhook события сканирования: каждые несколько минут вы будете получать сведения обо всех сканированиях пакетами.

Принимайте webhooks в Next.js и проверяйте их

Когда: нужно почти в реальном времени узнавать о сканировании или изменении кода и сохранять эти данные в собственной базе.

  1. Создайте webhook на странице Account › Webhooks или с помощью POST /webhooks. Скопируйте секрет (whsec_...) в QRFLOW_WEBHOOK_SECRET; сделать это можно только один раз.
  2. Сначала прочитайте исходное тело запроса как текст и только потом разбирайте его: подпись вычисляется по точным байтам.
  3. Проверьте подпись, затем обработайте событие. Быстро верните ответ 2xx; длительную обработку выполните после ответа или в очереди.
  4. Нажмите Test у webhook, чтобы получить подписанный тестовый запрос и проверить настройку.
import { createHmac, timingSafeEqual } from "node:crypto";

function verify(raw: string, header: string, secret: string): boolean {
  const t = /t=(\d+)/.exec(header)?.[1], v1 = /v1=([a-f0-9]+)/.exec(header)?.[1];
  if (!t || !v1 || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = createHmac("sha256", secret).update(\`${t}.${raw}\`).digest("hex");
  return expected.length === v1.length && timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

export async function POST(req: Request) {
  const raw = await req.text();
  if (!verify(raw, req.headers.get("x-qrflow-signature") ?? "", process.env.QRFLOW_WEBHOOK_SECRET!)) {
    return new Response("bad signature", { status: 401 });
  }
  const evt = JSON.parse(raw) as { id: string; event: string; created_at: string; data: any };
  // evt.id is stable across retries: store it and skip duplicates.

  switch (evt.event) {
    case "scan":          // evt.data.scans[]: code_id, label, slug, scanned_at, device, country, city, referrer, browser, os, language
      break;
    case "code.created":  // evt.data.code, evt.data.source
    case "code.updated":  // evt.data.code, evt.data.changed[]
    case "code.deleted":  // evt.data.code { id, label, short_code, slug }
      break;
    case "ping":          // the Test button
      break;
  }
  return new Response(null, { status: 204 });
}
  • Для локальной разработки откройте доступ к серверу через туннель (cloudflared tunnel --url http://localhost:3000, или ngrok) и используйте его https URL для webhook.
  • Пакет npm сделает это за вас: import { parseWebhook } from "qrflow"\ проверяет подпись и разбирает данные одним вызовом (WebCrypto, поэтому пакет также работает в Workers и Deno). В клиенте Python есть verify_webhook.

Принимайте webhooks в Python

Когда: Flask, FastAPI или Django принимает те же события.

import os, json
from flask import Flask, request, abort
from qrflow import verify_webhook   # https://qrflow.codes/sdk/qrflow.py

app = Flask(__name__)

@app.post("/qrflow")
def hook():
    raw = request.get_data()  # bytes, before any parsing
    if not verify_webhook(raw, request.headers.get("X-QRFLOW-Signature", ""), os.environ["QRFLOW_WEBHOOK_SECRET"]):
        abort(401)
    evt = json.loads(raw)
    if evt["event"] == "scan":
        for s in evt["data"]["scans"]:
            print(s["code_id"], s["scanned_at"], s["country"], s["device"])
    return "", 204

Тысячи кодов из CSV

Когда: нужен отдельный код для каждого SKU, места, инвентарного номера или почтовой рассылки.

import { parse } from "csv-parse/sync";
import { readFileSync } from "node:fs";

const rows = parse(readFileSync("skus.csv"), { columns: true }) as Array<{ sku: string; url: string }>;
const out: Array<{ sku: string; id: string; short_url: string }> = [];

for (let i = 0; i < rows.length; i += 2000) {                 // Business: 2,000 per request
  const chunk = rows.slice(i, i + 2000);
  const { codes, rejected, remaining_this_month } = await qr.bulkCreate(
    chunk.map((r) => ({ destination: r.url, label: r.sku })),
  );
  codes.forEach((c, j) => out.push({ sku: chunk[j].sku, id: c.id, short_url: c.short_url }));
  if (rejected.length) console.warn(rejected);                  // rows that were not web addresses
  console.log(remaining_this_month, "left this month");
}
  • Bulk создаёт только динамические коды url, все с одинаковыми цветами. Коды возвращаются в том же порядке, в котором вы их отправили, за исключением отклонённых строк; если сомневаетесь, сопоставляйте их по метке.
  • Для каждого bulk-запроса webhook отправляет одно событие code.created с codes[], а не отдельное событие для каждого кода.

Позвольте пользователям подключать собственные аккаунты QRFLOW (OAuth)

Когда: вы создаёте продукт для других людей и хотите, чтобы коды попадали в их аккаунты QRFLOW, а не в ваш.

  1. Зарегистрируйте клиент один раз: POST https://qrflow.codes/api/oauth/register с client_name и redirect_uris. Вы получите client_id (а для конфиденциальных клиентов — client_secret).
  2. Перенаправьте пользователя на /oauth/authorize с параметрами response_type=code, client_id, redirect_uri, scope, state и PKCE (code_challenge, code_challenge_method=S256).
  3. Обменяйте код на /api/oauth/token. Сохраните refresh token; срок действия access token — один час.
  4. Вызывайте /api/v1 с заголовком Authorization: Bearer <access_token>. Всё работает так же, как с ключом, но в рамках плана пользователя.
curl -X POST https://qrflow.codes/api/oauth/register -H "Content-Type: application/json" \
  -d '{ "client_name": "Acme Menus", "redirect_uris": ["https://app.example.com/oauth/qrflow"], "token_endpoint_auth_method": "none" }'
# { "client_id": "dyn_…", "redirect_uris": [...], "grant_types": ["authorization_code","refresh_token"], … }
https://qrflow.codes/oauth/authorize?response_type=code&client_id=dyn_…&redirect_uri=https%3A%2F%2Fapp.example.com%2Foauth%2Fqrflow
  &scope=profile%20codes%3Aread%20codes%3Awrite%20analytics%3Aread&state=…&code_challenge=…&code_challenge_method=S256
  • Области доступа те же, что и у ключей API: всего шесть. Запрашивайте только необходимые; они перечислены на экране согласия.
  • Если ваше приложение — чат-ассистент или агент, добавьте resource=https://qrflow.codes/mcp в запрос авторизации и вместо этого обращайтесь к MCP-серверу; токен будет привязан к нему.

Zapier, Make, n8n: вообще без кода

Когда: нужно отправлять данные о сканированиях или новых кодах в таблицу, канал Slack или CRM.

  1. Создайте триггер catch-hook (Zapier: Webhooks by Zapier › Catch Hook; Make: Custom webhook; n8n: узел Webhook) и скопируйте его https URL.
  2. На странице Account › Webhooks добавьте этот URL и выберите события. Нажмите Test; тестовый запрос появится в инструменте и покажет структуру данных.
  3. Передайте data.scans[] (для сканирования) или data.code (для code.*) в таблицу, сообщение или запись.
  4. Чтобы создавать коды из этих инструментов, используйте их HTTP-модуль для вызова POST /codes с заголовком Authorization. Храните ключ в хранилище учётных данных инструмента.
  • В Zapier теперь есть приложение QRFLOW.codes: для шагов Create QR Code, Update QR Code и Find, а также мгновенного триггера New Scan не нужны ни настройка webhook, ни ключ API. См. QRFLOW with Zapier. Инструкции ниже предназначены для Make, n8n и других инструментов.
  • Эти инструменты не могут проверить подпись. Защиту обеспечивает непредсказуемый URL, который они вам предоставляют; не публикуйте его.
  • Если список уже хранится в Google Sheets, webhook может не понадобиться: дополнение QRFLOW for Google Sheets создаёт код для каждой строки и записывает короткую ссылку и количество сканирований обратно в таблицу. Оно доступно на Premium и не требует ключа API. См. дополнение Google Sheets.

Программирование по настроению

Готовые промпты

Ассистенты для программирования создают правильное решение, если заранее сообщить им правила. Эти промпты содержат нужные правила. Вставьте один из них, заполните текст в квадратных скобках, и ассистент прочитает справочник в Markdown, прежде чем написать первую строку кода.

Добавьте QR-коды в моё приложение

Claude, ChatGPT, Cursor, Codex, Windsurf, Copilot Chat: вставьте в чат

Add QR codes to this project using the QRFLOW.codes API.

Read https://qrflow.codes/llms-full.txt before writing code; it is the complete reference.

Rules:
- The API key is in the environment variable QRFLOW_KEY. It must only be used server-side (route handler, server action, edge function). Never expose it to the browser.
- Create dynamic codes: POST https://qrflow.codes/api/v1/codes with { "type": "url", "destination_data": { "url": ... }, "label": ... }.
- Save the returned code.id and code.short_url on my record. short_url is what gets printed or displayed.
- Show the image by proxying GET /codes/:id/image.svg through my server, or by encoding short_url with a QR library on the client.
- Handle errors from the JSON body: { "error", "message" }. Map 402 to "upgrade needed", 429 to a retry with the Retry-After header.

What I want: [describe the feature, e.g. "every event in my events table gets a QR code that opens its public page; show it on the event admin page with a download button"].

Добавьте сведения о QRFLOW в свой репозиторий

Добавьте в CLAUDE.md, AGENTS.md,.cursorrules или.github/copilot-instructions.md

## QR codes (QRFLOW.codes)
- Docs: https://qrflow.codes/llms-full.txt (Markdown), https://qrflow.codes/api/v1/openapi.json (OpenAPI 3.1).
- Base URL https://qrflow.codes/api/v1, header Authorization: Bearer $QRFLOW_KEY. Server-side only.
- Codes are created with POST /codes { type: "url", destination_data: { url }, label }. Store code.id and code.short_url.
- Change the destination with PATCH /codes/:id { destination_data: { url } }. Never change slug/domain_id after printing.
- Image: GET /codes/:id/image.svg (needs the key). Prefer paused: true over DELETE when a print exists.
- Webhooks arrive as POST with X-QRFLOW-Signature (t=,v1=HMAC-SHA256 of "t.rawBody"); verify with the raw body.

В Lovable, Bolt, v0, Replit и других конструкторах приложений

Конструкторы с приоритетом фронтенда, которые предоставляют бэкенд (Supabase, serverless functions)

Integrate QRFLOW.codes QR codes. The API refuses browser calls, so create a backend function (Supabase Edge Function / serverless function) that holds the secret QRFLOW_KEY and calls POST https://qrflow.codes/api/v1/codes with { "type": "url", "destination_data": { "url": "<the page URL>" }, "label": "<name>" }. Return code.id and code.short_url to the UI and save them in the database. Render the QR in the UI by encoding short_url with a QR library; add a "Download for print" button that fetches /codes/:id/image.svg through the same backend function. Reference: https://qrflow.codes/llms-full.txt

Собственный GPT для управления моими кодами

ChatGPT › Create a GPT › Actions

Import from URL: https://qrflow.codes/api/v1/openapi.json
Authentication: API Key › Bearer › paste a Business key with the scopes you want the GPT to have.
Then the GPT can list, create, re-point and report on your codes. For a no-setup version, add the MCP connector instead (Developer mode › Plugins › https://qrflow.codes/mcp).

Что можно попросить после подключения

Claude, ChatGPT, Claude Code с подключённым MCP-сервером QRFLOW

"Make a QR code for https://example.com/fall-menu, call it Fall menu, frame caption 'Scan for menu'."
"Which of my codes got the most scans this month? Show a breakdown by country for the top one."
"Point the 'Lobby poster' code at https://example.com/events/october."
"Name the 'Business card' code's link 'hi' on my domain."
"Pause every code with 'Summer' in the label."
"Make 40 codes, one per table, going to https://example.com/order?table=1 through 40."
"Show me the PNG of the 'Front door' code."

MCP-сервер

Используйте его в Claude, ChatGPT, Cursor и Claude Code

QRFLOW — это MCP-сервер по адресу https://qrflow.codes/mcp. Подключите его один раз, войдите в систему, а затем попросите, например: «создай QR-код для страницы осеннего меню и назови его menu на моём домене», «перенаправь код на плакате в холле на новую страницу» или «сколько сканирований было у листовки на прошлой неделе по странам?». Ассистент получает доступ к тем же инструментам, что и этот API, и работает по тем же правилам; коды появляются в вашей панели управления с источником mcp.

Не разработчик? Инструкции простым языком с точными шагами для каждого ассистента приведены в статье Создание QR-кодов с помощью AI-ассистента.

Независимая оценка и проверка работоспособности каждый час от Glama; сервер также включён в каталог awesome-remote-mcp-servers и официальный MCP Registry как codes.qrflow/qrflow.

Подключение

Customize › Connectors › Add custom connector › вставьте адрес или нажмите Connect в каталоге QRFLOW. Claude откроет страницу входа QRFLOW; нажмите Allow. Доступно на всех планах.

https://qrflow.codes/mcp

Settings › Security and login › включите Developer mode, затем Settings › Plugins › + › вставьте адрес; при появлении запроса войдите в систему. Доступно на планах Plus, Pro, Team, Enterprise и Edu.

https://qrflow.codes/mcp

Выполните одну команду, затем введите /mcp, чтобы войти. Добавьте ключ Business в заголовок, чтобы пропустить вход.

claude mcp add --transport http qrflow https://qrflow.codes/mcp
# or, with a key:
claude mcp add --transport http qrflow https://qrflow.codes/mcp --header "Authorization: Bearer $QRFLOW_KEY"

Cursor, Windsurf, VS Code и любой MCP-клиент

Добавьте HTTP-сервер по URL. Войдите через браузер с помощью OAuth или передайте ключ в заголовке Authorization.

{
  "mcpServers": {
    "qrflow": { "type": "http", "url": "https://qrflow.codes/mcp" }
  }
}

Собственный агент (Anthropic или OpenAI SDK)

Укажите URL для MCP-коннектора или инструмента и передайте ключ Business как bearer; вход через браузер не требуется.

// Anthropic Messages API, MCP connector
mcp_servers: [{ type: "url", url: "https://qrflow.codes/mcp", name: "qrflow", authorization_token: process.env.QRFLOW_KEY }]

Что умеет ассистент

ИнструментНазначениеОбласть доступа
list_code_kindsВсе типы кодов, их поля и необходимые планы. Перед созданием необычного кода ассистент вызывает этот инструмент.profile
list_domainsДомены ссылок, домен по умолчанию и их id.domains:read
get_qr_imagePNG, который ассистент может показать или сохранить, а также URL SVG для печати.codes:read
get_accountПлан аккаунта, функции и ограничения.profile

Как обеспечивается безопасность

  • Ассистент получает только токен для вашего аккаунта, выданный после того, как вы нажали Allow на странице QRFLOW. Отключить его можно в любой момент на странице Account › Connected apps.
  • Токены привязаны к MCP-серверу; их нельзя повторно использовать для REST API.
  • Все операции записи проходят те же проверки, что и в панели управления: разрешённые адреса назначения, проверка плана и ограничения добросовестного использования.
  • Деструктивные инструменты содержат чёткие инструкции: delete_qr_code указывает модели предпочитать приостановку, если код уже напечатан.
  • Документы обнаружения доступны по адресам /.well-known/oauth-authorization-server и /.well-known/oauth-protected-resource; регистрация соответствует RFC 7591; поддерживается только PKCE S256.

SDK и спецификация OpenAPI

  • TypeScript / JavaScript: npm install qrflow (npm). Без зависимостей, ESM и CommonJS, полная типизация; работает в Node 18+, Bun, Deno и Workers. Автоматически повторяет запросы при ответах 429 и включает verifyWebhook / parseWebhook.
  • Python 3.9+, только стандартная библиотека: qrflow.py.
  • OpenAPI 3.1: /api/v1/openapi.json. Импортируйте в Postman или Insomnia, сгенерируйте клиент на любом языке или подключите к ChatGPT Action.
  • Оба клиента выбрасывают типизированную ошибку (QRFlowError с status, code, message, retryAfter) и включают средство проверки вебхуков. Исходный код TypeScript в одном файле по-прежнему доступен в /sdk/qrflow.ts, если вы предпочитаете включить его в свой проект.
TypeScriptPythonВызовы
me()me()GET /me
catalog()catalog()GET /catalog
listCodes({ limit, q })list_codes(limit, q)GET /codes
getCode(id)get_code(id)GET /codes/:id
createCode(input)create_code(**fields)POST /codes
updateCode(id, patch)update_code(id, **patch)PATCH /codes/:id
deleteCode(id)delete_code(id)DELETE /codes/:id
makeDynamic(id)make_dynamic(id)POST /codes/:id/dynamic
scans(id, { from, to, group })scans(id, from_, to, group)GET /codes/:id/scans
bulkCreate(rows, colors)bulk_create(rows, **colors)POST /codes/bulk
domains()domains()GET /domains
listWebhooks() / createWebhook() / testWebhook(id) / deleteWebhook(id)list_webhooks() / create_webhook() / test_webhook(id) / delete_webhook(id)/webhooks
imageUrl(id, size)image_url(id, size)Адрес изображения (получите его с помощью ключа)
verifyWebhook(raw, header, secret)verify_webhook(raw, header, secret)Проверка подписи доставок

Справочник конечных точек

Базовый URL https://qrflow.codes/api/v1. Тела запросов и ответы — JSON. Даты указаны в формате ISO 8601 в UTC. При PATCH отправляйте только изменяемые поля.

GETprofile

Тарифный план, флаги функций и лимиты для этой учётной записи, а также области действия ключа.

curl https://qrflow.codes/api/v1/me \
  -H "Authorization: Bearer $QRFLOW_KEY"
{ "id": "…", "email": "ops@example.com", "plan": "business", "paid": true,
  "features": { "dynamic_codes": true, "custom_domain": true, "link_names": true, "gs1": true, "api_keys": true },
  "limits": { "saved_codes": 25000, "bulk_per_month": 10000, "bulk_per_request": 2000, "link_domains": 5, "requests_per_minute": 600 },
  "auth": "api_key", "scopes": ["codes:read", "codes:write"] }

GETpublic

Встроенные типы (url, wifi, vcard, email, phone, sms, text, location) и около 50 подтипов (Instagram, Google review, Wi-Fi, магазин приложений…), каждый со своими полями и необходимым тарифным планом. Ключ не нужен.

curl https://qrflow.codes/api/v1/catalog

GETcodes:read

Сначала новые.?limit= — до 100,?q= выполняет поиск по меткам.

curl "https://qrflow.codes/api/v1/codes?limit=20&q=menu" \
  -H "Authorization: Bearer $QRFLOW_KEY"

POSTcodes:write

Действуют те же правила, что и при сохранении на сайте: коды url, phone, email, sms и location являются динамическими на платных тарифах; коды Wi-Fi, vCard и text содержат данные в шаблоне. Укажите идентификатор подтипа в destination_data.subtype, чтобы создать, например, код Google review. Необязательный domain_id задаёт, какой из ваших доменов ссылок будет указан в коде (список доступен через GET /domains).

curl -X POST https://qrflow.codes/api/v1/codes \
  -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "url", "destination_data": { "url": "https://example.com/menu" }, "label": "Table tents", "frame_style": "caption-below", "frame_caption": "Scan for menu" }'
{ "code": { "id": "…", "label": "Table tents", "kind": "url", "dynamic": true, "short_code": "x7k2p9a",
  "short_url": "https://go.example.com/x7k2p9a", "scans": 0, "image_url": "https://qrflow.codes/api/v1/codes/…/image.svg", … } }

GETcodes:read

Код с количеством сканирований, короткой ссылкой и адресом изображения.

curl https://qrflow.codes/api/v1/codes/$ID \
  -H "Authorization: Bearer $QRFLOW_KEY"

PATCHcodes:write

Можно указать любое из полей: destination_data (только для динамических кодов, печатный код остаётся действительным), label, paused, expires_at (ISO или null), slug (имя ссылки на вашем домене), domain_id (домен ссылок, который будет указан в этом коде; null = домен учётной записи по умолчанию), fg_color, bg_color, frame_style, frame_caption, frame_caption2. Отправляйте только изменяемые поля.

curl -X PATCH https://qrflow.codes/api/v1/codes/$ID \
  -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "destination_data": { "url": "https://example.com/menu-fall" }, "slug": "menu" }'

DELETEcodes:write

Удаляется навсегда вместе с историей сканирований. Печатная ссылка динамического кода перестаёт работать. Если код уже напечатан, лучше использовать paused: true.

curl -X DELETE https://qrflow.codes/api/v1/codes/$ID \
  -H "Authorization: Bearer $QRFLOW_KEY"
204 No Content

POSTcodes:write

Печатный шаблон изменится (теперь он будет кодировать короткую ссылку), поэтому после этого заново создайте изображение.

curl -X POST https://qrflow.codes/api/v1/codes/$ID/dynamic \
  -H "Authorization: Bearer $QRFLOW_KEY"

GETcodes:read

Готовый к печати SVG с рамкой и цветами.?size= задаёт ширину сетки модулей в px; файл в любом случае масштабируется без потери качества.

curl https://qrflow.codes/api/v1/codes/$ID/image.svg \
  -H "Authorization: Bearer $QRFLOW_KEY" -o code.svg

GETanalytics:read

?from= и?to= (даты ISO, до 92 дней; по умолчанию — последние 30 дней) и?group= day, device, country, city, browser, os или referrer. Те же показатели, что и на странице аналитики.

curl "https://qrflow.codes/api/v1/codes/$ID/scans?from=2026-09-01&to=2026-09-21&group=day" \
  -H "Authorization: Bearer $QRFLOW_KEY"
{ "code_id": "…", "from": "…", "to": "…", "group": "day", "total": 412,
  "rows": [ { "key": "2026-09-01", "scans": 18 }, { "key": "2026-09-02", "scans": 25 }, … ] }

POSTcodes:write

До 2,000 URL-кодов за один вызов; все они будут динамическими. Учитываются в том же месячном лимите массового создания, что и на странице Bulk (10,000 на Business). Строки, не являющиеся веб-адресами, возвращаются в rejected; остальные создаются.

curl -X POST https://qrflow.codes/api/v1/codes/bulk \
  -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rows": [ { "destination": "https://example.com/t/1", "label": "Table 1" }, { "destination": "https://example.com/t/2", "label": "Table 2" } ] }'
{ "codes": [ … ], "rejected": [], "remaining_this_month": 9998 }

GETcodes:read

Коды для розничной упаковки. Для каждого товара указываются один GTIN, адрес, напечатанный на упаковке, и ссылки за ним. Ищите по названиям и GTIN с помощью?q=. Тариф Business.

curl https://qrflow.codes/api/v1/products \
  -H "Authorization: Bearer $QRFLOW_KEY"
{ "products": [ { "gtin": "00860001234565", "name": "Wildflower Honey 12 oz",
    "digital_link": "https://id.example.com/01/00860001234565",
    "page_url": "https://id.example.com/p/00860001234565",
    "links": [ { "link_type": "gs1:pip", "url": "…", "is_default": true, "batch": null } ] } ] }

POSTcodes:write

Обязательны gtin и name; brand и url необязательны. Контрольная цифра проверяется до записи, а форматы длиной 8, 12, 13 и 14 цифр приводятся к 14 цифрам. Если GTIN уже есть в вашей учётной записи, возвращается 409 вместо создания второго товара.

curl -X POST https://qrflow.codes/api/v1/products \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{"gtin":"00860001234565","name":"Wildflower Honey 12 oz","brand":"Sunny Acres","url":"https://sunnyacres.example/honey"}'
{ "product": { "gtin": "00860001234565", "digital_link": "https://id.example.com/01/00860001234565", … } }

PUTcodes:write

Один GTIN может вести сразу в несколько мест, каждое из которых помечено назначением. По умолчанию используется телефон; приложение, запрашивающее тип, получает соответствующую ссылку. Идемпотентность: повторный запрос с теми же link_type и batch заменяет эту ссылку, а не добавляет вторую, поэтому ночной скрипт можно запускать дважды. Передайте batch, чтобы привязать ссылку к одной партии: так можно опубликовать отзыв, не затрагивая остальные партии.

curl -X PUT https://qrflow.codes/api/v1/products/00860001234565/links \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{"link_type":"gs1:recallStatus","url":"https://sunnyacres.example/recall-a42","title":"Recall notice","batch":"A42","is_default":true}'

GETanalytics:read

Количество сканирований для каждого GTIN за последние?days= (от 1 до 365, по умолчанию 30), с разбивкой по стране, устройству, типу ссылки и партии. went_nowhere считает сканирования, для которых не нашлось назначения; значение должно быть равно нулю.

curl "https://qrflow.codes/api/v1/products/00860001234565/scans?days=30" \
  -H "Authorization: Bearer $QRFLOW_KEY"
{ "gtin": "00860001234565", "days": 30, "total": 412, "went_nowhere": 0,
  "by_link_type": [ { "key": "gs1:pip", "scans": 390 }, { "key": "gs1:recallStatus", "scans": 22 } ],
  "by_batch": [ { "key": "A42", "scans": 22 } ] }

GETdomains:read

Подключённые домены, их статус и домен, который по умолчанию указывается в динамических кодах (default_base). Передайте идентификатор домена в domain_id кода, чтобы указать для этого кода другой домен.

curl https://qrflow.codes/api/v1/domains \
  -H "Authorization: Bearer $QRFLOW_KEY"

GETwebhooks:manage

Ваши вебхуки, их события, последний статус и количество сбоев.

curl https://qrflow.codes/api/v1/webhooks \
  -H "Authorization: Bearer $QRFLOW_KEY"

POSTwebhooks:manage

url должен использовать https и быть доступен на публичном хосте; events может содержать scan, code.created, code.updated, code.deleted. Секрет подписи возвращается только один раз.

curl -X POST https://qrflow.codes/api/v1/webhooks \
  -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/hooks/qrflow", "events": ["scan", "code.updated"] }'
{ "webhook": { "id": "…", "url": "…", "events": ["scan", "code.updated"], "active": true, "secret": "whsec_…" } }

POSTwebhooks:manage

Немедленно отправляет подписанный тестовый запрос и сообщает ответ.

curl -X POST https://qrflow.codes/api/v1/webhooks/$WEBHOOK_ID \
  -H "Authorization: Bearer $QRFLOW_KEY"

DELETEwebhooks:manage

Останавливает все доставки, включая запланированные повторы.

curl -X DELETE https://qrflow.codes/api/v1/webhooks/$WEBHOOK_ID \
  -H "Authorization: Bearer $QRFLOW_KEY"
204 No Content

GETpublic

Идентификаторы рамок и необходимые для каждой из них данные (подпись, вторая строка), сгруппированные как в настройщике. Ключ не нужен.

curl https://qrflow.codes/api/v1/frames

Объект Code

Все конечные точки, работающие с кодом, возвращают объект одной и той же структуры. Неизвестные поля можно игнорировать; со временем добавляются новые.

ПолеТипЗначение
iduuidСтабильный идентификатор. Используйте его во всех остальных вызовах.
labelstring | nullНазвание в панели управления. До 120 символов. Поиск доступен через?q=.
kindstringИдентификатор из каталога: url, wifi, instagram, googlereview,... kind_label — название для пользователя.
typestringФормат кодирования: url, text, wifi, vcard, email, phone, sms, location.
destination_dataobjectПереданные вами поля (плюс subtype для видов). destination — краткое описание в одну строку.
dynamicbooleanTrue, если сканирования проходят через QRFLOW и назначение можно менять. dynamic_capable показывает, может ли этот тип быть динамическим на платном тарифе.
short_codestringСемь символов, не меняется.
short_urlstringЧто печатать для динамического кода. Включает ваш домен и slug, если он задан.
domain_iduuid | nullДомен ссылок, указанный в этом коде; null означает домен учётной записи по умолчанию.
fg_color, bg_colorhexЦвет модулей и фона.
has_logobooleanЛоготип добавлен в панели управления; image.svg включает его.
frame_style, frame_caption, frame_caption2string | nullИдентификатор рамки и подписи, как в настройщике.
scansintegerОбщее количество сканирований за всё время.
created_at, updated_atISO 8601UTC.
manage_urlurlСтраница кода в панели управления, для ссылки «Открыть в QRFLOW».
image_urlurlGET /codes/:id/image.svg. Требуется заголовок Authorization; это не публичный URL изображения.
svg_download_url, png_download_urlurlТот же SVG (рамка, цвета, логотип) и обычный PNG по подписанным ссылкам, действующим 24 часа без заголовка: для тегов <img>, скриптов и помощников, сохраняющих файл. download_expires_at указывает время истечения; при каждом чтении кода возвращаются новые ссылки.

Другие структуры: Scans (code_id, from, to, group, total, rows[key, scans]), Domain (id, host, status, active, is_default, verified_at, grace_until), Webhook (id, url, events, active, last_status, last_delivery_at, consecutive_failures, плюс secret один раз), Me (id, email, plan, paid, features, limits, auth, scopes) и Error (error, message). В документе OpenAPI типизировано каждое свойство.

Business

Вебхуки

QRFLOW вызывает ваш URL с протоколом https при возникновении события. Создайте вебхук на странице Account › Webhooks или с помощью POST /webhooks; секрет подписи будет показан только один раз. До 10 вебхуков на учётную запись.

СобытиеКогдаdata
scanПакетная отправка: каждые несколько минут, все новые сканирования с момента последней доставки, до 500 за вызов.count, from, to, scans[] с code_id, label, short_code, slug, scanned_at, device, country, city, referrer, browser, os, language
code.createdСразу для API и помощников; в течение нескольких минут для панели управления. Массовый запрос отправляет одно событие с bulk: true и codes[].code, source
code.updatedСроки те же. Включает изменения назначения, метки, паузы, срока действия, имени ссылки, домена, цветов, рамки и преобразование в динамический код.code, changed[] (имена изменённых полей)
code.deletedСроки те же.code: { id, label, short_code, slug }
pingПри нажатии Test.webhook_id, message

Что приходит

Каждая полезная нагрузка — { id, event, created_at, data }. id остаётся неизменным при повторах одной доставки, поэтому по нему можно удалять дубликаты.

{
  "id": "9b1c6d2e-…",
  "event": "scan",
  "created_at": "2026-09-21T18:05:00.000Z",
  "data": {
    "count": 2,
    "from": "2026-09-21T18:00:00.000Z",
    "to": "2026-09-21T18:04:12.331Z",
    "scans": [
      { "code_id": "…", "label": "Table tents", "short_code": "x7k2p9a", "slug": "menu", "scanned_at": "2026-09-21T18:03:40.101Z",
        "device": "mobile", "country": "US", "city": "Las Vegas", "referrer": null, "browser": "Safari", "os": "iOS", "language": "en-US" },
      { "code_id": "…", "label": "Table tents", "short_code": "x7k2p9a", "slug": "menu", "scanned_at": "2026-09-21T18:04:12.331Z",
        "device": "mobile", "country": "MX", "city": "Tijuana", "referrer": null, "browser": "Chrome", "os": "Android", "language": "es-MX" }
    ]
  }
}
{
  "id": "2f0a…",
  "event": "code.updated",
  "created_at": "2026-09-21T18:06:00.000Z",
  "data": {
    "code": { "id": "…", "label": "Table tents", "kind": "url", "dynamic": true, "short_url": "https://go.example.com/menu", "scans": 412, "…": "…" },
    "changed": ["destination_data"]
  }
}
POST /your/endpoint HTTP/1.1
Content-Type: application/json
User-Agent: QRFLOW-Webhooks/1.0 (+https://qrflow.codes/developers)
X-QRFLOW-Event: scan
X-QRFLOW-Signature: t=1758477900,v1=5f1c…e9

Проверка подписи

X-QRFLOW-Signature: t=<unix seconds>,v1=<hex>. Вычислите HMAC-SHA256 для ${t}.${rawBody} с помощью секрета и сравните с v1 за постоянное время; отклоните запрос, если t старше пяти минут. Используйте исходные полученные байты, а не повторно сериализованный объект. Примеры работающих обработчиков для Next.js и Python приведены в рецептах; оба SDK включают вспомогательную функцию.

Правила доставки

  • Ответьте любым кодом 2xx в течение 8 секунд. Выполняйте работу после отправки ответа.
  • При любом другом ответе повторные попытки выполняются через 1, 5, 15, 60, 240 и 720 минут.
  • После двадцати последовательных сбоев вебхук отключается, а владельцу учётной записи отправляется письмо. Включите его снова после исправления обработчика; запланированные повторы возобновятся.
  • URL должны использовать https и быть доступны на публичном хосте. localhost, частные диапазоны и сам qrflow.codes не принимаются. Во время разработки используйте туннель.
  • Нажмите Test, чтобы получить подписанный ping и увидеть статус, возвращённый вашим сервером.

Ошибки

Каждая ошибка — { "error": "<code>", "message": "<what to do>" } с указанным ниже статусом. Сообщение предназначено для пользователя; покажите его.

СтатусerrorЗначение

Симптом, причина, решение

Устранение неполадок

401 invalid_token при каждом вызове

ПричинаЗаголовок указан неверно или ключ не активен.

РешениеУкажите точно Authorization: Bearer qrf_live_… (с пробелом, а не двоеточием). Убедитесь, что ключ не отозван на странице Account › API keys. Если вы скопировали его из чата или документа, проверьте, нет ли в конце точки или типографской кавычки.

401 на /api/v1 с токеном, который работает на MCP-сервере

ПричинаТокены, выпущенные для https://qrflow.codes/mcp, привязаны к нему.

РешениеДля REST используйте API-ключ или выполните второй поток OAuth без resource=, чтобы получить токен для REST API.

402 upgrade_required при создании ключа или вебхука

ПричинаОбе функции доступны только на тарифе Business.

РешениеПерейдите на тариф выше на /pricing или используйте MCP-сервер, который работает на любом тарифе после входа.

402 на POST /codes из приложения OAuth

ПричинаТарифный план пользователя не включает запрошенную приложением функцию (динамический код, домен).

РешениеСначала прочитайте GET /me features и адаптируйте поведение: всё равно создайте код (на Free он будет статическим) или сообщите пользователю, какой тарифный план необходим.

403 insufficient_scope

ПричинаОбласти действия фиксируются при создании ключа. ИсправлениеСоздайте новый ключ с нужными вам областями доступа и отзовите старый. Для OAuth запрашивайте область доступа в запросе авторизации.

400 not_dynamic при PATCH destination_data

ПричинаКод статический: это код типа Wi-Fi/vCard/текст или код, созданный на бесплатном тарифе после того, как уже был использован единственный бесплатный динамический код.

ИсправлениеДля url/phone/email/sms/location выполните POST /codes/:id/dynamic, пока в аккаунте есть доступная квота, затем скачайте и распечатайте код заново (изображение изменится). Коды Wi-Fi, vCard и текстовые коды не могут быть динамическими; вместо этого создайте код типа url, который открывает страницу.

400 no_domain при задании slug

ПричинаИмена ссылок размещаются на вашем домене.

ИсправлениеСначала подключите и подтвердите домен на странице Account. На qrflow.codes/q путь всегда соответствует short_code.

409 conflict для slug

ПричинаУ другого вашего кода уже есть такое имя.

ИсправлениеВыполните GET /codes?q=, чтобы найти его, или выберите другое имя. Имена уникальны в пределах аккаунта, а не глобально.

Ошибка CORS в консоли браузера

ПричинаAPI принимает только запросы от сервера к серверу (и от Canva). Это сделано намеренно: ключ на веб-странице — это утекший ключ.

ИсправлениеПеренесите вызов в обработчик маршрута, серверное действие, edge-функцию или бэкенд и вызывайте его оттуда со страницы.

На изображении есть отметка QRFLOW

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

ИсправлениеЛюбой аккаунт убирает её, в том числе бесплатный. Изображения сохранённых кодов никогда не содержат эту отметку.

short_url по-прежнему содержит qrflow.codes/q/… после добавления домена

ПричинаДомен ещё не подтверждён или для него задан неправильный CNAME.

ИсправлениеПроверьте статус на странице Account или выполните GET /domains (статус должен быть verified). После подтверждения существующие коды переключатся автоматически.

image_url возвращает 401 в теге <img>

ПричинаДля него нужен заголовок Authorization, который <img> не может отправить.

ИсправлениеИспользуйте svg_download_url или png_download_url из того же объекта Code: это подписанные ссылки, которые работают 24 часа без заголовка. Если нужна постоянная ссылка, проксируйте image_url через свой сервер (см. рецепт для Next.js) или закодируйте short_url самостоятельно.

Мне нужен PNG, а не SVG

ПричинаВ SVG есть рамка и логотип; PNG содержит только сам код.

ИсправлениеGET /codes/:id/image.png (с bearer или подписанным png_download_url) возвращает PNG размером от 256 до 2048 px. Чтобы получить PNG с рамкой, преобразуйте SVG с помощью sharp или resvg (sharp(svgBuffer).png().toBuffer()).

Ассистент сообщил, что endpoint изображения отказал, и нарисовал код самостоятельно

ПричинаОн запросил image_url, для которого нужен bearer.

ИсправлениеТеперь каждый код содержит png_download_url и svg_download_url, а get_qr_image возвращает их; ассистент может выполнить curl по этим ссылкам без входа в систему. Код, нарисованный локально и содержащий тот же short_url, по-прежнему работает и учитывает сканирования, но в нём нет рамки и логотипа.

Вебхук не приходит

ПричинаПравила для URL или принимающий сервер.

ИсправлениеURL должен использовать https и указывать на общедоступный хост (не localhost, не частный IP-адрес и не qrflow.codes). Нажмите Test для вебхука: в результате отображается статус, который вернул ваш сервер. События сканирования отправляются пакетами, поэтому доставка может занять около пяти минут; события code.* из панели управления тоже ставятся в очередь на несколько минут, а записи через API и MCP доставляются сразу.

Подпись не проходит проверку

ПричинаВы подписали повторно сериализованное тело запроса.

ИсправлениеПроверяйте подпись по точным исходным байтам, которые получили, до разбора JSON. В Express используйте express.raw({ type: 'application/json' }) для этого маршрута; в Next.js App Router используйте await req.text(); во Flask — request.get_data(). Затем вычислите HMAC-SHA256 для ${t}.${raw}\.

Вебхук отключился сам

ПричинаДвадцать последовательных сбоев.

ИсправлениеИсправьте принимающий сервер, затем снова включите вебхук (Account › Webhooks или удалите его и создайте заново). При отключении вам отправили письмо. Повторные попытки из очереди возобновятся.

Повторные доставки вебхуков

ПричинаМедленный ответ 2xx (дольше 8 секунд) считается сбоем, и запрос отправляется повторно.

ИсправлениеСначала отправьте ответ, а обработку выполните позже. Удаляйте дубликаты по id в полезной нагрузке: он не меняется при повторных попытках.

429 rate_limited при импорте

Причина600 запросов в минуту на ключ.

ИсправлениеИспользуйте POST /codes/bulk (2,000 кодов в одном запросе) вместо отдельного POST для каждого кода или подождите указанное в Retry-After количество секунд.

Я удалил код, и теперь на распечатанном плакате отображается «Code not found»

ПричинаУдаление необратимо и отключает ссылку.

ИсправлениеОтменить удаление нельзя. В следующий раз используйте PATCH { paused: true }; для приостановленного кода отображается понятная страница, а его можно возобновить.

Мой ключ перестал работать после перехода на тариф ниже

ПричинаКлючи продолжают работать 30 дней после перехода с Business, а затем возвращают 402.

ИсправлениеВозобновите подписку; ничего не удалено, и те же ключи снова заработают.

Не нашли нужного ответа? Напишите на hello@qrflow.codes, указав точный запрос и полученную ошибку JSON. Аккаунты Business обслуживаются в приоритетном порядке.

Ограничения и добросовестное использование

Ограничение
Запросов в минуту на ключ600. При превышении возвращается 429 с Retry-After.
Ключей на аккаунт10
Вебхуков на аккаунт10
Сохранённых кодов (добросовестное использование)1,000 на Premium, 25,000 на Business; API останавливает работу при достижении двойного лимита.
Массовая обработка500/месяц (500 за запрос) на Premium; 10,000/месяц (2,000 за запрос) на Business.
Домены ссылок1 на Premium, 5 на Business
СканированияБез ограничений. При 100,000 сканирований одного кода в месяц на Premium и 1,000,000 на Business отправляется контрольное письмо; ограничение скорости не применяется.
Период аналитики сканирований92 дня на запрос
Размер страницы списка100 (?limit=)
Метка / подписи / slug120 / 60 / 40 символов
Тайм-аут и повторы вебхуков8 секунд; повторы через 1, 5, 15, 60, 240 и 720 минут; отключение после 20 последовательных сбоев.
После перехода с BusinessКлючи и вебхуки продолжают работать 30 дней, затем возвращается 402. Ничего не удаляется.

Тариф рассчитан на добросовестное использование. При достижении лимита ограничение скорости не применяется; API останавливает работу при достижении двойного лимита, а сначала вам напишет сотрудник. Для больших объёмов: hello@qrflow.codes.

Безопасность для вас и тех, кто сканирует коды

Как QRFLOW защищает ваш аккаунт

  • Ключи показываются один раз и хранятся в виде хешей SHA-256. Никто в QRFLOW не может прочитать ключ; если вы его потеряли, создайте новый.
  • Каждый запрос ограничен аккаунтом, которому принадлежит ключ. При запросе id кода из другого аккаунта возвращается 404, данные никогда не раскрываются.
  • Области доступа фиксируются для каждого ключа, поэтому ключ для панели отчётности не может создавать или удалять коды.
  • 600 запросов в минуту на ключ; при превышении возвращается 429, а не замедляется работа для всех.
  • Адреса назначения проверяются по списку разрешённых: http, https, mailto, tel, sms, geo и короткий список схем приложений (whatsapp, tg, signal, spotify, магазины приложений). javascript:, data: и file: отклоняются при создании, поэтому скомпрометированная интеграция не сможет превратить ваши коды в средство атаки.
  • URL вебхуков должны использовать https и указывать на общедоступные хосты; QRFLOW никогда не обращается к частным сетям или к самому себе. Каждая доставка подписана, и у каждой полезной нагрузки есть стабильный id.
  • OAuth-клиенты регистрируются с PKCE S256, а токены привязаны к серверу, для которого они были выданы; токен для MCP-сервера нельзя повторно использовать в REST API.
  • Любой пользователь может отозвать ключ или отключить приложение на странице Account; изменения вступают в силу немедленно.

Что нужно сделать с вашей стороны

  • Используйте переменные окружения, а не исходный код. Если ключ попал в историю git, отзовите его.
  • Только на стороне сервера. API отклоняет запросы из браузера, но ваши собственные конечные точки, которые его оборачивают, тоже должны требовать аутентификацию, иначе кто угодно сможет создавать коды за ваш счёт.
  • Создайте для каждой интеграции отдельный ключ с нужными ей областями доступа и укажите в названии интеграцию. Тогда отзыв ключа затронет только одну интеграцию.
  • Проверяйте подписи вебхуков и отклоняйте временные метки старше пяти минут.
  • Если данные пользователей попадают в метки или адреса назначения, помните, что QRFLOW их хранит; по возможности не включайте персональные данные в метки.

Какие данные записываются при сканировании, а какие — нет

  • При каждом перенаправлении сохраняются тип устройства, страна, город, источник перехода, браузер, операционная система и язык, определённые по запросу, а также односторонний хеш кода + дня + IP-адреса + user agent, чтобы владелец мог подсчитывать уникальных посетителей. По хешу нельзя восстановить адрес.
  • Для сканирующего пользователя не устанавливаются cookies, а сам IP-адрес не сохраняется вместе со сканированием. Известные боты и краулеры предпросмотра ссылок пропускаются.
  • При удалении кода удаляются связанные с ним сканирования. При удалении аккаунта удаляется всё.
  • Полный текст: https://qrflow.codes/privacy и https://qrflow.codes/terms.

Версионирование и стабильность

Версия API указана в пути: /api/v1. В рамках v1 мы добавляем поля, конечные точки, типы и события; ничего не удаляем и не переименовываем, а неизвестные поля в ответах следует игнорировать в коде.

Если когда-либо потребуется несовместимое изменение v1, оно выйдет как /api/v2, а v1 будет работать ещё как минимум двенадцать месяцев. Владельцев ключей уведомят об устаревании за 90 дней.

Для инструментов MCP-сервера действует то же правило: добавляются только аргументы, а имена инструментов не меняются.

Документ OpenAPI по адресу /api/v1/openapi.json и Markdown по адресу /llms-full.txt генерируются из кода, обслуживающего API, поэтому они описывают текущую версию.

Вопросы разработчиков

Нужно ли платить за использование API QRFLOW?

Ключи API доступны в тарифе Business за $29 в месяц с помесячной оплатой. MCP-сервер (Claude, ChatGPT, Cursor, Claude Code) и OAuth для вашего приложения работают на любом тарифе после входа в систему, а доступные им возможности создания кодов зависят от тарифа. Для GET /catalog, GET /frames и /preview.svg ключ не нужен.

Можно ли бесплатно создавать QR-коды через API?

Нет, если использовать ключ. Для обычного статического изображения подойдёт бесплатный генератор на qrflow.codes или любая библиотека QR-кодов с открытым исходным кодом. API предназначен для динамических кодов, собственного домена, аналитики, массовой обработки и вебхуков — эти возможности доступны в платном аккаунте.

Можно ли вызывать API из браузера?

Нет. Запросы из браузера отклоняются, чтобы ключ не оказался на веб-странице. Вызывайте API из обработчика маршрута, серверного действия, edge-функции или бэкенда, а со страницы обращайтесь к нему.

Какие форматы изображений доступны?

SVG с вашими цветами, рамкой, подписями и логотипом (GET /codes/:id/image.svg, номинальный размер от 256 до 4096 px) и обычный PNG (GET /codes/:id/image.png, от 256 до 2048 px). Для обоих форматов нужен bearer либо подписанный svg_download_url / png_download_url, который есть в каждом объекте Code и работает 24 часа без заголовка. Инструмент MCP get_qr_image возвращает PNG прямо в ответе и обе ссылки.

Можно ли изменить QR-код после печати?

Да, если он динамический (url, phone, email, sms, location на платном тарифе). Выполните PATCH /codes/:id с новым destination_data; изображение не изменится, но при следующем сканировании пользователь попадёт по новому адресу. Коды Wi-Fi, vCard и текстовые коды содержат данные в изображении, поэтому изменить их нельзя.

Чем short_url отличается от адреса назначения?

short_url — это ссылка внутри изображения (go.example.com/menu). Адрес назначения — место, куда перенаправляет эта ссылка (https://example.com/menu-fall). short_url можно напечатать один раз, а адрес назначения менять сколько угодно раз.

Можно ли использовать собственный домен для кодов?

Да. На Premium можно подключить 1 домен, на Business — 5; добавьте CNAME и подтвердите домен на странице Account. В Business домен для каждого кода выбирается с помощью domain_id. Имена ссылок (slug) создают на нём понятные пути.

Какие данные о сканирующем пользователе записываются?

Тип устройства, страна, город, источник перехода, браузер, операционная система и язык из запроса, а также односторонний ежедневный хеш для подсчёта уникальных посетителей. Cookies не используются, IP-адрес не сохраняется. Этого достаточно для графика, но недостаточно для идентификации человека. Подробнее: https://qrflow.codes/privacy#scans

Есть ли пакет для npm или PyPI?

npm: npm install qrflow\ (https://www.npmjs.com/package/qrflow), без зависимостей, ESM и CommonJS, полные типы TypeScript, работает в Node 18+, Bun, Deno и Workers; оборачивает все конечные точки, повторяет запросы при 429 и включает verifyWebhook/parseWebhook. Python: клиент в одном файле на https://qrflow.codes/sdk/qrflow.py (только стандартная библиотека) с verify_webhook; пакет PyPI появится позже.

Работает ли это с Claude, ChatGPT, Cursor и Claude Code?

Да. QRFLOW — это MCP-сервер по адресу https://qrflow.codes/mcp. Добавьте его как коннектор, один раз войдите в систему и задавайте вопросы обычными словами. Одиннадцать инструментов позволяют создавать, редактировать, приостанавливать и называть коды, выполнять массовую обработку, просматривать аналитику, изображения и домены.

Могут ли мои пользователи подключать свои аккаунты QRFLOW к моему приложению?

Да, с OAuth 2.0. Зарегистрируйте клиента на /api/oauth/register (учётная запись не нужна), перенаправьте пользователей на /oauth/authorize с PKCE и вызывайте API с их токеном. Коды появляются в их учётной записи в соответствии с их тарифом.

Как тестировать вебхуки на localhost?

Откройте доступ к серверу разработки через туннель (cloudflared или ngrok) и используйте его https-адрес в качестве URL вебхука, затем нажмите Test в разделе Account › Webhooks, чтобы получить подписанный ping. URL вебхуков должны быть общедоступными и использовать https; localhost и частные адреса отклоняются.

Что произойдёт с моей интеграцией, если я отменю Business?

Ключи и вебхуки продолжат работать 30 дней, затем будут возвращать 402. Коды, сканирования и домены останутся в учётной записи. Повторная подписка снова включит всё с теми же ключами.

Как создать через API код для отзыва в Google, Instagram, Wi-Fi или PDF?

GET /catalog перечисляет все типы и их поля. Затем отправьте POST /codes с типом и полями нужного типа, добавив subtype для следующих типов: { type: 'url', destination_data: { subtype: 'googlereview', placeId: 'ChIJ…' } }, { type: 'wifi', destination_data: { ssid, password, encryption: 'WPA' } }, { type: 'url', destination_data: { subtype: 'instagram', handle: 'acme' } }.

Может ли API загрузить логотип на код?

Пока нет. Добавьте логотип в панели управления; image.svg включает его, а has_logo сообщает о его наличии. Цвета, рамки и подписи можно задавать через API.

Стабилен ли API?

В v1 добавляются возможности, но ничего не удаляется и не переименовывается. Ломающие изменения будут выпущены в v2, при этом v1 будет поддерживаться не менее двенадцати месяцев, а уведомление по электронной почте будет отправлено за 90 дней.

Для агентов, инструментов и ассистентов, читающих эту страницу

Машиночитаемые материалы

Всё на этой странице доступно в формате, который может получить программное обеспечение. Всё это генерируется из кода, обслуживающего API, поэтому информация всегда актуальна.

URLОписание
llms-full.txthttps://qrflow.codes/llms-full.txtВесь этот справочник в формате Markdown: концепции, все конечные точки, все инструменты MCP, рецепты, устранение неполадок и FAQ. Создаётся из того же источника, что и эта страница.
developers.mdhttps://qrflow.codes/developers.mdТот же документ для инструментов, которые получают a.md.
llms.txthttps://qrflow.codes/llms.txtИндекс сайта для ассистентов со ссылкой на эту страницу.
API на одной страницеhttps://qrflow.codes/qr-code-apiВозможности API, случаи, когда клиентская библиотека будет лучшим решением, и стоимость. Краткая версия этого справочника — для принятия решения, а не для разработки.
openapi.jsonhttps://qrflow.codes/api/v1/openapi.jsonOpenAPI 3.1. Импортируйте в Postman, Insomnia, генератор кода или ChatGPT Action.
MCP serverhttps://qrflow.codes/mcpStreamable HTTP, OAuth с динамической регистрацией или ключ Business в качестве bearer-токена.
server.jsonhttps://qrflow.codes/.well-known/mcp/server.jsonМанифест реестра MCP.
Обнаружение OAuthhttps://qrflow.codes/.well-known/oauth-authorization-serverМетаданные RFC 8414; документ защищённого ресурса находится рядом.
Пакет npmhttps://www.npmjs.com/package/qrflownpm install qrflow. Типизированный клиент, без зависимостей, проверка вебхуков. Однофайловый клиент для Python: https://qrflow.codes/sdk/qrflow.py.
GitHubhttps://github.com/nativecodeapps/qrflow-sdkКлиенты, снимок OpenAPI и готовые к запуску примеры для вебхуков Next.js, Workers, Express, FastAPI и Flask. Будем рады issues и PR.

Вопросы, идеи или предложения по новым типам кодов: hello@qrflow.codes. Условия: /terms. Конфиденциальность: /privacy.