Быстрый старт с QR Code API
QR Code Genius API позволяет генерировать QR-коды программно: полностью стилизованные PNG-изображения, массовые пакеты с отслеживанием сканирований и лёгкие изображения, которые можно встраивать прямо в веб-страницу или письмо.
Создание API-ключа
- Войдите в аккаунт и откройте панель разработчика.
- Нажмите Создать API-ключ и задайте ключу имя.
- Сразу скопируйте ключ — он показывается только один раз. На наших серверах хранится только защищённый хеш, поэтому утерянный ключ придётся отозвать и заменить новым.
Ключи выглядят так:
qrc_9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c...
Базовый URL
https://www.qrcodegenius.com/api/v1
Первый запрос
Передайте ключ в заголовке Authorization и отправьте POST-запрос с содержимым, которое нужно закодировать:
curl -X POST https://www.qrcodegenius.com/api/v1/qr \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "data": "https://example.com", "width": 512, "height": 512 }'
Ответ содержит QR-код в виде base64 PNG data URL, а также данные о текущем использовании:
{
"success": true,
"data": "data:image/png;base64,iVBORw0KGgo...",
"meta": { "usage_count": 1, "remaining": 49, "strategy": "monthly" }
}
Эндпоинты
- POST /qr — генерирует один полностью стилизованный QR-код. См. Генерация QR-кода.
- POST /qr/bulk — генерирует до 100 QR-кодов за один вызов и сохраняет их в вашем аккаунте, при желании — как динамические коды с отслеживанием (план Pro). См. Массовая генерация QR-кодов.
- GET /render — быстрый кешируемый PNG, который можно использовать прямо в теге
img. См. Встраивание QR-изображения.
Планы и лимиты
- Free: 50 API-запросов в месяц.
- Pro: 1 000 API-запросов в месяц, а также доступ к массовой генерации.
- Купленные кредиты используются автоматически после исчерпания месячного лимита.
Подробнее о квотах и обработке ошибок см. в статье Ошибки и ограничения запросов.
Никогда не раскрывайте API-ключ в клиентском коде (в браузерах или мобильных приложениях). Вызывайте API со своего бэкенд-сервера, чтобы защитить учётные данные. Единственное исключение — эндпоинт render, предназначенный для встраивания изображений; о его компромиссах читайте в соответствующей документации.
Была ли эта статья полезной?
Ваш отзыв помогает нам улучшить документацию.