Raporlar

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "period": "weekly",
    "format": "json",
    "timezone": "America/New_York"
  }'

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "all", "period": "monthly", "format": "pdf", "locale": "de" }' \
  --output report.pdf

{
  "periodStart": "2026-08-10",
  "periodEnd": "2026-08-17",
  "qrs": [
    {
      "qrId": "clw3n7t1x0002ab0d5mqe8pkr",
      "name": "Landing page",
      "type": "website",
      "totalScans": 128,
      "uniqueScans": 96,
      "topGeography": "US",
      "topDevice": "Mobile",
      "topOs": "iOS",
      "topBrowser": "Safari"
    }
  ]
}

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "period": "weekly",
    "format": "json",
    "timezone": "America/New_York"
  }'

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "all", "period": "monthly", "format": "pdf", "locale": "de" }' \
  --output report.pdf

{
  "periodStart": "2026-08-10",
  "periodEnd": "2026-08-17",
  "qrs": [
    {
      "qrId": "clw3n7t1x0002ab0d5mqe8pkr",
      "name": "Landing page",
      "type": "website",
      "totalScans": 128,
      "uniqueScans": 96,
      "topGeography": "US",
      "topDevice": "Mobile",
      "topOs": "iOS",
      "topBrowser": "Safari"
    }
  ]
}

GetQR API’si beta aşamasındadır ve seçili çalışma alanlarında kullanılabilir. Ayrıntılar genel sürümden önce değişebilir.

Raporlar, tamamlanmış bir gün, hafta veya ay için QR kodu başına taramaları özetler. Hemen bir rapor dışa aktarın veya düzenli olarak e-postayla gönderilen bir rapor zamanlayın.

Yöntem	Yol	Açıklama
`POST`	`/api/v1/reports`	Rapor dışa aktarma
`GET`	`/api/v1/reports/schedules`	Zamanlanmış raporları listeleme
`POST`	`/api/v1/reports/schedules`	Rapor zamanlama
`PATCH`	`/api/v1/reports/schedules/{id}`	Zamanlanmış raporu güncelleme
`DELETE`	`/api/v1/reports/schedules/{id}`	Zamanlanmış raporu silme

Başlıklar

string

gerekli

Bearer ve ardından API anahtarınız. Bkz. Kimlik doğrulama.

string

application/json. POST ve PATCH isteklerinde zorunludur.

Kapsam

Tek seferlik ve zamanlanmış raporların ikisi de bir scope alır:

`scope`	Kapsadığı	`qrIds`
`all`	Çalışma alanınızdaki QR kodları	Göndermeyin
`selected`	Seçilmiş bir QR kodu kümesi	Bir veya daha fazla kimlik
`single`	Tam olarak bir QR kodu	Tam olarak bir kimlik

Bir rapor en fazla 50 QR kodunu listeler. all ile bunlar en son oluşturulan aktif QR kodlarıdır; duraklatılmış kodlar dahil edilmez. selected ve single ile duraklatılmış kodlar dahil edilir. Kısa bağlantısı olmayan QR kodlarının taraması yoktur ve atlanır.

Dönem

Dönem her zaman son tamamlanmış dönemdir; bu nedenle bir rapor hiçbir zaman bugünün kısmi verilerini içermez. Dönemin sınırları, raporun saat dilimindeki gece yarısıdır.

`period` veya `frequency`	Kapsadığı
`daily`	Önceki gün
`weekly`	Önceki hafta, pazartesiden pazara
`monthly`	Önceki takvim ayı

Rapor dışa aktarma

POST /api/v1/reports Son tamamlanmış dönem için bir rapor oluşturur ve yanıtta döndürür.

string

gerekli

all, selected veya single. Bkz. Kapsam.

string

gerekli

daily, weekly veya monthly. Bkz. Dönem.

string

gerekli

json, raporu yanıt gövdesinde döndürür. csv ve pdf bir dosya indirmesi döndürür.

string[]

Kapsanacak QR kodları. selected (bir veya daha fazla kimlik) ve single (tam olarak bir kimlik) için zorunludur. all için göndermeyin.

