Hatalar

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

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

string

gerekli

Sabit, makine tarafından okunabilir hata kodu. Kodunuzda mesaj yerine bunu kullanın. Bkz. Hata kodları.

string

gerekli

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

string

gerekli

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ı.
`rate_limit_exceeded`	429	API anahtarı geçerli penceredeki isteklerini tüketti. Bkz. İstek sınırları.
`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:

{
  "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ı.
5xx hatalarını üstel geri çekilmeyle yeniden deneyin.

Sık karşılaşılan sorunlar

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.

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.

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.

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.

API

Hata biçimi

Hata kodları

Doğrulama hataları

Hataları ele alın

Sık karşılaşılan sorunlar

Sırada ne var

İstek sınırları

Kimlik doğrulama

​Hata biçimi

​Hata kodları

​Doğrulama hataları

​Hataları ele alın

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

​Sırada ne var

İstek sınırları

Kimlik doğrulama

Hata biçimi

Hata kodları

Doğrulama hataları

Hataları ele alın

Sık karşılaşılan sorunlar

Sırada ne var