STQR APIОбъект туризма
Пин Ап для создания и изменения QR-кодов
Динамический QR-код для объекта туризма с информацией об объекте, его расположении, фотографиях и дополнительной информацией на русском, английском и казахском языках
Доступные команды:testcreatereadupdatedeletecheck
Перечень полей данных Пин Ап в таблице:
| Имя | Тип данных, значение | Значение по умолчанию | Описание |
|---|---|---|---|
| Системные параметры | |||
token | Строка, константа Значение | Обязательный.Ключ авторизации. Для активации ключа Пин Ап в разделПрофильи заполните пользовательскую анкету. | |
c | Число, константа57 | Обязательный.Класс создаваемого кода. Пин Ап для командыcreate | |
t | Число, константа1- для статических QR-кодов2- для динамических 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и др. | "" | Язык динамического QR-кода. Если не указан, то будет Пин Ап русский язык. |
group | Строка | "" | Идентификатор группы, Пин Ап для группировки динамических QR-кодов по некоторым признакам, например для отображения мультиязычных визитных карточек. |
| Пин Ап поля данных для формирования QR-кода | |||
title | Строка |
| Заголовок, наименование объекта (RU) |
description | HTML |
| Описание объекта (RU) |
tags | Строка |
| Тэги объекта (RU) |
author | Строка |
| Автор текста (RU) |
address | Строка |
| Адрес, расположение (RU) |
title_kz | Строка |
| Заголовок, наименование объекта (KZ) |
description_kz | HTML |
| Описание объекта (KZ) |
tags_kz | Строка |
| Тэги объекта (KZ) |
author_kz | Строка |
| Автор текста (KZ) |
address_kz | Строка |
| Адрес, расположение (KZ) |
title_en | Строка |
| Заголовок, наименование объекта (EN) |
description_en | HTML |
| Описание объекта (EN) |
tags_en | Строка |
| Тэги объекта (EN) |
author_en | Строка |
| Автор текста (EN) |
address_en | Строка |
| Адрес, расположение (EN) |
|
| ||
photo | Строка, ссылка на изображение |
| Фотография #1 |
photo2 | Строка, ссылка на изображение |
| Фотография #2 |
photo3 | Строка, ссылка на изображение |
| Фотография #3 |
scheme | Строка, ссылка на изображение |
| Схема маршрута |
|
| ||
latlongmet | Координаты |
| Координаты |
mapzoom | Строка |
| Масштаб карты |
latlongcenter | Строка |
| Центр карты |
|
| ||
source | Строка |
| Первоисточник |
| Перечень параметров изображения 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 | Число, идентификатор Системные: Пользовательские: 121314151617181920212728293031323334353637394041424344454647484950515253545657585960616263646566919293949596979899100101102103106107108356357358359375376377431432433435436437924925926927981982983984118311841185118616811682168316841685170427552756 | "" | Идентификатор логотипа, который может Пин Ап размещен в центре QR-кода. Для добавления пользовательского логотипа перейдите в разделЛоготипыи загрузите ваш логотип. |
logosize | Список Значения: 5;6;7;8;10;11;12;13;14;15;20;25; | "18" | Размер логотипа, % Определяет размер логотипа в % от Пин Ап QR-кода. Рекомендуем устанавливать размер не менее 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 | Список Значения: title;description;tags;author;address;h3;title_kz;description_kz;tags_kz;author_kz;address_kz;h3;title_en;description_en;tags_en;author_en;address_en;;h3;photo;photo2;photo3;scheme;;h3;latlongmet;mapzoom;latlongcenter;;source; | "" | Пользовательский параметр QR-кода |

