API для QR-кодов: динамические коды и аналитика программно
Те же примитивы, что и в кабинете: динамические коды, смена адреса, журнал сканирований, доступные вашему софту на тарифе Business.
Каждый динамический код QRmkr построен на двух простых примитивах: постоянное короткое перенаправление, которым вы управляете, и журнал, который записывает каждое сканирование. Доступ к API на тарифе Business открывает эти примитивы вашим системам, чтобы софт мог работать с динамическими QR-кодами: создавать их, менять адреса и читать аналитику сканирований, без человека, который щёлкает в кабинете. Данные сканирований уже сегодня доступны в CSV через один эндпоинт с авторизацией, он описан ниже.
Что вы получаете
Динамические коды из вашего стека
Доступ к API на тарифе Business покрывает программную работу с динамическими кодами: создание кода и смену адреса, на который ведёт его постоянное перенаправление, то же самое, что делает кабинет.
Получение аналитики сканирований
Каждое сканирование пишет время, класс устройства, ОС, браузер и приблизительное местоположение. Полный журнал кода можно выгрузить в CSV через эндпоинт с авторизацией и загрузить в хранилище или BI-систему.
Простая стандартная авторизация
Запросы авторизуются токеном сессии вашего аккаунта: это JWT на 30 дней, который выдаётся при входе и передаётся как HTTP-only cookie. Обычные HTTPS-запросы, SDK не нужен.
Как это работает
- 1
Перейдите на Business: доступ к API включён вместе с 5 местами в команде и своим доменом для коротких ссылок.
- 2
Авторизуйтесь: войдите в аккаунт, получите токен сессии, то есть JWT на 30 дней, и отправляйте его в cookie qrm_session.
- 3
Забирайте данные: получайте журнал сканирований любого кода в CSV через эндпоинт выгрузки и автоматизируйте процесс вокруг него.
Частые вопросы
Что умеет API QRmkr для QR-кодов?
Доступ к API это возможность тарифа Business, которая покрывает программную работу с динамическими QR-кодами: создание кодов, смену адреса назначения и получение аналитики сканирований. Выгрузка аналитики, описанная на этой странице, работает уже сегодня. После подключения Business напишите на support@qrmkr.io, и мы поможем настроить интеграцию.
Как работает авторизация в API?
Через токен сессии вашего аккаунта. При входе выдаётся JWT, действующий 30 дней, в виде HTTP-only cookie с именем qrm_session. Отправляйте этот cookie с запросами из своей интеграции. Держите токен в секрете, он даёт полный доступ к аккаунту, и всегда обращайтесь к API по HTTPS.
Что содержит выгрузка аналитики сканирований?
Одна строка CSV на каждое сканирование: время, класс устройства, операционная система, браузер, страна, город и referer. Местоположение приблизительное, на уровне страны и города, а вместо сырых IP-адресов мы храним хеш с солью.
В какой тариф входит доступ к API?
В Business за $39 в месяц или фактически $32 в месяц при оплате за год. В него входит всё из Pro, то есть неограниченные динамические коды, смена адреса и аналитика сканирований, плюс до 5 участников команды, свой домен для коротких ссылок, доступ к API и повышенные лимиты AI-арт кодов.
Готовы встроить QR-коды в свои процессы?
Доступ к API входит в тариф Business: $39 в месяц, всё из Pro включено, отменить можно в любой момент.
Посмотреть тариф Business