API anahtarları, yazılımlarınızın sisteme güvenli şekilde bağlanmasına aracılık eder. Her entegrasyon için ayrı bir anahtar oluşturabilir, anahtarın hangi işlemleri hangi markalarda yapabileceğini belirleyebilir ve gerektiğinde anahtarı iptal edebilirsiniz.
📌 Bu Makale Kimin İçin?
- API anahtarlarını oluşturan ve yöneten hesap sahipleri ile global yöneticiler
- Sistemin API'sine bağlanan entegrasyonları geliştiren veya yöneten teknik ekipler
- Mevcut entegrasyonlarının yeni yapıdan nasıl etkilendiğini öğrenmek isteyen müşteriler
🚀 API Anahtarı Nedir?
API anahtarı, yazılımınızın sisteme bağlanırken her istekte gönderdiği gizli anahtardır. Bir hesapta birden fazla API anahtarı bulunabilir. Her anahtar aşağıdaki bilgilerle tanımlanır:
| Bilgi | Açıklama |
|---|---|
| Ad | Anahtarın hangi entegrasyona ait olduğunu belirtir. Örneğin, “Muhasebe entegrasyonu”. |
| Yetki Profili | Anahtarın hangi işlemleri yapabileceğini belirler. Kullanıcılar için tanımlanan yetki profilleriyle aynıdır. |
| Markalar | Anahtarın hangi markaların verilerine erişebileceğini belirler: Tüm markalar veya Seçili markalar. |
| Geçerlilik | Anahtarın ne kadar süreyle kullanılabileceğini belirler: Süresiz, 30 gün, 90 gün, 1 yıl veya seçilen bir tarih. |
| Durum | Anahtarın mevcut durumunu gösterir: Aktif, Süresi doldu veya İptal edildi. |
| Son Kullanım | Anahtarla en son ne zaman istek gönderildiğini gösterir. Kullanılmayan anahtarları tespit etmek için kullanılabilir. |
⚙️ API Anahtarları Nasıl Çalışır?
🔐Anahtar, yetki profilindeki izinlerle sınırlıdır. Profilde talep silme izni yoksa ilgili API anahtarıyla da talep silinemez.
🏷️Anahtar yalnızca kapsamındaki markalara erişebilir. “Tüm markalar” seçeneği, sonradan eklenen markaları da kapsar. Pasif markalar bu kapsama dahil değildir.
🔑Anahtarın tamamı yalnızca bir kez gösterilir. Oluşturma sırasında görüntülenen anahtarın sonrasında yalnızca ilk ve son 4 karakteri listede yer alır.
🚫İptal işlemi kısa sürede geçerli olur. İptal edilen anahtarla gönderilen istekler birkaç saniye içinde reddedilir.
🖥️Bazı işlemler yalnızca panelden yapılabilir. Kullanıcı, yetki profili ve ödeme gibi hassas işlemler API anahtarıyla gerçekleştirilemez.
⏱️Dakikalık istek limiti vardır. Hesaptaki tüm API anahtarları ortak bir istek limitini kullanır. Yeni anahtar oluşturmak bu limiti artırmaz.
🔐 Erişim
API anahtarlarına sağ üst köşeden Hesap Bilgileri alanından ve ardından API sekmesinden ulaşabilirsiniz. Aynı ekranı Ayarlar > Genel Ayarlar > API yoluyla da açabilirsiniz.
API anahtarlarını yalnızca Sahip ve Global Yönetici profilindeki kullanıcılar yönetebilir.

