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

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

API sağlayıcısı olarak API'lerinizi kullanıma sunmanız, geliştiricilere API'leriniz hakkında bilgi vermeniz, geliştiricileri kaydetmeniz ve geliştiricilerin uygulama kaydettirmesine izin vermeniz gerekir. Apigee Edge, geliştirme topluluğunuza bu hizmetleri sunmak için kendi özelleştirilmiş web sitenizi oluşturup yayınlamak üzere kullanabileceğ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ızla ilgili 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 API referans dokümanlarını portalınızda yayınlamak için kullanılabilir. API referans dokümanları, portalınızdaki API'ler sekmesinde otomatik olarak görünür. Geliştiriciler, API belgelerini portal üzerinden keşfeder ve canlı API istekleri gönderebilir. API istekleri bir tarayıcıdan geldiğinden, başarılı olmaları için CORS (Merkezler Arası Kaynak Paylaşımı) desteği gerekir. CORS desteği, Edge'deki "smartdocs" proxy'si tarafından sağlanır ("VALIDATE" kuruluşunda). Bu proxy, amaçlanan uç noktaya yapılan tüm SmartDocs isteklerinin proxy'si olarak çalışır. SmartDocs'u yüklediğinizde "smartdocs" proxy'si 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 gösterilir. API'niz özel bir ağdaysa ve portalınızdan SmartDocs'u kullanarak yapılan canlı API istekleri başarısız oluyorsa bu URL'yi değiştirmeniz gerekebilir.


Geliştirici Portalı, Edge ile nasıl iletiş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 depolar ve alır. Edge kuruluş bilgileri ve devadmin kimlik bilgileri, Yapılandırma -> Devportal menü komutu kullanılarak yapılandırılabilir.

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