Analitika

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "clicks": 142
}

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "clicks": 142
}

A GetQR API béta állapotban van, és csak kiválasztott munkaterületek számára érhető el. A részletek az általános kiadásig változhatnak.

Kérjen le beolvasási összesítéseket és lebontásokat ország, eszköz, böngésző és más szempontok szerint, egyetlen QR-kódhoz vagy a teljes munkaterülethez.

Metódus	Útvonal	Leírás
`GET`	`/api/v1/qrs/{qrId}/analytics`	Egy QR-kód analitikájának lekérése
`GET`	`/api/v1/analytics`	A munkaterület analitikájának lekérése

Ha QR-kódonként kész összefoglalóra van szüksége, lásd: Jelentések.

Mit jelentenek a számok

Beolvasások. Minden szám a clicks mezőben szerepel. Egy beolvasás akkor számít, amikor valaki megnyitja a QR-kód rövid linkjét.
Egyedi beolvasások. unique=true esetén minden látogató egyszer számít a dátumtartományon belül.
Hatókör. A számok a QR-kód rövid linkjéből származnak. Egy rövid link nélküli QR-kódnál nincs megszámolható beolvasás.
Előzmények. Az analitikai adatok nem állíthatók vissza az API-n keresztül. Egy QR-kód törlése nem törli a korábbi beolvasási adatait.

Fejlécek

string

kötelező

Bearer, majd az API-kulcsa. Lásd: Hitelesítés.

Lekérdezési paraméterek

Mindkét végpont ezeket a paramétereket fogadja. Mindegyik opcionális.

string

alapértelmezett:"count"

A lebontás dimenziója. A count az összesítést adja vissza. Az összes értéket és a válaszok felépítését lásd: Lebontások.

string

alapértelmezett:"30d"

Előre beállított dátumtartomány: 24h, 7d, 30d, 90d, 1y, mtd, qtd, ytd vagy all. Lásd: Dátumtartományok. A start megadásakor figyelmen kívül marad.

string

Egyéni tartomány kezdete, ISO 8601, például 2026-08-01 vagy 2026-08-01T00:00:00Z. Elsőbbséget élvez az interval paraméterrel szemben. Korábbinak kell lennie, mint az end.

string

Egyéni tartomány vége, ISO 8601. Alapértelmezés: a mai nap vége. A start paraméterrel vagy az interval=all értékkel együtt használatos, a többi intervallumnál figyelmen kívül marad.

string

alapértelmezett:"UTC"

IANA időzóna a timeseries időegységeinek igazításához, például America/New_York. Ismeretlen időzóna esetén 422 a válasz.

boolean

alapértelmezett:"false"

true esetén az összes beolvasás helyett az egyedi beolvasásokat számolja.

Dimenziószűrőket is küldhet.

Dátumtartományok

`interval`	Lefedett időszak	`timeseries` időegységek
`24h`	Az elmúlt 24 óra	Órák
`7d`	Az elmúlt 7 nap, a mai nappal együtt	Napok
`30d`	Az elmúlt 30 nap, a mai nappal együtt	Napok
`90d`	Az elmúlt 90 nap, a mai nappal együtt	Napok
`1y`	Az elmúlt 365 nap, a mai nappal együtt	Hónapok
`mtd`	A hónap eleje óta	Napok
`qtd`	A negyedév eleje óta	Napok
`ytd`	Az év eleje óta	Napok, 180 nap felett hónapok
`all`	A munkaterület létrehozása óta	Napok, 180 nap felett hónapok

Egyéni tartományhoz küldje el a start és opcionálisan az end paramétert. A legfeljebb 2 napos tartományok óránkénti, a 180 napnál hosszabbak havi, minden köztes tartomány napi időegységeket használ.

Dimenziószűrők

Szűkítse az eredményeket a szűrőnek megfelelő beolvasásokra. A különböző szűrők AND kapcsolatban állnak. Ha egy szűrő több értéket is elfogad, vesszővel válassza el őket: az értékek OR kapcsolatban állnak.

Szűrő	Érték	Több érték
`country`	ISO 3166-1 alpha-2 országkód, például `US`	Igen
`region`	ISO 3166-2 régiókód, például `US-CA`	Igen
`city`	Városnév, például `New York`	Igen
`continent`	`AF`, `AN`, `AS`, `EU`, `NA`, `OC` vagy `SA`	Igen
`device`	Eszköztípus, például `Mobile` vagy `Desktop`	Igen
`browser`	Böngésző neve, például `Chrome`	Igen
`os`	Operációs rendszer, például `iOS` vagy `Windows`	Igen
`url`	Cél-URL	Igen
`referer`	Hivatkozó, például `google.com`	Nem
`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`	UTM-érték, legfeljebb 190 karakter	Nem

Ismeretlen ország- vagy kontinenskód esetén 422 a válasz. Az eszköz-, böngésző- és operációsrendszer-neveket a rendszer nagy kezdőbetűvel illeszti, így a mobile ugyanúgy működik, mint a Mobile. Például az Egyesült Államokból vagy Kanadából, mobileszközökről érkező beolvasások: ?country=US,CA&device=Mobile.

Lebontások