string

varsayılan:"UTC"

Dönem sınırlarının hizalandığı IANA saat dilimi; örneğin America/New_York. Bilinmeyen bir saat dilimi 422 döndürür.

string

varsayılan:"en"

PDF’in dili; örneğin en veya de. Desteklenmeyen bir değer İngilizceye döner. csv ve json tarafından yok sayılır.

string

PDF’te gösterilen başlık; en fazla 40 karakter. csv ve json tarafından yok sayılır.

JSON yanıtı

string

Dönemin ilk günü, YYYY-MM-DD.

string

Dönemden sonraki ilk gün, YYYY-MM-DD. Dönem bu günün başındaki gece yarısında sona erer.

object[]

QR kodu başına bir kayıt.

Göster properties

string

QR kodunun kimliği.

string

QR kodunun başlığı veya Untitled QR.

string

QR kodu türü; örneğin website.

integer

Dönemdeki toplam taramalar.

integer

Dönemdeki benzersiz taramalar.

string

En çok taramanın geldiği ülke kodu; tarama yoksa —.

string

En çok taramanın geldiği cihaz veya —.

string

En çok taramanın geldiği işletim sistemi veya —.

string

En çok taramanın geldiği tarayıcı veya —.

CSV ve PDF yanıtları

Gövde dosyanın kendisidir. Content-Disposition, dosyayı döneme göre adlandırır; örneğin report-2026-08-10_2026-08-17.csv. CSV’de QR kodu başına bir satır ve QR ID, QR name, QR type, Total scans, Unique scans, Top geography, Top device, Top OS ve Top browser sütunları bulunur.

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "period": "weekly",
    "format": "json",
    "timezone": "America/New_York"
  }'

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "all", "period": "monthly", "format": "pdf", "locale": "de" }' \
  --output report.pdf

{
  "periodStart": "2026-08-10",
  "periodEnd": "2026-08-17",
  "qrs": [
    {
      "qrId": "clw3n7t1x0002ab0d5mqe8pkr",
      "name": "Landing page",
      "type": "website",
      "totalScans": 128,
      "uniqueScans": 96,
      "topGeography": "US",
      "topDevice": "Mobile",
      "topOs": "iOS",
      "topBrowser": "Safari"
    }
  ]
}

Zamanlanmış rapor nesnesi

Zamanlanmış bir rapor, kendi saat dilimindeki gece yarısında, onu oluşturan hesaba e-postayla gönderilir.

string

Zamanlanmış raporun kimliği.

string | null

E-posta konusunda ve panelde gösterilen etiket.

string

daily, weekly veya monthly.

string

all, selected veya single.

string[] | null

selected ve single kapsamlarında raporun kapsadığı QR kodları. Hiç kimlik gönderilmediyse null.

null

Her zaman null. Ayrılmıştır.

boolean

E-postaya PDF eklenip eklenmediği.

string

active veya paused.

string

Gönderim zamanının ve dönemin hizalandığı IANA saat dilimi.

string

E-postanın ve PDF’in dili.

string

Bir sonraki e-postanın zamanı, ISO 8601: raporun saat diliminde bir sonraki gece yarısı (daily), bir sonraki pazartesi (weekly) veya bir sonraki ayın 1’i (monthly).

string | null

Son e-postanın gönderildiği zaman, ISO 8601.

string

Oluşturulma tarihi, ISO 8601.

string

Son güncelleme tarihi, ISO 8601.

Zamanlanmış raporları listeleme

GET /api/v1/reports/schedules Diğer üyelerin oluşturdukları dahil, çalışma alanınızın zamanlanmış raporlarını en yeniden başlayarak döndürür. Liste sayfalıdır: bkz. Sayfalama.

integer

varsayılan:"1"

Döndürülecek sayfa; 1 veya daha büyük.

integer

varsayılan:"100"

Sayfa başına sonuç; 1 ile 100 arası.

