REST API для генерации QR-кодов — интеграция в 1С, CRM, Python

Да. Бесплатный тариф QRcode.website предоставляет полный доступ к REST API без ограничений по функциональности. На бесплатном тарифе доступны все эндпоинты: создание статических и динамических QR-кодов, массовая генерация (batch до 10 QR за запрос), аналитика, управление доменами, webhook. Ограничения бесплатного тарифа только количественные: 100 запросов в минуту, 10 000 запросов в сутки, максимум 50 QR-кодов в аккаунте. Регистрация занимает 30 секунд, карта не требуется. Это даёт возможность полноценно протестировать интеграцию перед переходом на платный тариф. В отличие от многих конкурентов, мы не ограничиваем batch-функциональность на бесплатном тарифе — можно проверить всю логику массовой генерации в реальных условиях.

Один HTTP-запрос — один QR-код. Сделайте POST-запрос на /api/v1/qr-codes с заголовком Authorization: Bearer qrcw_<ваш_ключ> и телом в JSON: поле type (URL, VCARD, WIFI, TEXT, EMAIL, PHONE, EVENT и другие), поле content с содержимым (например, URL), опциональное поле dynamic: true для динамического QR, опциональное поле design с параметрами дизайна (foreground, background, logo, shape). В ответе — объект с id, short_url (для динамических), и объект downloads со ссылками на PNG, SVG и PDF. PNG можно скачать напрямую или получить в base64, добавив параметр format=base64 к URL скачивания. Полный пример curl, Python, JavaScript и PHP — в разделе документации «Быстрый старт».

Интеграция 1С с нашим API занимает 1–2 дня разработки. Основной инструмент — объект HTTPСоединение встроенного языка 1С (доступен с версии 8.3.6). Алгоритм: в обработчике события (например, ПередПечатью накладной или ПриЗаписи объекта) создаёте HTTP-соединение с нашим сервером, формируете тело запроса в JSON, выполняете POST-запрос с заголовком Authorization: Bearer qrcw_..., разбираете JSON-ответ и извлекаете URL изображения PNG из поля downloads.png. Полученный PNG можно встроить в макет печатной формы через объект ПолеКартинка. Для хранения API-ключа используйте Константу или Параметр сеанса, не хардкодьте в коде модуля. Если 1С работает в облаке с ограниченным доступом к интернету — используйте наш IP-whitelist (статический IP для исходящих запросов предоставляется по запросу на Enterprise-тарифе). Полный пример кода на встроенном языке 1С — в нашей документации.

Установите httpx или requests, добавьте API-ключ в переменную окружения (например, QRCW_API_KEY). Пример с httpx: import httpx; client = httpx.Client(headers={'Authorization': f'Bearer {api_key}'}); resp = client.post('https://app.qrcode.website/api/v1/qr-codes', json={'type': 'URL', 'content': 'https://example.com', 'dynamic': True}); data = resp.json(); png_url = data['downloads']['png']. Для скачивания самого PNG: image_bytes = httpx.get(png_url).content и сохраните через open('qr.png', 'wb').write(image_bytes). Для массовой генерации используйте /qr-codes/batch — передайте список объектов. Ответ будет содержать task_id; опрашивайте GET /tasks/:id до status == 'done', затем скачивайте ZIP по ссылке из ответа. Пример с asyncio и httpx.AsyncClient ускорит параллельную обработку больших батчей. Полный Jupyter Notebook с примерами — в нашей документации на GitHub.

По умолчанию API возвращает в ответе три URL для скачивания файлов: PNG (растровый, подходит для большинства задач), SVG (векторный, масштабируется без потери качества до любого размера — рекомендуем для типографской печати), PDF (PDF-файл с векторным QR, удобен для встраивания в документы). Все три формата доступны сразу в ответе на POST /qr-codes в объекте downloads. Также поддерживается base64-режим: добавьте параметр include_base64: true в тело запроса — ответ дополнится полем base64_png со строкой вида data:image/png;base64,.... Размер PNG настраивается параметром size (от 100 до 2000 пикселей по умолчанию 300). Коррекция ошибок контролируется параметром error_correction (L/M/Q/H, по умолчанию M — оптимальный баланс между размером модуля и надёжностью считывания).

Тарификация построена по аккаунтам, не по количеству сгенерированных QR. Бесплатный тариф: 0 рублей, 100 req/min, 10 000 req/сутки, до 50 QR-кодов. Pro: от 499 рублей в месяц, 600 req/min, без суточного лимита, до 5 000 QR-кодов, webhook, кастомный домен. Business: от 1 990 рублей в месяц, 3 000 req/min, batch до 1 000, без лимита QR-кодов, SLA 99,9%. Enterprise: индивидуально, без ограничений, выделенная инфраструктура, SLA 99,99%, интеграция с 1С под ключ, поддержка 24/7. Оплата в рублях через ЮKassa (карты РФ, СБП, ЮMoney). Сравнение тарифов с полным списком возможностей — на странице /pricing.