A count egy objektumot ad vissza. Minden más érték egy tömböt, clicks szerint csökkenő sorrendben (a timeseries idő szerint rendezett).

`groupBy`	Az elemek tartalma
`count`	`clicks` (objektum, nem tömb)
`timeseries`	`start` (az időegység kezdete), `clicks`
`continents`	`continent`, `clicks`
`regions`	`region`, `country`, `clicks`
`countries`	`country`, `city` (mindig `*`), `clicks`
`cities`	`city`, `country`, `clicks`
`devices`	`device`, `clicks`
`browsers`	`browser`, `clicks`
`os`	`os`, `clicks`
`triggers`	`trigger` (`qr` vagy `link`), `clicks`
`referers`	`referer` (ismeretlen esetén `(direct)`), `clicks`
`referer_urls`	`refererUrl` (ismeretlen esetén `(direct)`), `clicks`
`top_links`	`id`, `domain`, `key`, `shortLink`, `url`, `createdAt`, `qr` (`id`, `qrType`, `title`), `clicks`
`top_urls`	`url`, `clicks`
`top_types`	`qr_type`, `clicks`
`utm_sources`, `utm_mediums`, `utm_campaigns`, `utm_terms`, `utm_contents`	Az UTM-érték (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term` vagy `utm_content`), `clicks`

Ismeretlen groupBy esetén 422 a válasz, az érvényes értékek listájával. Válasz, amikor groupBy=count:

{ "clicks": 142 }

Válasz, amikor groupBy=countries:

[
  { "country": "US", "city": "*", "clicks": 87 },
  { "country": "DE", "city": "*", "clicks": 31 },
  { "country": "GB", "city": "*", "clicks": 24 }
]

Egy QR-kód analitikájának lekérése

GET /api/v1/qrs/{qrId}/analytics Egy QR-kód beolvasási statisztikáit adja vissza, a rövid linkjére szűkítve. A fenti lekérdezési paramétereket és dimenziószűrőket fogadja.

string

kötelező

A QR-kód azonosítója. A QR-kódok listájának vagy létrehozásának válaszából veheti.

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=count&interval=30d&unique=true" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/analytics?groupBy=countries&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "clicks": 142
}

A munkaterület analitikájának lekérése

GET /api/v1/analytics A munkaterület összes QR-kódjának beolvasási statisztikáit adja vissza. A fenti lekérdezési paramétereket és dimenziószűrőket fogadja, valamint ezeket a szűkítő paramétereket.

string

A key paraméterrel együtt az eredményeket az ezzel a domainnel rendelkező rövid linkre szűkíti, például getqr.sh. A domainnek a munkaterülethez kell tartoznia.

string

A rövid link azonosítója, például x7Kd2p1. A domain paraméterrel együtt használja. Mindkettő megtalálható a QR-kód objektumban.

string

A figyelembe veendő QR-kód-típusok, vesszővel elválasztva: website, pdf, image, video, whatsapp, social, wifi, app, feedback, vcard, sms, payment, location, multilink, email vagy event. Lásd: QR-típusok.

curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=7d" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/analytics?groupBy=devices&interval=30d&qrType=website" \
  -H "Authorization: Bearer $GETQR_API_KEY"

curl "https://getqr.com/api/v1/analytics?groupBy=count&domain=getqr.sh&key=x7Kd2p1" \
  -H "Authorization: Bearer $GETQR_API_KEY"

[
  { "device": "Mobile", "clicks": 980 },
  { "device": "Desktop", "clicks": 240 }
]

Gyakori problémák

400 "QR has no associated link."

A QR-kódnak nincs rövid linkje, így nincs megszámolható beolvasás.

404-es hiba domain és key szerinti szűréskor

A munkaterületen nincs ilyen domainnel és azonosítóval rendelkező rövid link. Másolja ki a domain és a key értékét a QR-kód objektumból.

422-es hiba a groupBy, az interval vagy egy szűrő miatt

Az érték nem támogatott. A hibaüzenet megnevezi a paramétert, és felsorolja az érvényes értékeket.

A számok nem egyeznek az irányítópulttal

Ellenőrizze, hogy ugyanazt a dátumtartományt és időzónát használja-e, és hogy egyedi (unique=true) vagy összes beolvasást számol-e.

API

Mit jelentenek a számok

Fejlécek

Lekérdezési paraméterek

Dátumtartományok

Dimenziószűrők

Lebontások

Egy QR-kód analitikájának lekérése

A munkaterület analitikájának lekérése

Gyakori problémák

Következő lépések

Jelentések

QR-kódok

Analitika az alkalmazásban

Kéréskorlátok

​Mit jelentenek a számok

​Fejlécek

​Lekérdezési paraméterek

​Dátumtartományok

​Dimenziószűrők

​Lebontások

​Egy QR-kód analitikájának lekérése

​A munkaterület analitikájának lekérése

​Gyakori problémák

​Következő lépések

Jelentések

QR-kódok

Analitika az alkalmazásban

Kéréskorlátok

Mit jelentenek a számok

Fejlécek

Lekérdezési paraméterek

Dátumtartományok

Dimenziószűrők

Lebontások

Egy QR-kód analitikájának lekérése

A munkaterület analitikájának lekérése

Gyakori problémák

Következő lépések