Erişim kuralları

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.

Bir QR kodunun ne zaman çözümleneceğini, kaç kez taranabileceğini, parola isteyip istemeyeceğini ve duraklatılmış ya da silinmiş olup olmadığını kontrol edin.

Başlamadan önce

Rol. Kural belirlemek, duraklatmak, yeniden etkinleştirmek ve silmek için çalışma alanındaki QR kodlarına yazma erişimi gerekir. Bkz. Kimlik doğrulama.
Abonelik. Bunlar dahil her API isteği, çalışma alanı sahibinin aktif bir aboneliğini gerektirir.

Erişim nesnesi

Bir QR kodunu oluştururken veya güncellerken bir access nesnesi gönderin:

POST  /api/v1/qrs
PATCH /api/v1/qrs/{qrId}

Alan	Tür	Açıklama
`activeAt`	string (ISO 8601) \| null	Zamanlanmış başlangıç. Bu andan önce taramalar hedef yerine duraklatma sayfasını gösterir. `null`, hemen aktif demektir.
`pauseAt`	string (ISO 8601) \| null	Zamanlanmış bitiş. Bu anda ve sonrasında taramalar duraklatma sayfasını gösterir. `null`, bitiş tarihi yok demektir.
`scanLimit`	integer \| null	QR kodunun ömrü boyunca en fazla tarama sayısı. Aşıldığında taramalar duraklatma sayfasını gösterir. `null`, sınırsız demektir.
`password`	string \| null	Ziyaretçilerin yönlendirilmeden önce girmesi gereken parola. Gönderilmesi korumayı da açar.
`passwordProtected`	boolean	QR kodunun parola isteyip istemediği. `false` korumayı kapatır ancak kayıtlı parolayı saklar. `true` korumayı yeniden açar.

Göndermediğiniz alanlar değişmeden kalır. Bir kuralı temizlemek için null gönderin. Kısmi bir access nesnesi, belirtmediğiniz kuralları hiçbir zaman sıfırlamaz.

Erişim kuralları access altına aittir. activeAt, pauseAt, scanLimit, password veya passwordProtected alanlarını link altında göndermek 422 döndürür.

Başlangıç ve bitiş zamanlayın

activeAt ve pauseAt birbirinden bağımsızdır: birini veya ikisini birden ayarlayın. Her ikisi de Z veya bir UTC farkı içeren ISO 8601 tarih-saat değerleri alır.

curl -X PATCH "https://getqr.com/api/v1/qrs/qr_abc123" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "access": {
      "activeAt": "2026-08-01T09:00:00Z",
      "pauseAt": "2026-08-31T23:59:59Z"
    }
  }'

Zamanlamayı temizlemek için null gönderin. Bu, QR kodunu hemen aktif hâle getirir ve bitiş tarihini kaldırır:

{
  "access": { "activeAt": null, "pauseAt": null }
}

Tarama sınırı

Toplam tarama sayısını sınırlayın. Sınıra ulaşıldıktan sonra QR kodu çözümlenmeyi durdurur:

{
  "access": { "scanLimit": 500 }
}

Ömür boyu tarama sayacı, sınır ayarlanmış olsun ya da olmasın her zaman çalışır. Bu, sınırı değiştirmenin sonucunu öngörülebilir kılar:

Sınırı yükseltmek, tam olarak (yeni sınır eksi toplam tarama) kadar ek tarama açar.
Sınırı mevcut toplamın altına düşürmek, QR kodunu hemen engeller.
Sınırı sonradan ayarlamak, sınır yokken yapılan taramaları da sayar.

scanLimit, en fazla 2147483647 olan pozitif bir tam sayı olmalıdır. Sınırsız için null gönderin.

Parola koruması

Parolayı aynı access nesnesiyle ayarlayın. Korumayı kapattığınızda kayıtlı parola saklanır; böylece parolayı yeniden göndermeden korumayı tekrar açabilirsiniz.

Parolayı ayarlayın veya değiştirin

Bu, korumayı da açar.

{ "access": { "password": "hunter2" } }

Korumayı kapatın

Kayıtlı parola saklanır.

{ "access": { "passwordProtected": false } }

Korumayı yeniden açın

Parolayı yeniden göndermeniz gerekmez. Bu yalnızca daha önce bir parola ayarlanmışsa çalışır. Aksi hâlde istek 422 alır.

{ "access": { "passwordProtected": true } }

