> ## 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.

# Hatalar

> GetQR API'sinin döndürdüğü hata biçimi ve kodları.

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

GetQR API'si standart HTTP durum kodlarını kullanır. Başarılı istekler `2xx` döndürür. Başarısız istekler, neyin yanlış gittiğini açıklayan bir JSON gövdesiyle `4xx` veya `5xx` döndürür.

## Hata biçimi

Her hatanın yapısı aynıdır: sabit bir kod, okunabilir bir mesaj ve o kodun açıklamasına giden bir bağlantı.

```json theme={null}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized: Invalid API key.",
    "doc_url": "https://getqr.com/account/api-docs#error-unauthorized"
  }
}
```

**error.code** `string` *required*

Sabit, makine tarafından okunabilir hata kodu. Kodunuzda mesaj yerine bunu kullanın. Bkz. [Hata kodları](#hata-kodları).

**error.message** `string` *required*

Sorunun okunabilir açıklaması. İfade değişebilir.

**error.doc\_url** `string` *required*

GetQR hesabınızdaki API dokümantasyonunda hata kodunun açıklamasına giden bağlantı.

## Hata kodları

| Kod | HTTP durumu | Ne zaman oluşur |
| - | - | - |
| `bad_request` | 400 | İstek hatalı biçimlendirilmiş: gövde geçerli bir JSON değil, `Authorization` başlığında `Bearer ` öneki yok veya işleme kaynağın mevcut durumunda izin verilmiyor (örneğin tamamlanmış bir toplu oluşturmayı iptal etmek). |
| `unauthorized` | 401 | API anahtarı eksik veya geçersiz; örneğin yeniden oluşturulduğu için. |
| `forbidden` | 403 | Çalışma alanı sahibinin aboneliği aktif değil veya çalışma alanındaki rolünüz bu işleme izin vermiyor. |
| `exceeded_limit` | 403 | Bir plan sınırına ulaştınız. Single QR planında, çalışma alanında zaten bir QR kodu varken QR kodu oluşturmak veya çoğaltmak ya da toplu oluşturma başlatmak. |
| `not_found` | 404 | Kaynak yok veya çalışma alanınızda değil, uç nokta yok ya da API çalışma alanınız için etkin değil. |
| `method_not_allowed` | 405 | Uç nokta var ancak bu HTTP yöntemini kabul etmiyor. `Allow` başlığı kabul ettiği yöntemleri listeler. |
| `conflict` | 409 | İstek mevcut verilerle çakışıyor: kısa bağlantı slug'ı alınmış, aynı `Idempotency-Key` ile gönderilen bir istek hâlâ işleniyor, bir zamanlama mevcut bir zamanlamayla çakışıyor veya bir toplu arşiv henüz hazır değil. |
| `invite_pending` | 409 | Çalışma alanına davet edildiniz ancak henüz katılmadınız. API anahtarıyla yapılan istekler bunu döndürmez: anahtarın çalışma alanı her zaman üyesi olduğunuz bir çalışma alanıdır. |
| `invite_expired` | 410 | Çalışma alanı davetinizin süresi doldu. Aynı nedenle API anahtarıyla yapılan istekler bunu döndürmez. |
| `unprocessable_entity` | 422 | Gövde veya sorgu parametreleri doğrulamadan geçemedi. Mesaj, alanın adını ve sorunun ne olduğunu belirtir. Bkz. [Doğrulama hataları](#doğrulama-hataları). |
| `rate_limit_exceeded` | 429 | API anahtarı geçerli penceredeki isteklerini tüketti. Bkz. [İstek sınırları](https://docs.getqr.com/tr/api/rate-limits.md). |
| `internal_server_error` | 500 | Bizim tarafımızda bir sorun oluştu. Daha sonra yeniden deneyin ve sorun devam ederse destek ekibiyle iletişime geçin. |

## Doğrulama hataları

Gövde veya sorgu parametreleri doğrulamadan geçemediğinde API `422` ile yanıt verir. Mesaj, geçersiz olan ilk alanı `<issue>: <field>: <details>` biçiminde açıklar:

```json theme={null}
{
  "error": {
    "code": "unprocessable_entity",
    "message": "too_big: pageSize: Max page size is 100.",
    "doc_url": "https://getqr.com/account/api-docs#error-unprocessable_entity"
  }
}
```

İç içe alanlar nokta gösterimini kullanır; örneğin `link.url`.

## Hataları ele alın

* `error.message` değerine değil, `error.code` değerine göre dallanın.
* `4xx` hatalarını değiştirmeden yeniden denemeyin: önce isteği düzeltin. İstisnalar, hâlâ işlenen bir istek için dönen `409` ve `429` hatalarıdır.
* `429` aldığınızda `Retry-After` başlığındaki saniye kadar bekleyin. Bkz. [İstek sınırları](https://docs.getqr.com/tr/api/rate-limits.md#sınırı-aştığınızda).
* `5xx` hatalarını üstel geri çekilmeyle yeniden deneyin.

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

> [accordion] Her istek 404 "This endpoint is not available." döndürüyor
>
> API beta aşamasındadır ve çalışma alanınız için henüz etkinleştirilmemiştir.

> [accordion] 404 "This endpoint does not exist."
>
> Yol yanlış. Yolu uç nokta sayfalarıyla karşılaştırın ve `/api/v1/` ile başladığını kontrol edin.

> [accordion] 403 "Access denied: This account does not have an active subscription."
>
> Çalışma alanı sahibinin aboneliği sona erdi. Sahip yeniden abone olduğu anda API anahtarı tekrar çalışır.

> [accordion] 403 "API access is not available for this role."
>
> Çalışma alanındaki rolünüz Viewer. API'yi yalnızca çalışma alanı sahibi ve Editor rolündekiler kullanabilir.

## Sırada ne var

> [card] [İstek sınırları](https://docs.getqr.com/tr/api/rate-limits.md)

> [card] [Kimlik doğrulama](https://docs.getqr.com/tr/api/authentication.md)


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