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

# Kimlik doğrulama

> API anahtarlarını kullanarak Macaly API'sinde kimlik doğrulamayı öğrenin

<Callout icon="user">
  Yalnızca [**Ajans planında**](/docs/tr/welcome/pricing) kullanılabilir
</Callout>

Macaly API'si kimlik doğrulama için API anahtarları kullanır. API anahtarları ekip düzeyindedir ve web arayüzüyle aynı kredi sistemini paylaşır.

## API anahtarı alma

1. Macaly hesabınıza giriş yapın
2. Sağ üstteki profilinize tıklayın
3. **Ayarlar → API Anahtarları** bölümüne gidin
4. "Yeni API Anahtarı Oluştur" seçeneğine tıklayın
5. Anahtarı hemen kopyalayın (yalnızca bir kez gösterilir)

## API anahtarını kullanma

API anahtarını tüm isteklerde `Authorization` header'ı içinde gönderin:

```
Authorization: Bearer macaly_your_api_key_here
```

### Örnek istek

```bash theme={null}
curl -X POST https://www.macaly.com/api/chat \
  -H "Authorization: Bearer macaly_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "Create a landing page"}'
```

## API anahtarı formatı

| Özellik | Değer |
| - | - |
| Ön ek | `macaly_` |
| Tam uzunluk | 39 karakter |
| Örnek | `macaly_abc123def456ghi789jkl012mno345` |

## Güvenlik en iyi uygulamaları

<Warning>
  API anahtarları, ekibinizin kaynaklarına ve kredilerine tam erişim sağlar. Onları parola gibi koruyun.
</Warning>

1. **Anahtarları güvenli saklayın** - Ortam değişkenleri kullanın, anahtarları asla kod deposuna göndermeyin
2. **Anahtarları düzenli olarak yenileyin** - Anahtarları belirli aralıklarla iptal edip yeniden oluşturun
3. **Ayrı anahtarlar kullanın** - Farklı ortamlar ve uygulamalar için farklı anahtarlar oluşturun
4. **Kullanımı izleyin** - Bakiyenizi kontrol panelinden düzenli olarak kontrol edin
5. **Ele geçirilen anahtarları iptal edin** - Bir anahtar açığa çıkarsa hemen iptal edin

## İstek limitleri

* Başarısız API anahtarı denemeleri IP başına dakikada 5 ile sınırlıdır
* Bu, kaba kuvvet saldırılarına karşı koruma sağlar

## Anahtar yönetimi

API anahtarlarınızı Macaly kontrol panelinden yönetebilirsiniz:

* **Anahtarları görüntüleme** - Tüm aktif anahtarları oluşturulma tarihleri ve son kullanım zamanlarıyla birlikte görün
* **Anahtar oluşturma** - Tanımlamayı kolaylaştırmak için isteğe bağlı adlarla yeni anahtarlar üretin
* **Anahtarları iptal etme** - Artık ihtiyaç duyulmayan veya ele geçirilen anahtarları devre dışı bırakın


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