curl "https://getqr.com/api/v1/reports/schedules?page=1&pageSize=100" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "data": [
    {
      "id": "clx8f2k9a0001qk0c8vhd3xyz",
      "name": "Weekly campaign digest",
      "frequency": "weekly",
      "scope": "selected",
      "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr", "clw3n7t1x0004ab0d9rzu2wfh"],
      "filters": null,
      "includePdf": true,
      "status": "active",
      "timezone": "America/New_York",
      "locale": "en",
      "nextRunAt": "2026-08-10T04:00:00.000Z",
      "lastRunAt": "2026-08-03T04:00:12.000Z",
      "createdAt": "2026-07-01T12:34:56.000Z",
      "updatedAt": "2026-07-28T09:12:00.000Z"
    }
  ],
  "pagination": { "page": 1, "pageSize": 100, "total": 1, "hasMore": false }
}

Rapor zamanlama

POST /api/v1/reports/schedules Düzenli olarak e-postayla gönderilen bir rapor oluşturur. nextRunAt, sıklığa ve saat dilimine göre hesaplanır.

Bir QR kodu, her sıklık için yalnızca bir zamanlanmış rapora ait olabilir. Çakışan bir zamanlama 409 conflict döndürür.

all kapsamlı bir rapor, aynı sıklıktaki diğer tüm raporlarla çakışır. Duraklatılmış raporlar da sayılır.

string

gerekli

Raporun ne sıklıkla gönderileceği: daily, weekly veya monthly. Kapsadığı dönemi de belirler. Bkz. Dönem.

string

gerekli

all, selected veya single. Bkz. Kapsam.

string

gerekli

Gönderim zamanının ve dönemin hizalandığı IANA saat dilimi; örneğin America/New_York. Bilinmeyen bir saat dilimi 422 döndürür.

string

gerekli

E-postanın ve PDF’in dili; örneğin en veya de. Desteklenmeyen bir değer İngilizceye döner. zh, ja, ko ve ar dillerindeki PDF’ler İngilizce oluşturulur.

string[]

Kapsanacak QR kodları. selected (bir veya daha fazla kimlik) ve single (tam olarak bir kimlik) için zorunludur. Her kimlik çalışma alanınızdaki bir QR koduna ait olmalıdır; aksi hâlde istek 404 döndürür.

string

E-posta konusunda ve panelde gösterilen etiket; en fazla 40 karakter.

boolean

varsayılan:"false"

Raporun PDF sürümünü e-postaya ekler.

curl -X POST "https://getqr.com/api/v1/reports/schedules" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekly campaign digest",
    "frequency": "weekly",
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "includePdf": true,
    "timezone": "America/New_York",
    "locale": "en"
  }'

{
  "id": "clx8f2k9a0001qk0c8vhd3xyz",
  "name": "Weekly campaign digest",
  "frequency": "weekly",
  "scope": "selected",
  "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
  "filters": null,
  "includePdf": true,
  "status": "active",
  "timezone": "America/New_York",
  "locale": "en",
  "nextRunAt": "2026-08-10T04:00:00.000Z",
  "lastRunAt": null,
  "createdAt": "2026-08-03T12:34:56.000Z",
  "updatedAt": "2026-08-03T12:34:56.000Z"
}

Zamanlanmış raporu güncelleme

PATCH /api/v1/reports/schedules/{id} Zamanlanmış bir raporu değiştirir ya da duraklatır ve sürdürür. Yalnızca değiştirmek istediğiniz alanları, en az bir tane olmak üzere gönderin. Sıklığı veya saat dilimini değiştirmek ya da duraklatılmış bir raporu sürdürmek nextRunAt değerini yeniden hesaplar. Sıklık başına tek rapor kuralı yine geçerlidir; bu nedenle çakışan bir değişiklik 409 döndürür.

string

gerekli

Zamanlanmış raporun kimliği. Liste veya oluşturma yanıtından alın.

string

paused, zamanlamayı silmeden e-postaları durdurur. active e-postaları sürdürür.

string

Etiket; en fazla 40 karakter.

string

daily, weekly veya monthly.

string

all, selected veya single.

string[]

