Portal Uygulamaları
Portal Uygulaması, API Portal'dan bir hesap/geliştirici tarafından oluşturulan ve API ürünlerine abone olmak, API anahtarı almak için kullanılan kayıttır. Bu sayfa, Portal Uygulamalarının Kimlik menüsünden yönetilmesini anlatır.
Portal Uygulamaları iki farklı menüden erişilebilir:
- Kimlik > Uygulamalar: Uygulamaların kimlik bilgisi/API anahtarı tarafına odaklanan görünüm. Bu görünümde API ürünü/plan bilgileri gösterilmez.
- Portal > Uygulamalar: Aynı kayıtların Portal yönetimi bağlamındaki görünümü; API ürünü abonelikleri de burada yer alır.
Her iki menüden de aynı uygulama kayıtlarına ulaşılır; aşağıda anlatılan oluşturma, düzenleme, silme ve ek bilgi (metadata) işlemleri her iki görünümde de geçerlidir.
Uygulama Listesi
Listede uygulama adı, bağlı olduğu hesap/geliştirici, kuruluş, oluşturulma tarihi ve referans numarası (Reference Id) görüntülenir. Listedeki bir uygulamaya tıklandığında uygulamanın detay sayfası açılır.
Uygulama Oluşturma / Düzenleme
Yeni bir uygulama oluşturmak için listenin üstündeki Oluştur düğmesi kullanılır. Var olan bir uygulamayı düzenlemek için işlemler menüsündeki Düzenle seçeneği kullanılır.
| Alan | Açıklama |
|---|---|
| App Adı (Name) | Uygulamanın adıdır. Zorunlu alandır. |
| Reference Id | Uygulamayı dış sistemlerde tekil olarak tanımlamak için kullanılan referans değeridir. Uygulama oluşturulurken otomatik olarak üretilir, gerekirse elle değiştirilebilir. Zorunlu alandır. |
| Açıklama (Description) | Uygulama ile ilgili açıklama bilgisidir. |
| Hesap/Geliştirici (Account) | Uygulamanın bağlı olduğu Portal hesabı/geliştiricisidir. Zorunlu alandır. |
Uygulama Detayı
Uygulama detay sayfasında Genel Bakış ve Ek Bilgiler olmak üzere iki sekme yer alır.
Genel Bakış
Bu sekmede uygulamanın adı, referans numarası, bağlı olduğu hesap/geliştirici, kuruluş ve oluşturulma tarihi görüntülenir. Ayrıca uygulamaya tanımlı API anahtarları listelenir: anahtarın kendisi, aktif/pasif durumu, oluşturulma ve (varsa) geçerlilik bitiş tarihi. Düzenleme ekranından uygulama için yeni bir API anahtarı üretilebilir veya var olan bir anahtar iptal edilebilir.
Portal menüsünden açılan görünümde ayrıca uygulamanın abone olduğu API Ürünleri ve bunlara ait plan/onay durumu listelenir. Kimlik menüsünden açılan görünümde bu bilgi gösterilmez.
Ek Bilgiler (Metadata)
Bu sekmede uygulamaya özel anahtar/değer (key-value) çiftleri tanımlanabilir. Karmaşık veri tipleri desteklenmez; yalnızca düz metin değerler girilebilir.
| Alan | Açıklama |
|---|---|
| Anahtar (Key) | Ek bilgi kaydının anahtarıdır. Zorunlu ve uygulama içinde tekildir; aynı anahtar birden fazla kez kullanılamaz. |
| Değer (Value) | Anahtara karşılık gelen değerdir. |
| Gizli (Secret) | Etkinleştirildiğinde değer şifreli olarak saklanır ve listelerde maskelenerek gösterilir. |
Yeni bir kayıt eklemek için satır başındaki + düğmesi, bir kaydı kaldırmak için satır sonundaki silme düğmesi kullanılır. Değişiklikler Kaydet düğmesiyle uygulanır.
Uygulama Silme
Bir uygulama silindiğinde uygulamaya bağlı API anahtarları ve abonelik kayıtları da birlikte kaldırılır. Silme işlemi onay penceresi ile teyit edilir.
Uygulama oluşturma, düzenleme ve silme işlemleri sistem yöneticisi ile portal yönetimi/geliştirici yetkisine sahip roller tarafından yapılabilir.
İlgili Sayfalar
Uygulamaya erişim izni verilen kimlik bilgileri ve bunların API Proxy bazlı erişim ayarları için Erişim Kontrolü sayfasını, uygulamanın bağlı olduğu hesabın kimlik bilgisi kayıtları için Kimlik Bilgileri sayfasını inceleyebilirsiniz.