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

# Kimlik doğrulama

> Bir API anahtarı oluşturun ve isteklerinizin kimliğini doğrulayın.

> [!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 her isteğin kimliğini hesabınızın API anahtarıyla doğrular. Her kullanıcının bir anahtarı vardır ve bu anahtar tek bir çalışma alanında sizin adınıza işlem yapar.

## Başlamadan önce

* Çalışma alanı sahibi veya Editor olmanız gerekir. Viewer rolündekiler API anahtarı oluşturamaz ve kullanamaz.
* Çalışma alanı sahibinin aktif bir aboneliği olmalıdır.

## API anahtarınızı oluşturun

**1. Hesap ayarlarınızı açın**

Hesap ayarlarınızı açın ve **API** bölümüne gidin.

**2. Anahtarı oluşturun**

**Generate API key** öğesine tıklayın.

**3. Anahtarı kopyalayın**

Anahtarı görüntüleyin ve kopyalayın. Anahtarlar `sk_live_` ile başlar.

Anahtarı istediğiniz zaman yeniden görüntüleyip kopyalayabilirsiniz. Ayarlarda anahtarın ne zaman oluşturulduğu ve en son ne zaman kullanıldığı da gösterilir.

## Kimliği doğrulanmış istekler gönderin

Anahtarı her isteğin `Authorization` başlığında Bearer token olarak gönderin:

```bash theme={null}
curl "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer sk_live_..."
```

| Sorun | Yanıt |
| - | - |
| `Authorization` başlığı yok | `401 unauthorized`: "Missing Authorization header." |
| Başlık `Bearer ` ile başlamıyor | `400 bad_request`: "Misconfigured authorization header. Did you forget to add 'Bearer '?" |
| Bilinmeyen veya yeniden oluşturulmuş anahtar | `401 unauthorized`: "Unauthorized: Invalid API key." |
| Rolünüz Viewer | `403 forbidden`: "API access is not available for this role." |
| Çalışma alanı sahibinin aboneliği aktif değil | `403 forbidden`: "Access denied: This account does not have an active subscription." |
| API, çalışma alanınız için etkin değil | `404 not_found`: "This endpoint is not available." |

Anahtar olmadan çalışan tek uç nokta [durum kontrolüdür](https://docs.getqr.com/tr/api/endpoints/health.md).

## Erişim ve roller

* **Roller.** Yalnızca çalışma alanı sahibi ve Editor rolündekiler API anahtarı oluşturup kullanabilir. Viewer rolündekiler kullanamaz.
* **Çalışma alanı.** Her anahtar tek bir çalışma alanına aittir ve her istek o çalışma alanında çalışır. Çalışma alanı kimliği göndermeniz gerekmez.
* **Anlık kontroller.** Erişim her istekte mevcut rolünüze ve çalışma alanı sahibinin aboneliğine göre kontrol edilir. Kendi aboneliğiniz dikkate alınmaz. Rolünüz Viewer olarak değişirse veya sahibin aboneliği sona ererse, erişim geri gelene kadar istekler `403` döndürür. Yeni bir anahtara ihtiyacınız yoktur.
* **Kaldırılma.** Çalışma alanından kaldırılırsanız API anahtarınız silinir. Yeniden eklenirseniz yeni bir anahtar oluşturun.

## Anahtarınızı yeniden oluşturun

Anahtar sızarsa veya erişmemesi gereken biri ona ulaşırsa anahtarı yeniden oluşturun.

> [!WARNING]
>
> Mevcut anahtarınız hemen çalışmayı durdurur. Onu kullanan tüm uygulamalar ve entegrasyonlar, yeni anahtarla güncellenene kadar çalışmaz.

**1. Regenerate'e tıklayın**

Hesap ayarlarınızda **API** bölümüne gidin ve **Regenerate** öğesine tıklayın.

**2. Onaylayın**

**Regenerate key** öğesine tıklayın.

**3. Uygulamalarınızı güncelleyin**

Yeni anahtarı kopyalayın ve eski anahtarı kullandığınız her yerde değiştirin.

## Anahtarınızı güvende tutun

Anahtara bir parola gibi davranın: anahtara sahip olan herkes çalışma alanınızda QR kodları oluşturabilir, değiştirebilir ve silebilir.

* Anahtarı kaynak kodunda değil, bir ortam değişkeninde veya gizli bilgi yöneticisinde saklayın.
* API'yi yalnızca sunucunuzdan çağırın. Anahtarı asla bir web sitesine, mobil uygulamaya veya kullanıcıların inceleyebileceği başka bir yere koymayın.
* Anahtarı yalnızca ihtiyacı olan geliştiricilerle paylaşın.
* Sızdığından şüphelendiğiniz anda anahtarı yeniden oluşturun.

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

> [accordion] Daha önce çalışan bir anahtarla 401 alıyorum
>
> Anahtar yeniden oluşturulmuş ya da çalışma alanından kaldırıldığınız için anahtar silinmiştir. Güncel anahtarı hesap ayarlarınızdan kopyalayın veya yeni bir anahtar oluşturun.

> [accordion] Her istekte 403 alıyorum
>
> Rolünüzün sahip veya Editor olduğunu ve çalışma alanı sahibinin aboneliğinin aktif olduğunu kontrol edin. Erişim geri geldiği anda anahtar yeniden çalışır.

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

> [accordion] API ayarlarını göremiyorum
>
> Bu ayarlar yalnızca çalışma alanı sahibine ve Editor rolündekilere, yalnızca API'nin etkin olduğu çalışma alanlarında görünür.

## Sırada ne var

> [card] [API'ye giriş](https://docs.getqr.com/tr/api/introduction.md)

> [card] [Hatalar](https://docs.getqr.com/tr/api/errors.md)


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