API Tokenları | Procurize.AI#

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

Uygulama alanı: Procurize.AI Dashboard → Settings → Tokens
Mevcut olduğu planlar: Business & Enterprise planları
Gerekli rol: Security Manager, Editor, Admin veya Maintainer

Genel Bakış#

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

Temel özellikler:

Tokenlar, onları oluşturan kullanıcının tüm izinlerini devralır
Tokenlar kuruluş‑kapsamlıdır – API çağrılarında org belirtmeye gerek yoktur
Sınırsız sayıda token oluşturulabilir
Tokenların son kullanma tarihleri olabilir veya süresiz ayarlanabilir
Tokenlar gerektiğinde devre dışı bırakılabilir ve daha sonra yeniden etkinleştirilebilir

🔒 Güvenlik notu: Procurize.AI token değerini saklamaz – yalnızca hash’ini tutar. Tokenı oluşturduktan hemen sonra kopyalamalı ve güvenli bir şekilde saklamalısınız. Tekrar gösterilmeyecektir.

Token Yönetim Paneline Erişim#

Dashboard → API Tokenları sayfasına gidin.
Token yönetim paneli, mevcut kuruluşla ilişkili kişisel tokenlarınızı gösterir.

API tokenları sayfası

Gerekli izin: Yalnızca Security Manager, Editor, Admin veya Maintainer rollerine sahip kullanıcılar bu paneli görüntüleyebilir. Ayrıntılı rol tanımları için İzinler Genel Bakışı bölümüne bakın.

Yeni Bir Token Oluşturma#

Tokenın amacını tanımlamak için bir İsim girin.
Bir son kullanma süresi seçin:
- 1 ay
- 3 ay
- 1 yıl
- Süresiz (sınırsız geçerlilik)
“Oluştur” düğmesine tıklayın.

Önemli – Tokenı Hemen Kopyalayın#

Oluşturulduktan sonra token değeri tek sefer gösterilir – kopyalayın ve güvenli bir yerde saklayın (ör. bir şifre yöneticisi veya ortam değişkeni).

Yeni API tokenı

⚠️ Token değerini bir daha göremezsiniz. Procurize.AI yalnızca doğrulama için güvenli bir hash saklar. Tokenı kaybederseniz, hemen iptal edip yeni bir token oluşturmalısınız.

Mevcut Tokenları Yönetme#

Token paneli, oluşturulmuş tüm tokenların aşağıdaki bilgilerini listeler:

İsim
Sonek
Oluşturulma tarihi
Son kullanma tarihi (veya “-”)
Durum: Aktif veya Pasif

Tokenı Devre Dışı Bırakma / Yeniden Etkinleştirme#

Devre Dışı Bırak – tokenı geçici olarak devre dışı bırakır. Gerektiğinde daha sonra yeniden etkinleştirebilirsiniz.
Yeniden Etkinleştir – daha önce devre dışı bırakılmış bir tokenı aktif duruma getirir.

💡 Devre dışı bırakma, entegrasyonları silmeden geçici olarak duraklatmak için kullanışlıdır.

Tokenı İptal Etme#

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

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

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

🧠 Kuruluş ID’sine gerek yok – token kuruluşunuza bağlıdır, bu yüzden API bağlamı otomatik olarak çözülür.

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

Kural	Açıklama
Token izinleri	Token, onu oluşturan kullanıcının tam aynı izinlerine sahiptir. Kullanıcının rolü değişirse, tokenın izinleri de otomatik olarak güncellenir.
Kuruluş bağlamı	Tokenlar, oluşturucunun 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 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ığından emin olun (ekstra boşluk yok). Tokenın hâlâ aktif ve süresi dolmamış olduğunu kontrol edin.
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 aynı izinleri kaybeder.
Kayıp token	Kayıp tokenı iptal edin ve yeni bir token 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ışı – detaylı rol tanımları
Fiyatlandırma Planları – hangi planların API erişimi sunduğu
REST API Referansı – detaylı uç nokta dokümantasyonu