QRTIGER API:n Dokumentaatio

Mukautettu QR-koodien API:mme tarjoaa ammattimaisen ratkaisun brändeille, jotka tarvitsevat mukautettuja QR-koodipohjia tietojen seurantajärjestelmällä, dynaamisilla QR-koodeilla tai QR-koodijoukoilla sekä CRM:ään integroituja QR-koodeja.

Sovellusliittymämme (API) on saatavilla 'Mashape'-palvelussa. Jos sinulla on kysyttävää tähän liittyen, voit siirtyä 'ota yhteyttä'-välilehdelle. Sovellusliittymäämme voidaan käyttää maailmanlaajuisesti, mutta jos tarvitset QR-koodejasi Kiinan alueella, ota meihin yhteyttä. Voimme myös luoda mukautettuja QR-koodeja mobiilimaksuja varten.

qrId:
example 1
example 2
example 3
example 4
example 5

Dokumentointi

Tutustu tähän käyttöä opastavaan YouTube-videoon

Luo QR-koodi

1.

Kirjaudu ensin sisään ja hanki sitten API-avain valtuutusta varten Tietojen Seuranta --> Tiliasetukset --> API-avain

2.

Add this API key in every req (GET/POST) as Authorization: Bearer API-avain

3. Luo mukautettu Muuttumaton QR-koodi
URL-osoite/api/qr/static
MenetelmätPOST
ValtuutusBearer API KEY
VastausBinary Image File (PNG, SVG)
Pyydä parametri
qrCategorystringurlqrCategory määrittää erityyppiset QR-koodit, kuten URL, Vcard, Facebook ja muut vastaavat. Tutustu alla olevaan qrCategory-taulukkoon.
textStringhttps://qrcode-tiger.comValitsemasi uudelleenohjautuva URL-osoite upotetaan QR-koodiin
sizenumber500QR-koodin koko
logourlnullLisää minkä tahansa logon URL-osoite, jotta logo voidaan ottaa käyttöön QR-koodin keskellä
colorDarkstring#5e0bf0QR-koodin kuvioiden väri
backgroundColorString#ffffffQR-koodin taustaväri. (Huomautus: Käytä aina kirkasta väriä täysin skannattaville QR-koodeille)
gradientBooleanfalseAseta arvoksi ”tosi” ottaaksesi käyttöön gradienttivärin
grdTypeNumber0 (Left-to-Right)Tarkista alla olevasta taulukosta grdType
color01String#5e0bf0Gradienttiväri yhdestä QR-koodin kuvioista
color02String#f30505Gradienttiväri kahdesta QR-koodin kuvioista
eye_colorBooleanfalseAseta arvoksi ”tosi” muuttaaksesi silmien väriä
eye_color01String#5e0bf0Ulommaisen silmän väri
eye_color02String#f30505Sisemmän silmän väri
eye_outerStringeyeOuter0Ulommaisen silmän erilaisia muotoiluja. Tarkista alla näkyvästä taulukosta kaikki muotoilumallit
eye_innerStringeyeInner0Erilaisia muotoiluja sisemmälle silmälle. Tarkista alla olevasta taulukosta kaikki muotoilumallit
qrDataStringpattern0QR-tietomallien erityyppiset muotoilut, tutustu kaikkiin malleihin alla näkyvästä taulukosta
qrFormatStringpngLataa binäärikuva tiedostotyypissä ”png” tai ”svg”
transparentBkgBooleanfalseJos tämä on käytössä, QR-koodilla tulee olemaan läpinäkyvä tausta
frameNumbernullJos tämä on käytössä, QR-koodilla tulee olemaan kehykset. Alla olevasta taulukosta löydät vaihtoehdot kehyksille
frameColorStringnullKehyksen väri määrittää kehyksen tekstin värin
frameTextStringSCAN MEKehyksen teksti, joka näkyy QR-koodin kehyksen päällä
Esimerkki
URL-osoite/api/qr/static
MenetelmätPOST
Parametri
{
  "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"
}
Vastaus
example 5
{
  "data": "base 64 QR image data",
  "url": "1601477992984.png"
}
4. Hanki lista kaikkien QR-luokkien QR-kampanjoista
URL-osoite/api/campaign/
MenetelmätGET
ValtuutusBearer API KEY
VastausJSON object of QR list
GET /campaign/?page=1&limit=5&sort=1
Kyselyparametrit
ParametriOletusKuvaus
page1sivunumero
limit5kampanjoiden määrä sivua kohden
sort1Lajittele Päivämäärän(1) tai Nimen(2) mukaan
categoryurlmäärittele luokkia erityyppisille QR-koodeille, kuten URL, Vcard, Facebook ja vastaavat. Tutustu alla näkyvään qrCategory-taulukkoon.
Esimerkki
URL-osoite/api/campaign/?page=1&limit=5&sort=1&category=url
MenetelmätGET
Parametri
{
  "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"
}
Vastaus
{
  "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. Luo mukautettu Dynaaminen ja Visuaalinen QR-koodi
URL-osoite/api/campaign/
MenetelmätPOST
ValtuutusBearer API KEY
VastausBinary Image File (PNG, SVG)
Kyselyparametrit
ParametriTyyppiOletusKuvaus
qrUrlStringhttps://qrcode-tiger.comValitsemasi uudelleenohjautuva URL-osoite upotetaan QR-koodiin
qrTypeStringqr2qrType määrittää QR-koodin toiminnallisuutta, kuten vaihtoehdon joko yhden uudelleenohjauksen tai usean uudelleenohjauksen URL-osoitteen käyttämiseksi (”qr2” tai ”murl”)
qrCategoryStringurlqrCategory määrittää erityyppiset QR-koodit, kuten URL, Vcard, Facebook ja muut vastaavat. Tutustu alla olevaan qrCategory-taulukkoon.
qr:JSON ObjectMukauta QR-koodisi väriä, tietokuvioita, silmiä ja muita ominaisuuksia tässä objektissa
sizeNumber500QR-koodin koko
logoString (url)nullLisää minkä tahansa logon URL-osoite, jotta logo voidaan ottaa käyttöön QR-koodin keskellä
colorDarkString#5e0bf0QR-koodin kuvioiden väri
backgroundColorString#ffffffQR-koodin taustaväri. (Huomautus: Käytä aina kirkasta väriä täysin skannattaville QR-koodeille)
gradientBooleanfalseAseta arvoksi ”tosi” ottaaksesi käyttöön gradienttivärin
grdTypeNumber0 (Left-to-Right)Tarkista alla olevasta taulukosta grdType
color01String#5e0bf0Gradienttiväri yhdestä QR-koodin kuvioista
color02String#f30505Gradienttiväri kahdesta QR-koodin kuvioista
eye_colorBooleanfalseAseta arvoksi ”tosi” muuttaaksesi silmien väriä
eye_color01String#5e0bf0Ulommaisen silmän väri
eye_color02String#f30505Sisemmän silmän väri
eye_outerStringeyeOuter0Ulommaisen silmän erilaisia muotoiluja. Tarkista alla näkyvästä taulukosta kaikki muotoilumallit
eye_innerStringeyeInner0Erilaisia muotoiluja sisemmälle silmälle. Tarkista alla olevasta taulukosta kaikki muotoilumallit
qrDataStringpattern0QR-tietomallien erityyppiset muotoilut, tutustu kaikkiin malleihin alla näkyvästä taulukosta
qrFormatStringpngLataa binäärikuva tiedostotyypissä ”png” tai ”svg”
transparentBkgBooleanfalseJos tämä on käytössä, QR-koodilla tulee olemaan läpinäkyvä tausta
frameNumbernullJos tämä on käytössä, QR-koodilla tulee olemaan kehykset. Alla olevasta taulukosta löydät vaihtoehdot kehyksille
frameColorStringnullKehyksen väri määrittää kehyksen tekstin värin
frameTextStringSCAN MEKehyksen teksti, joka näkyy QR-koodin kehyksen päällä
Esimerkki
URL-osoite/api/campaign
MenetelmätPOST
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
example 5
grdType (Default 0)
ParametriTyyppiArvoKuvaus
Vasen - OikeaStringlinearGradienttivirtaus vasemmalta oikealle
Ylin - AlinStringupDownGradientti virtaus Ylhäältä Alas
NW - SEStringdiagonal1Gradientti virtaus Vinottain Alaspäin
SW - NEStringdiagonal2Gradientti virtaus Vinottain Ylöspäin
SäteittäinenStringradialGradientti virtaus Säteittäisesti
eye_outer (Default 0)
ParametriTyyppiArvoKuvaus
eye_outerStringeyeOuter0
eyeOuter1
eyeOuter2
eyeOuter3
eyeOuter4
eyeOuter5
eyeOuter6
eyeOuter7
eyeOuter8
eyeOuter9
eye_inner
ParametriTyyppiArvoKuvaus
eye_innerStringeyeInner0
eyeInner1
eyeInner2
eyeInner3
eyeInner4
eyeInner5
eyeInner6
eyeInner7
eyeInner8
eyeInner9
QrData
ParametriTyyppiArvoKuvaus
qrDataStringpattern0
pattern1
pattern2
pattern3
pattern4
pattern5
pattern6
pattern7
pattern8
pattern9
pattern10
pattern11
Frame (Default : null)
ParametriTyyppiArvoKuvaus
frameNumber1
2
3
5. Seuraa QR-koodisi tietoja, kuten Skannausten Määrää, Käyttömaata, Käyttökaupunkia ja Laitetyyppiä
URL-osoite/data/qrid?period=month&tz=Asia/Singapore
MenetelmätGET
ValtuutusBearer API KEY
VastausJSON object of track data
Pyydä parametri
ParametriTyyppiKuvaus
qrIdparamsQR-koodin uniikki id-tunnus
periodquery
”päivä” (Vallitsevan päivän tiedot)
”viikko” (Vallitsevan viikon tiedot)
”kuukausi” (Vallitsevan kuukauden tiedot)
”kuukaudet” (Vallitsevan vuoden tiedot)
”vuosi” (Vuosittaiset tiedot)
tzqueryOletus Aasia/Singapore
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. Lataa logosi
URL-osoite/accounts/uploads/
MenetelmätPOST
Content-Typemultipart/form-data
Form-FieldFile
ResponseImage file url {“qrUrl”: 1526460566643.png}