Kapsanacak QR kodları. Her kimlik çalışma alanınızdaki bir QR koduna ait olmalıdır.

boolean

E-postaya bir PDF ekler.

string

IANA saat dilimi.

string

E-postanın ve PDF’in dili.

curl -X PATCH "https://getqr.com/api/v1/reports/schedules/clx8f2k9a0001qk0c8vhd3xyz" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Monthly campaign digest",
    "frequency": "monthly",
    "status": "active"
  }'

{
  "id": "clx8f2k9a0001qk0c8vhd3xyz",
  "name": "Monthly campaign digest",
  "frequency": "monthly",
  "scope": "selected",
  "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
  "filters": null,
  "includePdf": true,
  "status": "active",
  "timezone": "America/New_York",
  "locale": "en",
  "nextRunAt": "2026-09-01T04:00:00.000Z",
  "lastRunAt": "2026-08-03T04:00:12.000Z",
  "createdAt": "2026-07-01T12:34:56.000Z",
  "updatedAt": "2026-08-05T10:15:00.000Z"
}

Zamanlanmış raporu silme

DELETE /api/v1/reports/schedules/{id} Zamanlamayı siler ve sonraki tüm e-postaları durdurur.

Zamanlanmış bir raporu silme işlemi geri alınamaz.

string

gerekli

Zamanlanmış raporun kimliği.

curl -X DELETE "https://getqr.com/api/v1/reports/schedules/clx8f2k9a0001qk0c8vhd3xyz" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{ "id": "clx8f2k9a0001qk0c8vhd3xyz", "deleted": true }

Sık karşılaşılan sorunlar

Rapor dışa aktarırken 404

selected veya single kapsamında, qrIds değerlerinden hiçbiri çalışma alanınızda kısa bağlantısı olan bir QR koduyla eşleşmedi. Kimlikleri kontrol edin.

Rapor zamanlarken 404 "QR not found."

qrIds değerlerinden biri çalışma alanınızdaki bir QR kodu değil veya silinmiş. Kimlikleri QR kodlarını listeleme ile kontrol edin.

Rapor zamanlarken 409

QR kodlarından biri zaten aynı sıklıktaki bir zamanlanmış rapora ait veya bu sıklıktaki bir rapor all kapsamını kullanıyor. O raporu düzenleyin veya silin ya da farklı bir sıklık seçin.

404 "Scheduled report not found."

id, çalışma alanınızdaki hiçbir zamanlanmış raporla eşleşmiyor. Değeri Zamanlanmış raporları listeleme yanıtından alın.

Raporda bugünün taramaları eksik

Raporlar yalnızca son tamamlanmış dönemi kapsar. Anlık sayılar için Analizler uç noktasını kullanın.

API

Başlıklar

Kapsam

Dönem

Rapor dışa aktarma

JSON yanıtı

CSV ve PDF yanıtları

Zamanlanmış rapor nesnesi

Zamanlanmış raporları listeleme

Rapor zamanlama

Zamanlanmış raporu güncelleme

Zamanlanmış raporu silme

Sık karşılaşılan sorunlar

Sırada ne var

Analizler

Uygulamada zamanlanmış raporlar

Raporları okuma

Hatalar

​Başlıklar

​Kapsam

​Dönem

​Rapor dışa aktarma

​JSON yanıtı

​CSV ve PDF yanıtları

​Zamanlanmış rapor nesnesi

​Zamanlanmış raporları listeleme

​Rapor zamanlama

​Zamanlanmış raporu güncelleme

​Zamanlanmış raporu silme

​Sık karşılaşılan sorunlar

​Sırada ne var

Analizler

Uygulamada zamanlanmış raporlar

Raporları okuma

Hatalar

Başlıklar

Kapsam

Dönem

Rapor dışa aktarma

JSON yanıtı

CSV ve PDF yanıtları

Zamanlanmış rapor nesnesi

Zamanlanmış raporları listeleme

Rapor zamanlama

Zamanlanmış raporu güncelleme

Zamanlanmış raporu silme

Sık karşılaşılan sorunlar

Sırada ne var