Да, rate limiting работает по скользящему окну в 60 секунд на уровне API-ключа. Текущие лимиты: Бесплатный — 100 req/min и 10 000 req/сутки. Pro — 600 req/min, без суточного ограничения. Business — 3 000 req/min. Enterprise — без ограничений (или кастомные лимиты по договору). Текущее состояние лимитов возвращается в заголовках каждого ответа: X-RateLimit-Limit (максимум в окне), X-RateLimit-Remaining (осталось), X-RateLimit-Reset (Unix-timestamp сброса окна). При превышении лимита API возвращает HTTP 429 Too Many Requests с заголовком Retry-After в секундах. Рекомендуем добавить обработку 429 с экспоненциальной задержкой в вашем клиенте. Batch-эндпоинт потребляет 1 единицу лимита за вызов, независимо от количества QR в батче.

Webhook — это HTTP POST-запрос от нашего сервера на ваш endpoint при наступлении события. Поддерживаемые события: qr.scanned (QR-код отсканирован), link.clicked (клик по короткой ссылке), form.submitted (отправка формы мини-сайта). Настройка: в кабинете → API → Webhooks → добавьте URL вашего endpoint (должен отвечать на POST и возвращать 2xx в течение 5 секунд) и секрет (произвольная строка). Формат тела запроса: JSON с полями event, data (зависит от типа события) и timestamp. Подпись в заголовке X-Webhook-Signature — это HMAC-SHA256 от raw-тела запроса с вашим секретом. Проверка на Python: hmac.compare_digest(expected_sig, received_sig). При неудаче (не 2xx или таймаут) повторная попытка через 1 мин, 5 мин, 30 мин, 2 часа, 24 часа. История попыток доставки видна в кабинете. Для тестирования используйте RequestBin или webhook.site — вставьте временный URL и посмотрите структуру реального события.

Да. amoCRM интегрируется через исходящие webhooks amoCRM: при смене стадии сделки amoCRM шлёт запрос на ваш сервер, который вызывает наш API и прикрепляет QR к сделке. Готовое решение — виджет в marketplace amoCRM (в разработке, ожидается Q3 2026). До выхода виджета — интеграция через Make (Integromat) или n8n: триггер amoCRM → HTTP-запрос к нашему API → обновление поля в amoCRM. Bitrix24 интегрируется аналогично через исходящие события Bitrix24 (webhook). Marketplace-приложение Bitrix24 — в роадмапе Q4 2026. Для обоих CRM работает схема через Zapier или Make без программирования: примеры в нашей документации. Для корпоративных инсталляций Bitrix24 On-Premise — прямая интеграция через REST API (наш и Bitrix24) силами разработчика, подробные примеры кода в документации.

Да, но только для динамических QR-кодов. При создании QR с флагом dynamic: true изображение кода зашивает короткую ссылку вида qrcode.website/r/abc123 — это неизменная часть. Целевой URL за этой ссылкой можно менять в любой момент: PATCH /api/v1/qr-codes/:id/destination с телом {'destination': 'https://новый-url.com'} — изменение применяется немедленно, все уже распечатанные QR начинают вести на новый адрес. Это ключевое преимущество динамических QR: печатный тираж не нужно переиздавать при смене лендинга, меню, акции или контактных данных. Дизайн самого QR-кода (изображение) также можно обновить через PATCH — но это изменит только файл в CDN, физически распечатанные коды останутся прежними и продолжат работать (они ведут на короткую ссылку, а не хранят конечный URL).

Инфраструктура QRcode.website полностью размещена на российских серверах в датацентрах на территории РФ. Персональные данные пользователей (имя, email, платёжные данные) обрабатываются и хранятся в России в соответствии с требованиями 152-ФЗ. Данные аналитики сканирований (IP-адрес усечённый, гео на уровне города, тип устройства) также хранятся на российских серверах. Мы не передаём данные третьим лицам и не используем зарубежные CDN для хранения пользовательских данных. Оплата обрабатывается через ЮKassa (российский агрегатор). Для Enterprise-клиентов доступна отдельная инсталляция с полной изоляцией данных. По запросу предоставляем DPA (соглашение об обработке данных) и заключаем договор на обработку персональных данных.

Официальные SDK в активной разработке. Ожидаемые релизы: Node.js SDK — Q3 2026, Python SDK — Q3 2026, PHP SDK — Q4 2026, Go SDK — Q1 2027. До выхода официальных SDK рекомендуем два подхода. Первый — сгенерировать клиент из нашей OpenAPI 3.1 спецификации с помощью openapi-generator-cli (поддерживает 50+ языков, включая Python, PHP, Java, Swift, Kotlin, Rust) или Speakeasy (генерирует типизированные SDK с retry-логикой и pagination). Команда: openapi-generator-cli generate -i https://app.qrcode.website/api/v1/openapi.json -g python -o ./qrcw-client. Второй — использовать обёртку на httpx/requests/axios с базовой логикой авторизации и retry — примеры есть в нашей документации на GitHub. Postman-коллекция с полным набором запросов доступна в кабинете для импорта одной кнопкой.