Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Kullanıma hazır geliştirici portalı, uygulama geliştiricilerinizin API'lerinizi kullanacak uygulamaları kaydettirmesini, oturum açmasını ve yönetmesini sağlar.
Aşağıdaki bölümlerde, uygulama geliştiricilerin portalınızla nasıl etkileşimde bulunduğu açıklanmaktadır:
Uygulama geliştirici kaydı ve oturum açma işlemleri Edge'de nasıl izlenir?
Geliştirici kaydı ve portal oturum açma işlemleri, Edge'deki _apiportal özel özelliği kullanılarak izlenir.
Bir geliştirici kendi kendine kayıt yaptığında, _apiportal özel özelliği geliştirici yapılandırmasına eklenir ve geliştirici durumu, geliştiricinin portalda oturum açmadığını belirtmek için unverified olarak ayarlanır. Örneğin: {"status":"unverified","portals":{}}
Geliştirici bir portalda ilk kez oturum açtığında _apiportal özel özelliği, portal adını ve erişim zamanını izlemek için güncellenir ve geliştirici durumunu active olarak ayarlar. Geliştiricinin portalda her oturum açışında özel özellik, söz konusu portalın lastVisit değerini (sıfır zaman biçiminde) sıfırlayacak şekilde güncellenir. Örneğin: {"status":"active","portals":{"myorg-myportal":{"lastVisit":1480972935}}}
Uygulama geliştirici hesabına kaydolma
Uygulama geliştiricilerin API'lerinizi kullanabilmesi için öncelikle bir hesap oluşturarak kaydolmaları gerekir.
Bir uygulama geliştirici, portalınıza kaydolduğunda:
- Uygulama geliştirici bilgileri Edge'de oluşturulur ve depolanır. Geliştirici hesabı bilgileri nerede saklanıyor? bölümüne göz atın.
- Uygulama geliştirici, kayıtlı uygulama geliştiriciler listesinde görünür. Geliştiriciler sayfasını keşfetme sayfasına bakın.
Alternatif olarak, Uygulama geliştiricilerini kaydetme bölümünde açıklandığı gibi Edge kullanıcı arayüzünü kullanarak uygulama geliştiricilerini kendi adlarına kaydedebilirsiniz.
Yeni uygulama geliştiriciler, aşağıdaki şekilde portalınıza kendi kendilerine kaydolabilir:
- Portala gidin.
- Oturum aç'ı tıklayın.
Kaydol'u tıklayın.
Aşağıdaki iletişim kutusu görüntülenir.
Gerekli bilgileri girin (ad, soyadı ve e-posta adresi).
Create'i (Oluştur) tıklayın.
Aşağıdaki iletişim kutusu görüntülenir.
Portalı açmak ve kimliği doğrulanmış oturumu belirlemek için e-postadaki güvenli bağlantıyı tıklayın.
Portalınızda oturum açın
Uygulama geliştiriciler, portalınıza kaydolduktan sonra Oturum Açma sayfasını kullanarak oturum açar.
Bir uygulama geliştirici, bir portalda her oturum açtığında, geliştiricinin kimliğini doğrulamak için şifre gibi paylaşılan bir gizli anahtar kullanmak yerine, kimliğini doğrulamak ve portalla oturum başlatmak için güvenli bir bağlantı gönderilir.
Uygulama geliştiriciler aşağıdaki şekilde portalınızda oturum açabilir:
- Portala gidin.
- Oturum Aç'ı tıklayın.
- Hesapla ilişkili e-posta adresini girin.
Giriş'i tıklayın.
Aşağıdaki iletişim kutusu görüntülenir.
Portalı açmak ve kimliği doğrulanmış oturumu belirlemek için e-postadaki güvenli bağlantıyı tıklayın.
Uygulamaları kaydet
Uygulama geliştiriciler, portalda oturum açtıktan sonra, yayınladığınız API ürünlerini kullanacak şekilde uygulamaları aşağıdaki şekilde kaydedebilir:
- Kullanıcı açılır menüsünden Uygulamalarım'ı seçin.
- Yeni bir uygulama oluşturmak için + Uygulama'yı tıklayın.
- Uygulama Oluştur iletişim kutusunda uygulama için bir ad ve açıklama girin.
- Create'i (Oluştur) tıklayın.
- Uygulamadaki API ürünlerini aşağıda açıklandığı şekilde yönetin.
Bir uygulamadaki API ürünlerini yönetin
Uygulama geliştiriciler, uygulamalarındaki API ürünlerini yönetebilir. API ürünleri, uygulama ayrıntıları sayfasına eklenir. Bazı API ürünlerinde onay işlemi otomatik değildir. Beklemede durumu, erişim istenen ancak henüz verilmemiş bir API ürününü gösterir.
Uygulama geliştiriciler, bir uygulamadaki API ürünlerini portalınızdan aşağıdaki şekilde yönetebilir:
- Kullanıcı açılır menüsünden Uygulamalarım'ı seçin.
- Uygulamanın adını tıklayın.
- Ürünleri Yönet'i tıklayın.
Uygulamadan bir API ürününe erişimi etkinleştirmek veya devre dışı bırakmak için Erişim seçeneğini tıklayın.
Not: Uygulama geliştirici, Gizli veya Yalnızca dahili bir API ürününe erişimi devre dışı bırakırsa API ürünü uygulamadan kaldırılır ve Uygulamaları kaydetme ve API anahtarlarını yönetme bölümünde açıklandığı gibi, portal yöneticisi tarafından manuel olarak yeniden eklenmesi gerekir.
Henüz izin verilmeyen bir API ürünü için onay istemek üzere İste'yi tıklayın.
Kaydet'i tıklayın.
Bir uygulamanın API anahtarını görüntüleme
Uygulama geliştiriciler, bir uygulamanın API anahtarını portalınızdan aşağıdaki şekilde yönetebilir:
- Kullanıcı açılır menüsünden Uygulamalarım'ı seçin.
- Uygulamanın adını tıklayın.
- Anahtarlar bölümünde API anahtarını görüntüleyin.
- API anahtarı gizli anahtarını görüntülemek için Gizli Anahtarı Görüntüle'yi tıklayın.
- API anahtarının durumunun Onaylandı olduğunu onaylayın.
Bir uygulamanın API anahtarını döndürme
Uygulama geliştirici, bir uygulamanın API anahtarını düzenli aralıklarla veya olası bir sızıntı ya da güvenlik ihlaline karşı döndürebilir. Bir uygulama geliştirici bir API anahtarını döndürdüğünde, orijinal anahtarla aynı API ürün yetkilerine sahip yeni bir API anahtarı oluşturulur. Orijinal API anahtarı kullanımdan kaldırıldı olarak işaretlenmiştir ancak kullanımdan kaldırılana kadar etkin kalır. Kullanımdan kaldırılmış bir anahtarı devre dışı bırakarak kimlik bilgilerinin kabul edilmesini önleyebilirsiniz (bkz. Uygulama için API anahtarını devre dışı bırakma).
Uygulama geliştiriciler, portalınızdaki bir uygulamanın birincil API anahtarına aşağıdaki şekilde rotasyon uygulayabilir:
- Kullanıcı açılır menüsünden Uygulamalarım'ı seçin.
- Uygulamanın adını tıklayın.
- Anahtarlar bölümünde, işlemler menüsünü görüntülemek için imleci mevcut API anahtarının üzerine getirin.
- İşlemler menüsünü genişletmek için
öğesini tıklayın. - Döndür'ü tıklayın.
- İşlemi onaylamak için iletişim kutusunda Oluştur'u tıklayın.
- İsteğe bağlı olarak, aşağıda açıklandığı şekilde API anahtarını devre dışı bırakın.
Bir uygulama için API anahtarını devre dışı bırakma
Önceki bölümde açıklandığı gibi uygulama geliştirici bir API anahtarını döndürdüğünde, API anahtarı kullanımdan kaldırılmış olarak işaretlenir ancak siz kullanımdan kaldırırken etkin durumda kalır. Kullanımdan kaldırılan bir anahtarın kimlik bilgilerinin kabul edilmesini önlemek için anahtarı devre dışı bırakmanız gerekir.
Uygulama geliştiriciler, bir uygulamanın API anahtarını portalınızdan aşağıdaki şekilde devre dışı bırakabilir:
- Kullanıcı açılır menüsünden Uygulamalarım'ı seçin.
- Uygulamanın adını tıklayın.
- Anahtarlar bölümünde, kullanımdan kaldırılan anahtarların listesini görüntülemek için Anahtar geçmişi'ni tıklayın.
- İşlemler menüsünü görüntülemek için imleci devre dışı bırakmak istediğiniz kullanımdan kaldırılmış API anahtarının üzerine getirin.
- İşlemler menüsünü genişletmek için öğesini tıklayın.
- Devre dışı bırak'ı tıklayın.
- İşlemi onaylamak için Devre dışı bırak'ı tıklayın.
Anahtarın durumu, İptal edildi olarak güncellenir.
Uygulama ayrıntılarını düzenle
Uygulama geliştiriciler, uygulama ayrıntılarını aşağıdaki şekilde düzenleyebilir:
- Kullanıcı açılır menüsünden Uygulamalarım'ı seçin.
- Uygulamanın adını tıklayın.
- Ad veya Açıklama alanlarını düzenleyin.
- Kaydet'i tıklayın.
Uygulama silinir ve Uygulamalarım listesinden kaldırılır.
Uygulama silme
Uygulama geliştiriciler, bir uygulamayı aşağıdaki şekilde portalınızdan silebilir:
- Kullanıcı açılır menüsünden Uygulamalarım'ı seçin.
- Uygulamanın adını tıklayın.
- Sayfanın sağ üst köşesindeki sil'i tıklayın.
Uygulama silinir ve Uygulamalarım listesinden kaldırılır.