Oluştururken. Korumayı açmak için password gönderin. Tek başına passwordProtected, bir parola olana kadar etkisizdir.
Parolayı kaldırma. "password": null gönderin. Koruma da kapanır.
Okuma. Yanıtlar parolayı hiçbir zaman döndürmez, yalnızca access.passwordProtected döndürür.

Duraklatma, yeniden etkinleştirme ve silme

Duraklatma ve yeniden etkinleştirme, access alanları değil ayrı uç noktalardır; çünkü bir zamanlamaya göre değil, anında etkili olurlar.

Yöntem	Yol	Açıklama
`POST`	`/api/v1/qrs/{qrId}/pause`	QR kodunu hemen duraklatın. Siz yeniden etkinleştirene kadar taramalar duraklatma sayfasını gösterir.
`POST`	`/api/v1/qrs/{qrId}/activate`	Duraklatılmış bir QR kodunu yeniden etkinleştirin. Varsa zamanlama ve tarama sınırı geçerli olmaya devam eder.
`DELETE`	`/api/v1/qrs/{qrId}`	QR kodunu ve kısa bağlantısını kalıcı olarak silin.

Duraklatma ve etkinleştirme istek gövdesi almaz ve güncellenmiş QR kodunu döndürür:

curl -X POST "https://getqr.com/api/v1/qrs/qr_abc123/pause" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "qr_abc123",
  "archived": true,
  "…": "…"
}

Duraklatma durumunu PUT /api/v1/qrs/{qrId} ve { "archived": true } ile ya da bir PATCH içinde archived ile de ayarlayabilirsiniz. Bkz. Duraklatma durumunu ayarlama. Silme işlemi QR kodunu ve kısa bağlantısını birlikte kaldırır:

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

Silme işlemi geri alınamaz. Kısa bağlantı çözümlenmeyi durdurur, bu nedenle basılı kodlar çalışmaz hâle gelir. QR koduna yeniden ihtiyaç duyabilecekseniz silmek yerine duraklatın.

Değişiklikler ne zaman geçerli olur

Sonraki tarama. Kurallar bir kod tarandığında kontrol edilir; bu nedenle bir değişiklik geriye dönük değil, sonraki taramadan itibaren uygulanır.
Duraklatma sayfası. Bir zamanlama, tarama sınırı veya duraklatma nedeniyle engellenen QR kodu duraklatma sayfasını gösterir. Tarama yönlendirilmez.
Parola. Parolayı zaten girmiş olan ziyaretçiler, parola değişene veya koruma kapatılıp yeniden açılana kadar erişimini korur.
Saat. Zamanlamalar ziyaretçinin yerel saatini değil, UTC’deki sunucu saatini kullanır.
Kurallar birleşir. Bir QR kodu yalnızca duraklatılmamışsa, zamanlaması içindeyse ve tarama sınırının altındaysa çözümlenir.

Sık karşılaşılan sorunlar

Kuralı link altında ayarlarken 422

Kuralı link altında değil, access altında gönderin.

Parola korumasını açarken 422

QR kodunun henüz bir parolası yok. passwordProtected: true yerine password gönderin.

QR kodu yeniden etkinleştirdikten sonra hâlâ duraklatma sayfasını gösteriyor

Bir zamanlama veya tarama sınırı hâlâ geçerli. QR kodundaki access.activeAt, access.pauseAt ve access.scanLimit değerlerini kontrol edin ve scans değerini sınırla karşılaştırın.

Bağlantının süresinin dolmasını istiyorum

link.expiresAt bu API’de kullanılamaz. Bunun yerine access.pauseAt kullanın.

API

Başlamadan önce

Erişim nesnesi

Başlangıç ve bitiş zamanlayın

Tarama sınırı

Parola koruması

Duraklatma, yeniden etkinleştirme ve silme

Değişiklikler ne zaman geçerli olur

Sık karşılaşılan sorunlar

Sırada ne var

QR kodları

Türe göre QR kodu verileri

​Başlamadan önce

​Erişim nesnesi

​Başlangıç ve bitiş zamanlayın

​Tarama sınırı

​Parola koruması

​Duraklatma, yeniden etkinleştirme ve silme

​Değişiklikler ne zaman geçerli olur

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

​Sırada ne var

QR kodları

Türe göre QR kodu verileri

Başlamadan önce

Erişim nesnesi

Başlangıç ve bitiş zamanlayın

Tarama sınırı

Parola koruması

Duraklatma, yeniden etkinleştirme ve silme

Değişiklikler ne zaman geçerli olur

Sık karşılaşılan sorunlar

Sırada ne var