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#

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

API tokenları paneli

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ışı bölümüne bakın.

Yeni Bir Token Oluşturma#

İsmi girerek tokenın amacını tanımlayın.
Bir son kullanım süresi seçin:
- 1 ay
- 3 ay
- 1 yıl
- Süresiz (sınırsız geçerlilik)
“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ı

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

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ışı – detaylı rol tanımları
Fiyatlandırma Planları – hangi planların API erişimi içerdiği
REST API Referansı – detaylı uç nokta dokümantasyonu