Onay İstekleri
API Ürünü Erişim Ayarları
Kullanıcılar doğrudan API'ye erişim sağlamazlar; önce bir uygulama (Application) oluştururlar ve bu uygulama üzerinden API ürününe erişim talep ederler.
Bir uygulamanın API ürününe aboneliğinin onaya düşüp düşmeyeceği ürün seviyesinde değil, plan seviyesinde belirlenir. Kullanıcı abone olurken tek bir plan seçer ve o planın Onay Tipi geçerli olur:
- Otomatik (ekranda Otomatik onay rozeti): Abonelik hemen onaylanır ve kullanıcı erişim sağlar. Planların varsayılan onay tipi budur.
- Manuel (ekranda Onay Gerekli rozeti): Abonelik Bekliyor durumunda oluşturulur ve Onay İstekleri ekranında (aşağıda açıklanmıştır) ürün sahibinin onayını bekler.
Onay tipi, API ürününün Plans sekmesinde her plan için ayrı ayrı ayarlanır; ayrıntılar için API Ürünü sayfasına bakınız. Aynı üründe otomatik ve manuel onaylı planlar birlikte bulunabilir.
Mevcut bir aboneliğin planı değiştirildiğinde de hedef planın onay tipi geçerlidir: hedef plan Otomatik ise değişiklik hemen uygulanır; Manuel ise değişiklik onay bekler ve onaylanana kadar eski plan çalışmaya devam eder.
Eski sürümlerdeki ürün seviyesindeki "Access requests from applications" ayarı kullanımdan kaldırılmıştır; onay kararı yalnızca planın onay tipine göre verilir.
Portal Arayüzünde Kullanımı
Bir planın Onay Tipi Manuel olarak kaydedildikten sonra Portal'den aşağıdaki gibi test edilebilir.
API Portal Ekranında API'ler seçilerek ilgili product açılır ve aşağıdaki işlemler uygulanır.
Uygulama ekleme talebinde bulunulur.
Uygulama ismi ve bilgileri örnek resimdeki gibi oluşturulur veya düzenlenir.
App girildikten sonra save butonuna tıklanarak uygulamlar ve planlar görüntülenir.
İlgili uygulama ve ilgili plan seçilerek kayıt olunur.
Planların ve onay tiplerinin ayarlanması için API Ürünü sayfasındaki Plans sekmesini inceleyebilirsiniz. Görünürlük ayarları için aynı sayfadaki Visibility bölümüne bakabilirsiniz.
Yapılacak işlemler aşağıda sırasıyla açıklanmıştır.
API'yı kullanmak isteyen kullanıcı, Portal > APIs sayfasına giriş yapar. Bu sayfada kategorilere göre (Education, Store, Entertainment vb.) gruplanmış API ürünleri listelenir. Kullanıcı kullanmak istediği API ürününü seçer ve "Explore API" butonuna tıklar.
API ürün detay sayfasında "Applications" sekmesine tıklar. Eğer kayıtlı bir uygulama yoksa, "Bu API ürünü için kayıtlı uygulamanız yok" mesajı görünür.
"Create New App" butonuna tıklayarak açılan pop-up'ta:
- Uygulama adını ve açıklamasını girer
- "Save" butonuna tıklayarak uygulamayı oluşturur
"Kayıt için bir uygulama ve plan seçin" popup'ında:
- Oluşturduğu uygulamayı seçer
- Plan seçer (örn: Plus)
- "Register" butonuna tıklar
"Applications" sekmesinde kayıt durumu görüntülenir:
- Onay bekliyor: Ürün sahibinin onayı beklenir
- Onaylandı: API kullanıma hazır
- Reddedildi: Erişim talebi reddedildi
Kullanıcı tarafından bir erişim isteği oluşturulduğunda, bu istek Apinizer arayüzü üzerinde Apinizer API Manager > Yönetim (Administration) > Portal > Onay İstekleri (Approval Requests) sayfasına iletilir. Bu sayfada ürün sahipleri, kendilerine gelen erişim isteklerini görüntüleyebilir, inceleyebilir ve uygun gördükleri takdirde onay veya ret işlemini gerçekleştirebilirler. Aşağıda bu sayfa detaylı açıklanmıştır.
Onay İstekleri Ekranının Sekmeleri
Onay İstekleri ekranı aşağıdaki sekmelerden oluşur:
| Sekme | İçerik |
|---|---|
| API Ürün Uygulama Kaydı | Manuel onaylı planlara yapılan abonelik talepleri. Aşağıda açıklanmıştır. |
| Hesap/Geliştirici | Otomatik hesap onayı kapalıyken Portal'e yeni üye olan hesapların onay talepleri. Aşağıda açıklanmıştır. |
| Hesap Kuruluş Kaydı | Portal'e kayıt sırasında kuruluş bilgisi giren başvuruların onay talepleri. İncele ile açılan pencerede başvuru bilgileri görüntülenir; onaylarken hesabın yeni bir kuruluş oluşturularak mı yoksa mevcut bir kuruluşa bağlanarak mı ekleneceği seçilir. Reddederken başvurana isteğe bağlı bir mesaj gönderilebilir. |
| Prodüksiyon Talepleri | Yalnızca aktif portalın ayarlarında promotion etkinse görünür. Sandbox uygulamalarının prodüksiyona geçiş talepleri listelenir; İncele ile talep özeti ve yüklenen belgeler görüntülenip talep onaylanır veya ret gerekçesiyle reddedilir. Ayrıntılar için Uygulama Promote sayfasına bakınız. |
Onay İstekleri API Ürün Uygulama Kaydı
Seçilen planın Onay Tipi Manuel olduğunda, kullanıcıların kayıt talepleri; Apinizer API Manager > Yönetim (Administration) > Portal > Onay İstekleri (Approval Requests) Sayfasında listelenir.
| Alan | Açıklama |
|---|---|
| API Ürün (API Product) | Hangi API ürününe erişim talep edildiği |
| Hesap/Geliştirici (Account/Developer) | Talebi yapan kullanıcının e-posta adresi ve adı |
| Kurum (Organization) | Kullanıcının bağlı olduğu kuruluş |
| Uygulama (Application) | Hangi uygulama ile kayıt yapıldığı |
| Plan (Plan) | Seçilen abonelik planı ve detayları |
| Durum (Status) | Talebin durumu (Waiting, Approved, Rejected) |
Status sütunundaki "Waiting" (Bekliyor) butonuna tıklanır
"Confirm the operation" popup'ı açılır ve talep detayları görüntülenir:
- Account/Developer Information: Kullanıcı bilgileri (email, ad, organizasyon, telefon)
- API Product Information: API ürün adı ve başlığı
- Plan Information: Uygulama adı ve seçilen plan ve detayları
Admin, talebi değerlendirir ve karar verir:
- Approve: Talebi onaylar, kullanıcı API'ye erişim sağlar — aynı uygulamanın o an onaylı diğer tüm abonelikleriyle birlikte, uygulamanın ACL'deki erişim satırlarını yazar; bu, kimlik bilgisi olmayan bir uygulama için de geçerlidir; bkz. Uygulamanın Erişimi. Seçilen plan bir Limit Profili referansı taşıyorsa ve aynı uygulama için aynı plan ailesinden zaten aktif bir bağlama varsa, onay penceresi bunu bir uyarıyla bildirir; mevcut bağlama korunur, farklı profile geçmek isterseniz Profili Değiştir ile bilinçli bir geçiş yaparsınız. Onaylanan uygulamanın henüz hiçbir kimliği (ne eski bir kimlik bilgisi ne de bir API İstemcisi) yoksa, onayla birlikte uygulamanın ilk API İstemcisi otomatik olarak oluşturulur; sırrı bu ekranda gösterilmez — uygulama sahibi Portal'daki uygulama detayından ya da ürün sayfasından yeni sır üret (rotate) ile kullanılabilir bir sır alır.
- Reject: Talebi reddeder, kullanıcı erişim sağlayamaz.
Her iki durumda da kullanıcıya otomatik olarak bilgilendirme e-postası gönderilir.
Otomatik Onay Ayarı
API Portal varsayılan olarak otomatik onay olarak yapılandırılmıştır. Bu süreci yönetmek için aşağıdaki adımlar uygulanır.
Portal'e yeni üye olmak isteyen kullanıcıların onay sürecini Apinizer API Manager > Yönetim (Administration) > Portal > Ayarlar > Portal > Güvenlik (Security) sekmesindeki "Hesap/Geliştirici Otomatik Onayla (Auto Approve Account/Developers)" ayarını kontrol eder.
Bu ayar açıksa, admin doğrulamasına gerek kalmadan mail doğrulaması ile direkt hesaba giriş yapabilir.
Bu ayar kapalıysa, önce mail adresini doğrular daha sonra kayıt talebi Apinizer API Manager > Yönetim (Administration) > Onay İstekleri (Approval Requests) > Hesap/Geliştirici (Account/Developer) ekranına gelir.
| Alan | Açıklama / İşlem |
|---|---|
| Hesapları/Geliştiricileri Otomatik Onaylayın (Auto Approve Account/Developers) Ayar Kapalı (Not Active): | Kullanıcı kayıt formunu doldurur. Sistеm kullanıcıya doğrulama e-postası gönderir. Kullanıcı e-posta onayını tamamlar. Kayıt talebi Apinizer API Manager > Yönetim (Administration) > Onay İstekleri (Approval Requests) > Hesap/Geliştirici (Account/Developer) sekmesinde listelenir. Admin, talebi manuel olarak onaylar veya reddeder. |
| Hesapları/Geliştiricileri Otomatik Onaylayın (Auto Approve Account/Developers) Ayar Açık (Active): | Kullanıcı kayıt formunu doldurur. E-posta doğrulamasından sonra hesap otomatik olarak onaylanır. Kullanıcı hemen Portal'e giriş yapabilir. Admin onayına gerek kalmaz. Apinizer API Manager > Yönetim (Administration) > Onay İstekleri (Approval Requests) > Hesap/Geliştirici (Account/Developer) sekmesinde talep görünmez. Otomatik onaylanır. |
Onay İstekleri Hesap/geliştirici
Otomatik onay kapalıyken, admin Apinizer API Manager > Yönetim (Administration) > Onay İstekleri (Approval Requests) > Hesap/Geliştirici (Account/Developer) sekmesinde bekleyen kayıt taleplerini görüntüler. Her talep için şu bilgiler listelenir:
| Alan | Açıklama / İşlem |
|---|---|
| Email (Email) | Portal'e üye olan kullanıcının mail adresi görüntülenir. |
| Adı Soyadı (Full Name) | Portal'e üye olan kullanıcının adı soyadı görüntülenir. |
| Kurum (Organization) | Portal'e üye olan kullanıcının bağlı olduğu kurum görüntülenir. |
| Telefon Numarası (Phone) | Portal'e üye olan kullanıcının telefon numarası görüntülenir. |
| Onay Durumu (status) | Kullanıcı e-posta adresini doğruladıktan sonra "Hesap Onayı Gerekli" kısmı enable olur. Daha sonra "Onaylandı" veya "Reddedildi" durumlarından biri seçilir. (Confirmation Needed, Approved, Rejected) |
Admin, Kullanıcı mail adresini doğruladıktan sonra Status butonuna tıklayarak kullanıcı kaydını onaylar veya reddeder.
Her iki durumda da kullanıcıya otomatik olarak bilgilendirme e-postası gönderilir.
Otomatik bilgilendirme e-postalarını özelleştirmek için E-posta Şablonları linkini inceleyebilirsiniz.