> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Erişim kuralları

> Bir başlangıç ve bitiş zamanlayın, tarama sayısını sınırlayın, parola isteyin ve bir QR kodunu duraklatın, yeniden etkinleştirin veya silin.

> [!NOTE]
>
> 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](https://docs.getqr.com/tr/api/authentication.md).
* **Abonelik.** Bunlar dahil her API isteği, çalışma alanı sahibinin aktif bir aboneliğini gerektirir.

## Erişim nesnesi

Bir QR kodunu [oluştururken](https://docs.getqr.com/tr/api/endpoints/qr-codes.md#qr-kodu-oluşturma) veya [güncellerken](https://docs.getqr.com/tr/api/endpoints/qr-codes.md#qr-kodunu-güncelleme) bir `access` nesnesi gönderin:

```text theme={null}
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.

> [!WARNING]
>
> 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.

```bash theme={null}
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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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.

**1. Parolayı ayarlayın veya değiştirin**

Bu, korumayı da açar.

```json theme={null}
{ "access": { "password": "hunter2" } }
```

**2. Korumayı kapatın**

Kayıtlı parola saklanır.

```json theme={null}
{ "access": { "passwordProtected": false } }
```

**3. 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.

```json theme={null}
{ "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](https://docs.getqr.com/tr/api/endpoints/qr-codes.md#qr-kodunu-duraklatma). 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](https://docs.getqr.com/tr/api/endpoints/qr-codes.md#qr-kodunu-yeniden-etkinleştirme). Varsa zamanlama ve tarama sınırı geçerli olmaya devam eder. |
| `DELETE` | `/api/v1/qrs/{qrId}` | [QR kodunu](https://docs.getqr.com/tr/api/endpoints/qr-codes.md#qr-kodunu-silme) ve kısa bağlantısını kalıcı olarak silin. |

Duraklatma ve etkinleştirme istek gövdesi almaz ve güncellenmiş [QR kodunu](https://docs.getqr.com/tr/api/endpoints/qr-codes.md#qr-kodu-nesnesi) döndürür:

```bash theme={null}
curl -X POST "https://getqr.com/api/v1/qrs/qr_abc123/pause" \
  -H "Authorization: Bearer $GETQR_API_KEY"
```

```json theme={null}
{
  "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](https://docs.getqr.com/tr/api/endpoints/qr-codes.md#duraklatma-durumunu-ayarlama).

Silme işlemi QR kodunu ve kısa bağlantısını birlikte kaldırır:

```json theme={null}
{ "id": "qr_abc123", "deleted": true }
```

> [!WARNING]
>
> 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

> [accordion] Kuralı link altında ayarlarken 422
>
> Kuralı `link` altında değil, `access` altında gönderin.

> [accordion] Parola korumasını açarken 422
>
> QR kodunun henüz bir parolası yok. `passwordProtected: true` yerine `password` gönderin.

> [accordion] 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](https://docs.getqr.com/tr/api/endpoints/qr-codes.md#qr-kodunu-alma) `access.activeAt`, `access.pauseAt` ve `access.scanLimit` değerlerini kontrol edin ve `scans` değerini sınırla karşılaştırın.

> [accordion] Bağlantının süresinin dolmasını istiyorum
>
> `link.expiresAt` bu API'de kullanılamaz. Bunun yerine `access.pauseAt` kullanın.

## Sırada ne var

> [card] [QR kodları](https://docs.getqr.com/tr/api/endpoints/qr-codes.md)

> [card] [Türe göre QR kodu verileri](https://docs.getqr.com/tr/api/guides/qr-types.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.