Drupal Tabanlı Geliştirici Portalı Sorun Gidermeye Genel Bakış

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
bilgi

API sağlayıcı olarak API'lerinizi kullanıma sunmak, geliştiricileri API'leriniz hakkında eğitmek, geliştiricileri kaydetmek ve geliştiricilerin uygulamaları kaydetmesine izin vermek için bir yönteme ihtiyacınız vardır. Apigee Edge, geliştirme topluluğunuza bu hizmetleri sunmak için kendi özelleştirilmiş web sitenizi oluşturup başlatabileceğiniz bir Developer Services portalı sağlar. Geliştirici portalları hakkında daha fazla bilgi edinmek için Geliştirici portalı nedir? başlıklı makaleyi inceleyin.

Aşağıdaki bölümlerde, geliştirici portalınızdaki sorunları gidermeden önce anlamanız gereken temel kavramlar açıklanmaktadır.

SmartDocs'un işleyiş şekli

API'nizi açıklayan bir OpenAPI (JSON veya YAML) ya da WADL spesifikasyonu SmartDocs'a aktarılabilir ve portalınızda API referans belgeleri yayınlamak için kullanılabilir. API referans belgeleri, portalınızdaki API'ler sekmesinde otomatik olarak gösterilir. Geliştiriciler, portal üzerinden API belgelerini keşfedebilir ve canlı API istekleri gönderebilir. API istekleri tarayıcıdan kaynaklandığı için başarılı olabilmeleri için CORS (Merkezler Arası Kaynak Paylaşımı) desteği gerekir. CORS desteği, Edge'deki ("VALIDATE" kuruluşunda) "smartdocs" proxy'si tarafından sağlanır. Bu proxy, amaçlanan uç noktaya yapılan tüm SmartDocs istekleri için proxy görevi görür. "smartdocs" proxy'si, SmartDocs'u yüklediğinizde oluşturulur.

Örneğin:

Smartdocs proxy'sinin URL'si, Yapılandırma -> SmartDocs -> SmartDocs proxy URL'si bölümünde yapılandırılabilir bir özellik olarak sunulur. API'niz özel bir ağdaysa ve portalınızdan SmartDocs kullanılarak yapılan canlı API istekleri başarısız oluyorsa bu URL'yi değiştirmeniz gerekebilir.


Geliştirici Portalı, Edge ile Nasıl İletişim Kurar?

Geliştirici portalı, Smartdocs, geliştiriciler, ürünler ve geliştirici uygulamaları dahil olmak üzere gösterdiği bilgilerin çoğunu Edge'den saklar ve alır. Edge kuruluş bilgileri ve devadmin kimlik bilgileri, Configuration -> Devportal menü komutu kullanılarak yapılandırılabilir.

Daha fazla bilgi için Portal ile Edge arasında iletişim başlıklı makaleyi inceleyin.