Onay İstekleri

Genel Bakış

Onay İstekleri (Approval Requests) modülü, API ürünlerine erişim taleplerinin ve Portal arayüzünde yeni üyeliklerin yönetildiği bölümdür ve iki ana başlık altında incelenir:

Varsayılan olarak, API Ürün Uygulama Kaydı ve Hesap/Geliştirici talepleri otomatik olarak onaylanır. Bu modüllerin manuel onay sürecine dahil edilmesi için API Ürünü Erişim Ayarları ve Onay İstekleri yapılandırmalarının gerçekleştirilmesi gerekmektedir.

İçindekiler

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.

API ürünleri varsayılan olarak herkese açık (public) yapılandırılmıştır. Bu durumda, bir kullanıcı uygulaması üzerinden API'ye erişim talep ettiğinde, istek otomatik olarak onaylanır ve kullanıcı hemen erişim sağlar.

Ancak ürün sahibi, Apinizer API Manager > Yönetim (Administration) > Portal > API Ürünleri (API Products) sayfasında yapılandır (configure) ile her bir ürün için bulunan "Access requests from applications" (Uygulamalardan gelen erişim istekleri) ayarını değiştirebilmektedir. Bu ayar aşağıdaki resimde gösterilmiştir:

Bu ayar ürün (Product) bazlı yapılandırılır ve her API ürünü bağımsız olarak yönetilebilir. Bir üründeki değişiklik diğer ürünleri etkilemez.

Seçenek işaretli olduğunda: Uygulamalardan gelen erişim istekleri otomatik olarak onaylanır (varsayılan durum).
Seçenek işaretli olmadığında: Kullanıcılar otomatik erişim sağlayamaz. Bu durumda kullanıcı, uygulaması üzerinden erişim isteğinde bulunur ve ürün sahibinin manuel onayını beklemesi gerekir.

Bu ayar sayesinde ürün sahibi, API ürününe kimlerin erişebileceğini kontrollü bir şekilde yönetebilir.

Portal Arayüzünde Kullanımı

Otomatik uygulama onayı kapatılıp 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.

Plan seçeneklerinin ayarlanması için API ürün sayfasındaki APIs Visibility by Organization sayfasını inceleyebilirsiniz.

Yapılacak işlemler aşağıda sırasıyla açıklanmıştır.

Adım	Açıklama / İşlem
Adım 1: API Portal Sayfasına Giriş ve Ürün Seçimi	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.
Adım 2: API Ürün Detay Sayfası ve Uygulama Oluşturma	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
Adım 3: Kayıt olma	"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
Adım 4: Kayıt Durumunu Görüntüleme	"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 API Ürün Uygulama Kaydı

API ürününe erişim için otomatik onay kapalı 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)

Adım

Açıklama / İşlem

Adım 1: Onay Bekleyen Talebi Seçme

Status sütunundaki "Waiting" (Bekliyor) butonuna tıklanır

Adım 2: Talep Detaylarını Görüntüleme

"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ı

Adım 3: Karar Verme

Admin, talebi değerlendirir ve karar verir:

Approve: Talebi onaylar, kullanıcı API'ye erişim sağlar.
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 (Settings) > 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.