| Kullanıcı | Yapabileceği İşlemler |
|---|---|
| Sahip | Tüm anahtarları oluşturabilir, düzenleyebilir ve iptal edebilir. Her yetki profilini seçebilir. |
| Hesap bilgisi düzenleme yetkisi olan diğer kullanıcılar | API sekmesini görebilir ancak sekmeyi açtıklarında “Yetki hatası” ekranıyla karşılaşırlar. Anahtar listesini görüntüleyemezler. |
| Diğer kullanıcılar | API sekmesini göremezler. |
🚀 API Anahtarı Oluşturma Adımları
- API sekmesinde +Yeni API Anahtarı butonuna tıklayın. Açılan pencere Bilgiler ve Anahtar olmak üzere iki adımdan oluşur.
- Gerekli alanları doldurun ve Oluştur butonuna tıklayın.
- Ekranda görüntülenen API anahtarını kopyalayarak güvenli bir yere kaydedin.
- Anahtarı güvenli bir yere kaydettim kutusunu işaretleyin ve Kapat butonuna tıklayın. Bu onay verilmeden pencere başka bir yöntemle kapatılamaz.
📝 Anahtar Alanları
| Alan | Açıklama | Örnek |
|---|---|---|
| Ad | Anahtarın hangi kullanıcıya veya entegrasyona ait olduğunu belirten addır. En fazla 100 karakter olabilir. | Muhasebe entegrasyonu |
| Yetki Profili | Anahtarın gerçekleştirebileceği işlemleri belirler. Yalnızca entegrasyonun ihtiyaç duyduğu izinleri içeren profili seçin. | Yalnızca okuma izni olan profil |
| Markalar | Anahtarın erişebileceği markaları belirler. “Tüm markalar” veya “Seçili markalar” seçeneklerinden biri kullanılabilir. Seçili markalar için en az bir aktif marka seçilmelidir. | Seçili: Mağaza A |
| Geçerlilik | Anahtarın kullanım süresini belirler. Süresiz, 30 gün, 90 gün, 1 yıl veya belirli bir tarih seçilebilir. Seçilen tarih en az bir saat sonrasında olmalıdır. | 90 gün |
❗️ API anahtarı oluşturulduktan sonra tekrar görüntülenemez. Anahtarın tamamı yalnızca oluşturma ekranında gösterilir. Infoset ekibi dahil hiç kimse anahtarı sonradan görüntüleyemez. Anahtarı kaybederseniz yenisini oluşturmanız ve eski anahtarı iptal etmeniz gerekir.
🏷️ Yetki Profili ve Marka Seçimi
Sahip ve Global Yönetici profilleri yalnızca Sahip tarafından seçilebilir. Global Yönetici bu profilleri listede pasif olarak görür.
Sahip ve Global Yönetici yetki profiline sahip anahtarlar her zaman tüm markaları kapsar. Bu profiller seçildiğinde marka seçimi “Tüm markalar” olarak sabitlenir.
Anahtarın kapsamındaki markalardan biri pasife alınırsa anahtar en geç bir dakika içinde o markanın verilerine erişimini kaybeder.
Yeni bir marka oluşturduğunuzda “Tüm markalar” kapsamındaki anahtarlar bu markaya otomatik olarak erişebilir. “Seçili markalar” kapsamındaki anahtarlara ise yeni markayı manuel olarak eklemeniz gerekir.
🔄 API Anahtarlarını Yönetme
| İşlem | Açıklama |
|---|---|
| Düzenle | Anahtarın adı, yetki profili, markaları ve bitiş tarihi değiştirilebilir. Anahtarın değeri değişmez. Entegrasyon aynı anahtarla çalışmaya devam eder ve yeni ayarlar birkaç saniye içinde geçerli olur. |
| Süresi dolan anahtarı uzat | Süresi dolan anahtarı düzenleyerek yeni bir bitiş tarihi belirleyebilirsiniz. Bu işlemden sonra anahtar yeniden kullanılabilir. |
| İptal et | Anahtarı kalıcı olarak devre dışı bırakır. Onay penceresinde “Bu anahtarı kullanan entegrasyonlar hemen çalışmayı durdurur” uyarısı gösterilir. |
| İptal edilenleri göster | İptal edilen anahtarlar varsayılan olarak listede gizlenir. Bu seçenekle iptal edilen anahtarları yeniden görüntüleyebilirsiniz. |
📌 İptal işlemi geri alınamaz ve iptal edilen anahtar düzenlenemez. Ayrı bir silme işlemi bulunmaz; iptal edilen anahtar kayıt olarak listede kalır. Oluşturma, düzenleme ve iptal işlemleri denetim kayıtlarına eklenir.
📌 Anahtarın süresi dolmadan 7 gün önce Sahip ve Global Yönetici profillerindeki kullanıcılara bildirim ve e-posta gönderilir. Bu bilgilendirme her anahtar için yalnızca bir kez yapılır.
🔁 Mevcut Entegrasyonlar için Ne Değişti?
Hesabınızda daha önce kullanılan tek API anahtarı, yeni listeye Default Key adıyla taşınmıştır. Bu anahtarın yetki profili Sahip, marka kapsamı ise Tüm markalar olarak tanımlanmıştır.
Anahtarın değeri değişmediği için mevcut entegrasyonunuz aynı anahtarla çalışmaya devam eder.
| Entegrasyonunuzun Yaptığı İşlem | Yeni Yapıdaki Durum |
|---|---|
| Talep, kişi, sohbet gibi normal API çağrıları | Değişiklik yoktur. Entegrasyon çalışmaya devam eder. |
| API üzerinden anahtarı görüntüleme çağrısı | Çalışmaz. Bu işlem kaldırılmıştır; anahtar hiçbir yerden okunamaz. |
| API üzerinden anahtarı yeniden oluşturma çağrısı | Çalışmaz. Yeni anahtarlar yalnızca panelden oluşturulabilir. |
| Hesap bilgisini okuyarak içinden anahtarı alma | Anahtar döndürülmez. Hesap bilgisi yanıtında artık anahtar alanı bulunmaz. |
| Yalnızca panelden yapılabilen bir işlemi API anahtarıyla gerçekleştirme | 403 hatası alınır. |
| Dakikada çok fazla istek gönderme | 429 hatası alınır. |
🖥️ Yalnızca Panelden Yapılabilen İşlemler
Hesap güvenliği, ödeme ve gizli bilgilerle ilgili bazı işlemler API anahtarıyla gerçekleştirilemez. Anahtar Sahip yetki profiline sahip olsa bile bu kısıtlama geçerlidir. Bu işlemler için panele giriş yapmış bir kullanıcı gerekir.
| Alan | İşlemler |
|---|---|
| Kullanıcılar | Kullanıcı ekleme, toplu kullanıcı ekleme, düzenleme, silme ve toplu işlem yapma; kullanıcı şifresini değiştirme; yedek kod ekleme; iki adımlı doğrulamayı (MFA) açma ve kapatma. |
| Yetki profilleri | Profil oluşturma, kopyalama, düzenleme ve silme; yetkileri, santral yetkilerini ve dış numara yetkilerini güncelleme; profile kullanıcı ekleme ve çıkarma. |
| Ödeme | Ödeme başlatma; kayıtlı kartları listeleme ve görüntüleme; kart güncelleme ve silme. |
| Hesap | Fatura bilgilerini kaydetme; şifre politikasını güncelleme; API IP izin listesini ve MFA zorunluluğunu değiştirme. |
| Çağrı merkezi | Santral kullanıcısının ve santral sağlayıcısının şifresini görüntüleme. |
| Chat widget | Widget'ın gizli anahtarını görüntüleme ve yenileme. |
| API anahtarları | Anahtarları listeleme, oluşturma, düzenleme ve iptal etme. Bir API anahtarı başka bir API anahtarı oluşturamaz. |
⚠️ Hata Kodları
| Kod | Hangi Durumda Alınır? | Ne Yapmalısınız? |
|---|---|---|
| 401 | Anahtar yanlış, iptal edilmiş veya süresi dolmuşsa. | API sekmesinden anahtarın durumunu kontrol edin. Gerekirse süresini uzatın veya yeni bir anahtar oluşturun. |
| 403 | Yalnızca panelden yapılabilen bir işlem API anahtarıyla denenirse. | İlgili işlemi panel üzerinden gerçekleştirin. |
| 429 | Dakikalık istek limiti veya aynı anda çalışan istek sınırı aşılırsa. | Yanıtta belirtilen Retry-After süresi kadar bekleyip isteği yeniden gönderin. |
⏱️ İstek Limitleri
API anahtarıyla gönderilen her istek iki ayrı limitten düşülür: anahtarın kendi istek limiti ve hesabın ortak limiti. Bu limitlerden herhangi biri dolduğunda istek 429 hatası alır.
| Limit | Değer | Açıklama |
|---|---|---|
| Hesap limiti | 500 / dakika | Hesaptaki tüm API anahtarları bu ortak limiti kullanır. Yeni anahtar oluşturmak limiti artırmaz. |
| Anahtar limiti | 500 / dakika | Varsayılan olarak hesap limitine eşittir. Tek bir anahtar bu limitin tamamını kullanabilir. |
| Aynı anda çalışan istek | 20 | Hesapta aynı anda işlenen istek sayısıdır. Bu sayı aşıldığında fazla istekler kısa bir süre sırada bekler. Sıra da doluysa 429 hatası alınır. |
📌 Bu limitler sistemin bulut ortamı için geçerlidir ve kurulum türüne göre değişebilir. Limitler panelden düzenlenemez. Farklı bir limite ihtiyaç duyuyorsanız Destek ekibiyle iletişime geçin.
⏱️İstek Limitleri Hakkında Bilinmesi Gerekenler
Kayan dakika: İstek limiti saat başında sıfırlanmaz. Son 60 saniyedeki istekler dikkate alınır. Eski istekler bu zaman aralığının dışına çıktıkça yeni istekler için yer açılır.
Reddedilen istekler limite dahil edilmez: 429 hatası alan istekler limitten düşmez. Bu nedenle isteği yeniden göndermek limiti daha da artırmaz.
Önce anahtar limiti kontrol edilir: Kendi limiti dolan anahtarın istekleri hesap limitinden düşmez ve diğer anahtarları etkilemez.
Panel kullanıcılarının limiti ayrıdır: Panel üzerinden işlem yapan kullanıcıların kendi istek limitleri vardır. Bu limitler API anahtarlarının ortak hesabıyla paylaşılmaz.
🏷️Yanıt Başlıkları
API yanıtlarında aşağıdaki başlıklar üzerinden istek limitlerini takip edebilirsiniz:
| Başlık | Açıklama | Örnek |
|---|---|---|
| X-RateLimit-Limit | Dakikalık istek limitini gösterir. | 500 |
| X-RateLimit-Remaining | Mevcut zaman aralığında kalan istek sayısını gösterir. | 42 |
| X-RateLimit-Reset | Geçerli zaman aralığının bitmesine kalan saniyeyi gösterir. | 18 |
| Retry-After | Yalnızca 429 yanıtında gelir. Yeniden istek göndermeden önce beklenecek süreyi saniye cinsinden gösterir. | 7 |
🔗 Bir API Anahtarının Kullanım Süreci
Örnek: “Muhasebe entegrasyonu” adlı API anahtarı.
Yönetici yeni bir anahtar oluşturur. Yetki profili olarak Raporlama, marka olarak yalnızca Mağaza A, geçerlilik süresi olarak 90 gün seçilir.
Anahtar oluşturulduktan sonra ekranda bir kez görüntülenir. Yönetici anahtarı kopyalar, güvenli bir yere kaydettiğini onaylar ve pencereyi kapatır.
Muhasebe yazılımı her API isteğinde bu anahtarı gönderir. Yazılım Mağaza A'nın taleplerini okuyabilir ancak Mağaza B'nin taleplerine erişemez. Anahtarın “Son kullanım” bilgisi güncellenir.
Yazılım gece toplu veri aktarımı sırasında bir dakikada izin verilen istek sayısını aşarsa fazla istekler 429 hatası alır. Yazılım belirtilen süre kadar bekledikten sonra istekleri yeniden gönderebilir.
Muhasebe firması değiştiğinde yönetici eski anahtarı iptal eder. Birkaç saniye içinde bu anahtarla gönderilen istekler reddedilir. Yeni firma için ayrı bir API anahtarı oluşturulur.
💡 İpuçları
🔹Her entegrasyon için ayrı anahtar oluşturun: Aynı anahtarı birden fazla entegrasyonda kullanmak, gerektiğinde anahtarı iptal etmeyi zorlaştırabilir.
🔹İhtiyaç duyulan en dar yetki profilini seçin: Anahtarın güvenliği tehlikeye girerse oluşabilecek risk, profilin izinleriyle sınırlı kalır.
🔹Geçici işler için bitiş tarihi belirleyin: Ajans veya proje bazlı veri aktarımlarında süresiz anahtar kullanmayın.
🔹Default Key'i yeni anahtarlarla değiştirin: Eski anahtar Sahip yetki profiline sahiptir. Entegrasyonlarınızı yeni anahtarlara geçirdikten sonra Default Key'i iptal edin.
🔹Kullanılmayan anahtarları iptal edin: “90+ gündür kullanılmıyor” veya “Hiç kullanılmadı” olarak görünen anahtarları düzenli aralıklarla kontrol edin.
🔹429 yanıtını entegrasyon kodunuzda yönetin: Retry-After süresi kadar bekleyip yeniden istek gönderen bir entegrasyon, istek limitlerini daha kolay yönetebilir.
❓ Sık Sorulan Sorular
💬 API anahtarımı kaybettim, tekrar görüntüleyebilir miyim?
Hayır. API anahtarı geri çözülemeyecek şekilde saklanır ve sonradan görüntülenemez. Yeni bir anahtar oluşturup eski anahtarı iptal etmeniz gerekir.
💬 Eski API anahtarım çalışmaya devam edecek mi?
Evet. Eski anahtarınız listede “Default Key” adıyla yer alır ve aynı değerle çalışmaya devam eder. Mevcut entegrasyonunuzda değişiklik yapmanız gerekmez.
💬 İptal ettiğim anahtarı yeniden aktif hâle getirebilir miyim?
Hayır. İptal işlemi kalıcıdır. Yeniden bağlantı kurmak için yeni bir API anahtarı oluşturmanız gerekir.
💬 Anahtarı iptal ettim ancak birkaç saniye daha istek kabul edildi. Neden?
İptal işlemi tüm sistemde birkaç saniye içinde geçerli olur. En uzun durumda bu süre bir dakikayı bulabilir.
💬 Süresi dolan anahtar için yeni bir anahtar oluşturmam gerekir mi?
Hayır. Süresi dolan anahtarı düzenleyerek yeni bir bitiş tarihi belirleyebilirsiniz. Sürenin dolması, anahtarın iptal edildiği anlamına gelmez.
💬 Global Yönetici olarak Default Key'i neden iptal edemiyorum?
Default Key, Sahip yetki profiline sahiptir. Sahip ve Global Yönetici profiline sahip anahtarları yalnızca Sahip yönetebilir.
💬 İkinci bir API anahtarı oluşturdum ancak istek limitim neden artmadı?
Hesaptaki tüm API anahtarları ortak hesap limitini kullanır. Yeni anahtar oluşturmak toplam istek limitini artırmaz.
💬 Dakikada 500 isteği aşmadığım hâlde neden 429 hatası aldım?
Aynı anda çalışan istek sınırı aşılmış olabilir. Bu durumda hata mesajı “Too many concurrent requests” ifadesiyle başlar. Kısa bir süre bekleyip isteği yeniden gönderebilirsiniz.
💬 Sahip yetki profiline sahip anahtarla neden kullanıcı ekleyemiyorum?
Kullanıcı, yetki profili ve ödeme işlemleri, seçilen yetki profilinden bağımsız olarak yalnızca panel üzerinden yapılabilir. Bu işlemler API üzerinden denendiğinde 403 hatası döner.
💬 Bir yetki profilini neden silemiyorum?
İptal edilmemiş bir API anahtarı ilgili yetki profilini kullanıyor olabilir. Anahtarın süresi dolmuş olsa bile iptal edilmediyse profil silinemez. Önce anahtarı başka bir profile taşımanız veya iptal etmeniz gerekir.
💬 “Son kullanım” bilgisi neden hemen güncellenmiyor?
“Son kullanım” bilgisi en fazla dakikada bir güncellenir.
🧩 Örnek İdeal API Anahtarı Yapısı
Aşağıdaki örnekleri başlangıç noktası olarak kullanabilirsiniz. Yetki profillerini ve marka kapsamlarını kendi ihtiyaçlarınıza göre belirleyin.
| İhtiyaç | Anahtar Adı | Yetki Profili | Markalar | Geçerlilik |
|---|---|---|---|---|
| Muhasebe yazılımı yalnızca Mağaza A'nın taleplerini okuyacak. | Muhasebe entegrasyonu | Yalnızca okuma izni olan profil | Seçili: Mağaza A | 1 yıl |
| Ajans bir ay boyunca kampanya verisi aktaracak. | Ajans aktarımı Kasım | Gereken modüllere izin veren profil | Seçili: İlgili markalar | 30 gün |
| Şirketin kendi CRM sistemi tüm verileri senkronize edecek. | CRM senkron | Geniş kapsamlı profil | Tüm markalar | Süresiz |
✅ Kontrol Listesi
- Her entegrasyon için ayrı bir API anahtarı oluşturuldu mu?
- Anahtarın adı hangi entegrasyona ait olduğunu açıkça belirtiyor mu?
- Yetki profili yalnızca ihtiyaç duyulan izinleri içeriyor mu?
- “Tüm markalar” kapsamı gerçekten gerekli mi?
- Geçici entegrasyonlar için bitiş tarihi belirlendi mi?
- Kullanılmayan API anahtarları iptal edildi mi?
📚 İlgili Makaleler: Yetki Profilleri, Markalar
