Документация по API QRTIGER
Наш собственный API-интерфейс qr-кода предлагает профессиональное решение для брендов, которым необходимо иметь настраиваемые шаблоны qr-кода с системой отслеживания данных, динамические qr-коды или массовые qr-коды, а также интегрировать qr-коды в свою CRM.
Наш API доступен на «Mashape». По любым другим вопросам вы всегда можете «связаться с нами». Наш API можно использовать по всему миру. Если вам нужны QR-коды, доступные в Китае, свяжитесь с нами. Мы также можем сделать индивидуальный QR-код для мобильных платежей.
qrId:
Документация
Посмотрите это видео на YouTube о том, как его использовать
Создать QR-код
1.Сначала войдите в систему и получите Ключ API авторизоваться Данные отслеживания --> Настройка учетной записи --> Ключ API
Сначала войдите в систему и получите Ключ API авторизоваться Данные отслеживания --> Настройка учетной записи --> Ключ API
2.Add this API key in every req (GET/POST) as Authorization: Bearer Ключ API
Add this API key in every req (GET/POST) as Authorization: Bearer Ключ API
3. Создать статический пользовательский QR-код
URL | /api/qr/static |
Методы | POST |
Авторизация | Bearer API KEY |
Ответ | Binary Image File (PNG, SVG) |
Параметр запроса
qrCategory | string | url | qrCategory определяет различные типы qr, такие как url, Vcard, facebook и т.д. Проверьте ниже таблицу qrCategory. |
text | String | https://qrcode-tiger.com | Ваш желаемый URL-адрес перенаправления будет встроен в QR |
size | number | 500 | Размер qr |
logo | url | null | Добавьте любой URL-адрес логотипа, чтобы включить логотип в центре QR. |
colorDark | string | #5e0bf0 | Цвет узоров qr |
backgroundColor | String | #ffffff | Цвет фона QR. (Примечание: всегда выбирайте яркий цвет для полностью сканируемого QR) |
gradient | Boolean | false | Установите значение "true", чтобы включить градиентный цвет |
grdType | Number | 0 (Left-to-Right) | Проверьте таблицу ниже для grdType |
color01 | String | #5e0bf0 | Цвет градиента 1 шаблона qr |
color02 | String | #f30505 | Цвет градиента 2 шаблонов qr |
eye_color | Boolean | false | Установите значение "true", чтобы изменить цвет глаз |
eye_color01 | String | #5e0bf0 | Цвет внешнего квадрата |
eye_color02 | String | #f30505 | Цвет внутреннего квадрата |
eye_outer | String | eyeOuter0 | Различный дизайн внешнего квадрата, см. таблицу ниже для всех шаблонов дизайна |
eye_inner | String | eyeInner0 | Различный дизайн внутреннего квадрата, см. таблицу ниже для всех шаблонов дизайна |
qrData | String | pattern0 | Различный дизайн шаблонов данных qr, проверьте таблицу ниже для всех шаблонов дизайна |
qrFormat | String | png | Загрузите двоичный файл изображения типа «png» или «svg» |
transparentBkg | Boolean | false | Если включить, фон QR кода будет прозрачным |
frame | Number | null | Если включить qr, то он будет состоять из рамки. Проверьте таблицу ниже для дизайна рамки |
frameColor | String | null | Цвет рамки изменить цвет текста рамки |
frameText | String | SCAN ME | Текст рамки отображается поверх рамки QR |
Пример
URL | /api/qr/static |
Методы | POST |
Параметр | { "size": 500, "colorDark": "rgb(5,64,128)", "logo": "scan_me.png", "eye_outer": "eyeOuter2", "eye_inner": "eyeInner1", "qrData": "pattern0", "backgroundColor": "rgb(255,255,255)", "transparentBkg": false, "qrCategory": "url", "text": "https://qrcode-tiger.com" } |
Ответ | { "data": "base 64 QR image data", "url": "1601477992984.png" } |
4. Получите список всех QR-кампаний разных категорий QR
URL | /api/campaign/ |
Методы | GET |
Авторизация | Bearer API KEY |
Ответ | JSON object of QR list |
GET /campaign/?page=1&limit=5&sort=1
Параметры запроса
Параметр | По умолчанию | Описание |
---|---|---|
page | 1 | номер страницы |
limit | 5 | кол-во кампаний на странице |
sort | 1 | Сортировать по дате(1) или названию(2) |
category | url | категория определяет другой тип qr, такой как url, Vcard, facebook и т. д. Проверьте ниже таблицу qrCategory. |
Пример
URL | /api/campaign/?page=1&limit=5&sort=1&category=url |
Методы | GET |
Параметр | { "size": 500, "colorDark": "rgb(5,64,128)", "logo": "scan_me.png", "eye_outer": "eyeOuter2", "eye_inner": "eyeInner1", "qrData": "pattern0", "backgroundColor": "rgb(255,255,255)", "transparentBkg": false, "qrCategory": "url", "text": "https://qrcode-tiger.com" } |
Ответ | { "query": { "limit": 1, "page": 1, "total": 146 }, "data": [ { "scans": 0, "_id": "5f6f373a33320a0ca52581b0", "qrId": "HNXP", "qrType": "qr2", "qrCategory": "url", "shortUrl": "https://qrcode-tiger.com/HNXP", "redirectUrl": "https://www.qrcode-tiger.com/", "murlData": [], "qrName": "Campaign HNXP", "qrImage": "HNXP.png", "createdAt": "2020-09-26T12:42:34.070Z", "updatedAt": "2020-09-26T12:42:34.070Z", "user": null, "id": "5f6f373a33320a0ca52581b0" } ] } |
5. Генерация динамического пользовательского визуального QR-кода
URL | /api/campaign/ |
Методы | POST |
Авторизация | Bearer API KEY |
Ответ | Binary Image File (PNG, SVG) |
Параметры запроса
Параметр | Тип | По умолчанию | Описание | |
---|---|---|---|---|
qrUrl | String | https://qrcode-tiger.com | Ваш желаемый URL-адрес перенаправления будет встроен в QR | |
qrType | String | qr2 | qrType определяет поведение qr, например один url-адрес перенаправления или url-адрес с несколькими перенаправлениями («qr2» или «murl») | |
qrCategory | String | url | qrCategory определяет различные типы qr, такие как url, Vcard, facebook и т.д. Проверьте ниже таблицу qrCategory. | |
qr: | JSON Object | Создайте свой qr-код, выберите цвет, шаблоны данных, квадраты и т.д. в этом объекте. | ||
size | Number | 500 | Размер qr | |
logo | String (url) | null | Добавьте любой URL-адрес логотипа, чтобы включить логотип в центре QR. | |
colorDark | String | #5e0bf0 | Цвет узоров qr | |
backgroundColor | String | #ffffff | Цвет фона QR. (Примечание: всегда выбирайте яркий цвет для полностью сканируемого QR) | |
gradient | Boolean | false | Установите значение "true", чтобы включить градиентный цвет | |
grdType | Number | 0 (Left-to-Right) | Проверьте таблицу ниже для grdType | |
color01 | String | #5e0bf0 | Цвет градиента 1 шаблона qr | |
color02 | String | #f30505 | Цвет градиента 2 шаблонов qr | |
eye_color | Boolean | false | Установите значение "true", чтобы изменить цвет глаз | |
eye_color01 | String | #5e0bf0 | Цвет внешнего квадрата | |
eye_color02 | String | #f30505 | Цвет внутреннего квадрата | |
eye_outer | String | eyeOuter0 | Различный дизайн внешнего квадрата, см. таблицу ниже для всех шаблонов дизайна | |
eye_inner | String | eyeInner0 | Различный дизайн внутреннего квадрата, см. таблицу ниже для всех шаблонов дизайна | |
qrData | String | pattern0 | Различный дизайн шаблонов данных qr, проверьте таблицу ниже для всех шаблонов дизайна | |
qrFormat | String | png | Загрузите двоичный файл изображения типа «png» или «svg» | |
transparentBkg | Boolean | false | Если включить, фон QR кода будет прозрачным | |
frame | Number | null | Если включить qr, то он будет состоять из рамки. Проверьте таблицу ниже для дизайна рамки | |
frameColor | String | null | Цвет рамки изменить цвет текста рамки | |
frameText | String | SCAN ME | Текст рамки отображается поверх рамки QR |
Пример
URL | /api/campaign |
Методы | POST |
Request Body | { "qr": { "size": 500, "colorDark": "rgb(5,64,128)", "logo": "1545827032075.png", "eye_outer": "eyeOuter2", "eye_inner": "eyeInner1", "qrData": "pattern0", "backgroundColor": "rgb(255,255,255)", "transparentBkg": false, "qrCategory": "url", "text": "https://www.qrcode-tiger.com.com/" }, "murlData": [], "qrUrl": "https://www.qrcode-tiger.com.com", "qrType": "qr2", "qrCategory": "url", "qrId": "MP72" } |
Request Body |
grdType (Default 0)
Параметр | Тип | Стоимость | Описание |
---|---|---|---|
Левый - Правый | String | linear | Градиентный поток слева направо |
Верх - Низ | String | upDown | Градиентный поток сверху вниз |
СЗ - ЮВ | String | diagonal1 | Градиентный поток по диагонали вниз |
ЮЗ – СВ | String | diagonal2 | Градиентный поток по диагонали вверх |
Радиальный | String | radial | Градиентный поток по радиусу |
eye_outer (Default 0)
Параметр | Тип | Стоимость | Описание |
---|---|---|---|
eye_outer | String | eyeOuter0 | |
eyeOuter1 | |||
eyeOuter2 | |||
eyeOuter3 | |||
eyeOuter4 | |||
eyeOuter5 | |||
eyeOuter6 | |||
eyeOuter7 | |||
eyeOuter8 | |||
eyeOuter9 |
eye_inner
Параметр | Тип | Стоимость | Описание |
---|---|---|---|
eye_inner | String | eyeInner0 | |
eyeInner1 | |||
eyeInner2 | |||
eyeInner3 | |||
eyeInner4 | |||
eyeInner5 | |||
eyeInner6 | |||
eyeInner7 | |||
eyeInner8 | |||
eyeInner9 |
QrData
Параметр | Тип | Стоимость | Описание |
---|---|---|---|
qrData | String | pattern0 | |
pattern1 | |||
pattern2 | |||
pattern3 | |||
pattern4 | |||
pattern5 | |||
pattern6 | |||
pattern7 | |||
pattern8 | |||
pattern9 | |||
pattern10 | |||
pattern11 |
Frame (Default : null)
Параметр | Тип | Стоимость | Описание |
---|---|---|---|
frame | Number | 1 | |
2 | |||
3 |
5. Отслеживайте свои QR-данные, количество сканирований, страну, город, тип устройства
URL | /data/qrid?period=month&tz=Asia/Singapore |
Методы | GET |
Авторизация | Bearer API KEY |
Ответ | JSON object of track data |
Параметр запроса
Параметр | Тип | Описание |
---|---|---|
qrId | params | Уникальный id qr |
period | query | «день» (данные текущего дня) «week» (данные текущей недели) «month» (данные текущего месяца) «месяцы» (данные текущего года) "год" (данные за год) |
tz | query | По умолчанию Азия/Сингапур |
Response | { "data": { "campaign": { "scanLoop": false, "bulk": false, "scans": 5, "scanCounter": 0, "_id": "5f297b7b88c80a7e70afbbc5", "qrId": "BXFO", "qrType": "qr2", "qrCategory": "url", "shortUrl": "https://qrcode-tiger.com/BXFO", "redirectUrl": "http://hello.com.vn", "murlData": [], "qrName": "Campaign BXFO", "qrImage": "BXFO.png", "owner": "5a84402c08004f37a2b87831", "scanData": [], "createdAt": "2020-08-04T15:15:07.057Z", "updatedAt": "2020-08-29T00:39:47.416Z", "__v": 0, "user": null, "id": "5f297b7b88c80a7e70afbbc5" }, "city": [ { "_id": { "city": "New York" }, "count": 3 }, { "_id": { "city": "Ho Chi Minh City" }, "count": 2 } ], "data": [ { "_id": { "device": "iOS", "loc": "VN", "city": "Ho Chi Minh City" }, "count": 1 }, { "_id": { "device": null, "loc": "NY", "city": "New York" }, "count": 3 }, { "_id": { "device": null, "loc": "VN", "city": "Ho Chi Minh City" }, "count": 1 } ], "country": [ { "_id": { "loc": "VN" }, "count": 2 }, { "_id": { "loc": "NY" }, "count": 3 } ], "device": [ { "_id": { "device": "Android" }, "count": 4 }, { "_id": { "device": "iOS" }, "count": 1 } ], "scans": 5, "unique": { "label": [ { "month": "Aug", "year": 2020 } ], "scans": [ 2 ] }, "graph": { "label": [ { "month": "Aug", "year": 2020 } ], "scans": [ 5 ] } } } |
6. Загрузите свой логотип
URL | /accounts/uploads/ |
Методы | POST |
Content-Type | multipart/form-data |
Form-Field | File |
Response | Image file url {“qrUrl”: 1526460566643.png} |