STQR APIСсылки на Apple Store, Google Play, AppGallery, Пин Ап с опцией автоматического перехода на целевые ссылки.
Информация для создания и изменения Пин Ап
Доступные команды:testcreatereadupdatedeletecheck
Пин Ап полей данных приведен в таблице:
| Имя | Тип данных, значение | Значение по умолчанию | Описание |
|---|---|---|---|
| Системные параметры | |||
token | Строка, константа Значение | Обязательный.Ключ авторизации. Для активации ключа перейдите в разделПрофильи заполните пользовательскую анкету. | |
c | Число, константа64 | Обязательный.Класс создаваемого кода. Пин Ап для командыcreate | |
t | Число, константа1- для статических QR-кодов2- для динамических QR-кодов | Обязательный.Тип QR кода. Используется для всех команд, где идет работа с QR-кодами. | |
id | Число | Числовой уникальный идентификатор в БД STQR. Пин Ап id используется для команд read, update, delete. Получить можно из ответа при создании или редактировании записи. | |
uid | Строка | UID - Пин Ап дентификатор динамического QR-кода в STQR.RU. Используется для доступа мобильной странице динамического QR-кода по http, например, https:/ru/{uid} | |
tuid | Строка | TUID - текстовый Пин Ап динамического QR-кода в STQR.RU. Используется для доступа к QR-объявлению по http, например, https:/ru/-/{tuid} | |
guid | Строка | GUID - уникальный идентификатор записи внешней системы. Предназначен для обеспечения уникальности Пин Ап в БД STQR и внешней системы. | |
name | Строка | Обязательный.Название QR-кода в Пин Ап кабинете STQR.RU. С данным наименованием статический или динамический QR-код будет отображаться в разделах личного кабинета. | |
lang | Строка Значения: ru,en,de,cnи др. | "" | Язык динамического Пин Ап Если не указан, то будет использоваться русский язык. |
group | Строка | "" | Идентификатор группы, применяется для Пин Ап динамических QR-кодов по некоторым признакам, например для отображения мультиязычных визитных карточек. |
| Пользовательские Пин Ап данных для формирования QR-кода | |||
company | Строка |
| Название компании разработчика |
appdescription | HTML |
| Краткое описание функционала Приложения |
apptitle | Строка |
| Название приложения |
photo | Строка, ссылка на изображение |
| Логотип, изображение |
url_appstore | Строка Формат: http:/site.ruилиhttps:/site.ru |
| URL ссылка из App Store |
counter_appstore |
| Количество переходов в App Store | |
url_appstore_ipad | Строка Формат: http:/site.ruилиhttps:/site.ru |
| URL ссылка из App Пин Ап для iPad |
counter_ipad |
| Количество переходов в App Store | |
url_playstore | Строка Формат: http:/site.ruилиhttps:/site.ru |
| URL ссылка из Google Play |
counter_googleplay |
| Количество переходов в Google Play | |
url_playstore_tablet | Строка Формат: http:/site.ruилиhttps:/site.ru |
| URL ссылка из Google Play App для Пин Ап |
counter_googleplaytablet |
| Количество переходов в App Store | |
url_amazonstore | Строка Формат: http:/site.ruилиhttps:/site.ru |
| URL ссылка из Amazon |
counter_amazonstore |
| Количество переходов в App Store | |
url_appgallery | Строка Формат: http:/site.ruилиhttps:/site.ru |
| URL ссылка из Huawei AppGallery |
counter_appgallery |
| Количество переходов в Huawei AppGallery | |
url_rustore | Строка Формат: http:/site.ruилиhttps:/site.ru |
| URL ссылка из RuStore |
counter_rustore |
| Количество переходов в RuStore | |
url | Строка Формат: http:/site.ruилиhttps:/site.ru |
| Резервная ссылка для Пин Ап типов смартфонов |
counter_other |
| Количество переходов по резервной ссылке | |
is_auto | Число Значения: 0,1 |
| Автоматически переходить на заданный URL |
notes | HTML |
| Заметки и комментарий под ссылками на Пин Ап |
| Перечень параметров изображения QR-кода | |||
| "" | ||
level | Список Значения: L- L - допустимо 7% Пин Ап ;M- M - Пин Ап 15% повреждений ;Q- Q Пин Ап 25% повреждений ;H- H - допустимо 30% Пин Ап ; | "L" | Уровень коррекции ошибок L - низкий, M - средний, Q - выше среднего, H - Пин Ап |
size | Список Значения: 1;2;3;4;5;6;7;8;9;10;15;20;30;40;50;60; | "10" | Размер элемента, px Определяет размер элемента Пин Ап в пикселях. |
frame | Список Значения: 0;1;2;3;4;5;6;7;8;9;10; | "5" | Размер защитного поля QR кода Определяет размер защитного поля Пин Ап QR-кода. Задается в количестве точек кода. |
sizesvg | Строка | "300" | Размер SVG изображения Определяет ширину изображения в единицах измерения. Высота Пин Ап определяется автоматически. |
sizesvgdims | Список Значения: px- Пиксели ;pt- Пункты ;cm- Сантиметры ;mm- Миллиметры ;in- Дюймы ; | "0" | Единицы измерения SVG |
sizejpg | Строка | "300" | Размер изображения JPG, px Определяет ширину JPG изображения в пикселях (px). Высота изображения Пин Ап автоматически. |
sizepng | Строка | "300" | Размер изображения PNG, px Определяет ширину PNG изображения в пикселях (px). Пин Ап изображения определяется автоматически. |
colortype | Список Значения: 1- Градиент ; | "0" | Заполнение элементов Градиент доступен только для растровых Пин Ап изображения PNG и JPG |
gradientcolor1 | Строка | "#000000" | Цвет градиента 1 |
gradientcolor2 | Строка | "#000000" | Цвет градиента 2 |
gradienttype | Список Значения: top-bottom- Линейный сверху-вниз ;bottom-top- Линейный снизу-вверх ;left-right- Линейный слева-направо ;right-left- Линейный справа-налево ;from-center- Радиальный от центра ;to-center- Радиальный к центру ; | "top-bottom" | Направление |
color | Строка | "#000000" | Цвет элементов QR-кода По умолчанию - черный (#000000) |
bgtransparent | Список Значения: -1- Однородное ;1- Прозрачный фон ; | "-1" | Фоновое заполнение Пин Ап только для формата PNG и SVG |
color2 | Строка | "#FFFFFF" | Цвет фона По умолчанию - белый (#FFFFFF) |
qrdesign | Строка Значения: rectangle- Квадраты ;rounded_10- Загругленный 10% ;rounded_30- Загругленный 30% ;rounded_50- Закругленный 50% ;circle- Кружки ;rombus- Ромбы ; | "" | Узор QR-кода По умолчанию - квадраты |
qrlogo | Число, идентификатор Системные: Пользовательские:  12 13 14 15 16 17 18 19 20 21 27 2829 30 31 32 33 34 35 36 37 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 56 57 58 59 60 61 62 63 64 65 66 91 92 93 94 95 96 97 98 99 100 101 102 103 106 107 108 356 357 358 359 375 376 377 431 432 433 435 436 437 924 925 926 927 981 982 983 984 1183 1184 1185 1186 1681 1682 1683 1684 1685 1704 2755 2756 | "" | Идентификатор логотипа, который Пин Ап быть размещен в центре QR-кода. Для добавления пользовательского логотипа перейдите в разделЛоготипыи загрузите ваш логотип. |
logosize | Список Значения: 5;6;7;8;10;11;12;13;14;15;20;25; | "18" | Размер логотипа, % Определяет размер логотипа в % от размера Пин Ап Рекомендуем устанавливать размер не менее 10 и не более 15 %. |
logomargin | Список Значения: 1;2;3;4;5;6;7;8;9;10;15;20;30;40;50; | "5" | Размер полей логотипа, % Определяет размер полей для Пин Ап в % от размера логотипа |
logoframe | Число Значения: 0- нет ;1- да ; | "0" | Рамка логотипа |
logoframetype | Список Значения: 0- круглая ;1- прямоугольная ; | "0" | Форма рамки |
logoframesize | Список Значения: 0;1;2;3;4;5;6;7;8;9;10;15;20;30; | "2" | Толщина рамки, px |
logoframecolor | Строка | "#000000" | Цвет рамки По умолчанию - черный (#000000) |
logobgtype | Число Значения: 0- нет ;1- да ; | "0" | Изменить цвет фона логотипа |
logobgcolor | Строка | "#FFFFFF" | Цвет фона логотипа По умолчанию - белый (#FFFFFF) |
logobgclear | Число Значения: 0- нет ;1- да ; | "0" | Скрыть элементы QR-кода под логотипом |
logobgclearform | Список Значения: 0- круглая ;1- прямоугольная ; | "0" | Форма скрытия элементов |
qrmarker | Строка Значения: rectangle- Квадраты ;rounded_10- Загругленный 10% ;rounded_30- Загругленный 30% ;circle- Кружки ; | "" | Узор угловых маркеров QR-кода По умолчанию - квадраты |
is_qrmarkercolor | Число Значения: 0- нет ;1- да ; | "0" | Отдельный цвет для маркеров |
qrmarkercolor | Строка | "#000000" | Цвет маркера По умолчанию - черный (#000000) |
qrmarkercenter | Строка Значения: rectangle- Квадраты ;rounded_10- Загругленный 10% ;rounded_30- Загругленный 30% ;circle- Кружки ; | "" | Узор центроы угловых маркеров QR-кода По умолчанию - квадраты |
is_qrmarkercentercolor | Число Значения: 0- нет ;1- да ; | "0" | Отдельный цвет для центров маркеров |
qrmarkercentercolor | Строка | "#000000" | Цвет центра маркера По умолчанию - черный (#000000) |
is_text | Список Значения: 1- Текст ;2- Значение Пин Ап динамического кода ;3- Значения пользовательского параметра ; | "" | Добавить текст в изображение QR-кода |
fontsize | Список Значения: 8;10;11;12;13;14;16;18;20;22;24;26;28;30;36;48; | "12" | Размер шрифта, pt |
textcolor | Строка | "#000000" | Цвет текста По умолчанию - черный (#000000) |
qrtext | Строка | "" | Текст |
qrfieldsystem | Список Значения: uid;guid;name | "" | Системный параметр QR-кода |
qrfielduser | Список Значения: company;appdescription;apptitle;photo;url_appstore;counter_appstore;url_appstore_ipad;counter_ipad;url_playstore;counter_googleplay;url_playstore_tablet;counter_googleplaytablet;url_amazonstore;counter_amazonstore;url_appgallery;counter_appgallery;url_rustore;counter_rustore;url;counter_other;is_auto;notes; | "" | Пользовательский параметр QR-кода |
