# API Tokenları | Procurize.AI

**Procurize.AI çalışma alanınızda güvenli programatik erişim için API tokenlarını oluşturun, yönetin ve kullanın.**

> **İlgili:** Procurize.AI Kontrol Paneli → Ayarlar → Tokenlar  
> **Mevcut olduğu planlar:** Business & Enterprise planları  
> **Gerekli rol:** Yönetici veya Bakıcı

## Genel Bakış

API tokenları, Procurize.AI platformuna güvenli ve programatik erişim sağlar. Tokenları, Procurize.AI'yi iç sistemlerinizle entegre etmek, iş akışlarını otomatikleştirmek veya platformun üzerinde özel uygulamalar geliştirmek için kullanabilirsiniz.

**Temel özellikler:**

- Tokenlar, oluşturdukları kullanıcının **tüm izinlerini** devralır
- Tokenlar **kuruluş‑bazlıdır** – API isteklerinde `org` belirtmeye gerek yoktur
- Sınırsız sayıda token oluşturulabilir
- Tokenların **son kullanım tarihleri** olabilir veya süresiz ayarlanabilir
- Tokenlar gerektiğinde **devre dışı** bırakılabilir ve daha sonra **tekrardan etkinleştirilebilir**

> 🔒 **Güvenlik notu:** Procurize.AI token değerini **saklamaz** – sadece hash'ini tutar. Tokenı oluşturduktan hemen sonra kopyalayıp kaydetmeniz gerekir. Tekrar gösterilmeyecektir.

## Token Yönetim Paneline Erişim

1. **Kontrol Paneli** → **Ayarlar** → **Tokenlar** sekmesine gidin.
2. Token yönetim paneli, mevcut kuruluşla ilişkili kişisel tokenlarınızı gösterir.

![API tokenları paneli](/images/docs/api-tokens-panel.png)

> **Gerekli izin:** Sadece **Yönetici** veya **Bakıcı** rolündeki kullanıcılar bu panele erişebilir. Rol tanımları için [İzinler Genel Bakışı](/what-user-permissions-does-procurize-have/) bölümüne bakın.

## Yeni Bir Token Oluşturma

1. **İsmi** girerek tokenın amacını tanımlayın.
2. Bir **son kullanım süresi** seçin:
   - 1 ay
   - 3 ay
   - 1 yıl
   - **Süresiz** (sınırsız geçerlilik)
3. **"Oluştur"** tuşuna basın.

### Önemli – Tokenı Hemen Kopyalayın

Oluşturulduktan sonra token değeri **tek sefer** gösterilir – hemen kopyalayıp güvenli bir şekilde saklayın (örn. bir parola yöneticisinde veya ortam değişkeninde).

![Yeni API tokenı](/images/docs/new-api-token.png)

> ⚠️ **Token değerini bir daha göremezsiniz.** Procurize.AI sadece doğrulama için güvenli bir hash saklar. Tokenı kaybederseniz, onu iptal edip yeni bir tane oluşturmanız gerekir.

## Mevcut Tokenları Yönetme

Tokenlar paneli, oluşturulan tüm tokenların aşağıdaki bilgilerle bir listesini gösterir:

- İsim
- Sonek
- Oluşturulma tarihi
- Son kullanım tarihi (veya “-”)
- Durum: **Aktif** veya **Pasif**

### Bir Tokenı Devre Dışı Bırakma / Tekrar Etkinleştirme

- **Devre Dışı Bırak** – tokenı geçici olarak devre dışı bırakır. Gerektiğinde daha sonra tekrar etkinleştirebilirsiniz.
- **Etkinleştir** – önceden devre dışı bırakılmış tokenı tekrar aktif duruma getirir.

> 💡 Devre dışı bırakma, entegrasyonları silmeden geçici olarak durdurmak için faydalıdır.

### Bir Tokenı İptal Etme

- **İptal Et** – tokenı kalıcı olarak siler. Bu işlem geri alınamaz.
- Tokenı kaybederseniz, hemen iptal edip yeni bir token oluşturun.

## Bir API Tokenı Kullanma

### Temel URL ve Kimlik Doğrulama

| Parametre | Değer |
|-----------|-------|
| **Temel URL** | `https://api.procurize.com` |
| **Kimlik doğrulama yöntemi** | Başlık üzerinden API anahtarı |
| **Başlık** | `X-API-Key: <YOUR_API_TOKEN>` |

### Örnek İstek (cURL)

```bash
curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"
```

> 🧠 **Kuruluş ID'si gerekmez** – token kuruluşunuza bağlanmıştır, bu yüzden API bağlamı otomatik olarak çözer.

## Önemli Güvenlik ve Kullanım Kuralları

| Kural | Açıklama |
|------|----------|
| **Token izinleri** | Token, oluşturduğu kullanıcının tam aynı izinlerine sahiptir. Kullanıcının rolü değişirse, tokenın izinleri de buna göre güncellenir. |
| **Kuruluş bağlamı** | Tokenlar, yaratıcısının kuruluşuna bağlıdır. Bir tokenı birden fazla kuruluşta kullanamazsınız. |
| **Token görünürlüğü** | Token değeri **yalnızca bir kez** gösterilir. Hemen kopyalayıp saklayın. Procurize.AI sadece bir hash tutar. |
| **Süresi dolmuş tokenlar** | Süresi dolmuş tokenlar otomatik olarak devre dışı bırakılır ve kullanılamaz. Gerekirse yeni bir token oluşturun. |

## Sorun Giderme

| Sorun | Çözüm |
|-------|-------|
| **"Geçersiz API anahtarı" hatası** | Tokenın doğru kopyalandığını (fazladan boşluk olmadığını) kontrol edin. Tokenın hâlâ aktif ve süresi dolmamış olduğundan emin olun. |
| **Rol değişikliğinden sonra token çalışmıyor** | Tokenın izinleri, kullanıcının mevcut rolüne göre güncellenir. Kullanıcı izin kaybederse token da kaybeder. |
| **Kayıp token** | Kayıp tokenı iptal edin ve yeni bir tane oluşturun. |
| **Hız sınırlaması** | API hız sınırlamaları planınıza göre uygulanır. Yanıt başlıklarındaki `X-RateLimit-*` değerlerini kontrol edin. |

## İlgili Konular

- [İzinler Genel Bakışı](/what-user-permissions-does-procurize-have/) – detaylı rol tanımları
- [Fiyatlandırma Planları](https://www.procurize.ai/pricing/) – hangi planların API erişimi içerdiği
- [REST API Referansı](/rest-api-reference/) – detaylı uç nokta dokümantasyonu

{{<article-feedback>}}