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

# API anahtarları

> Organizasyonunuzun salt okunur API anahtarlarını oluşturun, kopyalayın, yeniden adlandırın ve iptal edin.

API anahtarı, başka bir programın Perquery verilerinizi API üzerinden okumasını sağlar. Anahtarlar salt okunurdur ve organizasyonunuza aittir.

## Başlamadan önce

* Organizasyonunuzun API erişimi add-on'una sahip olması gerekir. [Add-on'lar](https://docs.perquery.ai/tr/account/add-ons.md) sayfasına bakın.
* Rolünüzün **API anahtarları** izinlerine sahip olması gerekir. [Roller ve izinler](https://docs.perquery.ai/tr/account/roles-and-permissions.md) sayfasına bakın.

Sayfayı açmak için kullanıcı menüsünde **API Anahtarları**'na tıklayın.

## Anahtar oluşturun

**1. Formu açın**

**API Anahtarları** sayfasında **Anahtar oluştur**'a tıklayın.

**2. Anahtara ad verin**

**Ad** alanını doldurun. Anahtarı nerede kullandığınızı gösteren bir ad seçin.

**3. Son kullanma tarihi belirleyin (isteğe bağlı)**

**Son kullanma (isteğe bağlı)** alanında bir tarih seçin. Tarih bugünden sonra olmalıdır. Tarih seçmezseniz anahtarın süresi dolmaz.

**4. Oluşturun**

**Oluştur**'a tıklayın.

**5. Anahtarı kopyalayın**

**Kopyala**'ya tıklayın. Anahtarı güvenli bir yerde, örneğin bir şifre yöneticisinde saklayın. Ardından **Tamam**'a tıklayın.

> [!WARNING]
>
> Perquery tam anahtarı yalnızca bir kez gösterir. **Tamam**'a tıkladıktan sonra anahtarı tekrar göremezsiniz. Anahtarı kaybederseniz onu iptal edin ve yenisini oluşturun.

## Bir anahtarın okuyabildikleri

Her anahtar şu kapsamları alır. **Kapsamlar** sütunu bunları gösterir.

* `metrics:read`: görünürlük, otorite, teknik analiz, içerik analizi, bot logları, fırsatlar, etki ve entegrasyonlar.
* `catalogue:read`: siteler, promptlar, personalar ve rakipler.
* `runs:read`: görünürlük, teknik analiz ve içerik analizi taramaları.

Bir anahtar, onu oluşturan üye olarak çalışır. O üyenin okuyabileceğinden fazlasını hiçbir zaman okuyamaz. Şu kurallar geçerlidir:

* Üye bir izni kaybederse anahtar da o izni kaybeder.
* Üye askıya alınırsa anahtar çalışmayı durdurur.
* Kapsamların kapsadığı tüm izinlere sahip olmanız gerekir. Sahip değilseniz Perquery yeni anahtarı reddeder.

## Anahtarı kullanın

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

```http theme={null}
Authorization: ApiKey pq_<prefix>_<secret>
```

Bir anahtar yalnızca veri okuyabilir. Perquery veriyi değiştiren istekleri reddeder. Ayrıntılar için [Kimlik doğrulama](https://docs.perquery.ai/tr/api/authentication.md) sayfasına bakın.

## Anahtar listesi

**API Anahtarları** sayfası, iptal edilenler dahil organizasyonun tüm anahtarlarını listeler.

| Sütun | İçerik |
| - | - |
| **Ad** | Anahtarın adı. **İptal edildi** etiketi iptal edilmiş bir anahtarı gösterir. |
| **Önek** | Anahtarın `<prefix>` kısmı. Bir anahtarı bulmak için kullanın. |
| **Kapsamlar** | Anahtarın okuyabildikleri. |
| **Oluşturulma** | Oluşturulma tarihi. |
| **Son kullanım** | Son isteğin tarihi. Kullanılmamış bir anahtar için **Hiç** görünür. |
| **Son kullanma** | Son kullanma tarihi. Süresi dolmayan bir anahtar için **Hiç** görünür. |

## Anahtarı yeniden adlandırın

**1. Yeniden adlandırmayı başlatın**

Anahtarın satırında **Yeniden adlandır**'a (kalem simgesi) tıklayın.

**2. Kaydedin**

Yeni adı girin. **Kaydet**'e tıklayın.

Anahtarın değeri değişmez.

## Anahtarı iptal edin

> [!WARNING]
>
> İptal edilen bir anahtar hemen çalışmayı durdurur. Onu tekrar çalışır hâle getiremezsiniz.

**1. İptali başlatın**

Anahtarın satırında **İptal et**'e (çöp kutusu simgesi) tıklayın.

**2. Onaylayın**

**İptal edilsin mi?**'ye tıklayın.

## İlgili sayfalar

* [Kimlik doğrulama](https://docs.perquery.ai/tr/api/authentication.md)
* [Add-on'lar](https://docs.perquery.ai/tr/account/add-ons.md)


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