Spesifikasyonlarınızı yönetin

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

Apigee Edge, OpenAPI spesifikasyonlarınızı depolayabileceğiniz bir yer sağlar. OpenAPI spesifikasyonlarınızı aşağıdaki bölümlerde açıklandığı şekilde yönetin.

OpenAPI Özellikleri hakkında daha fazla bilgi için OpenAPI Spesifikasyonu nedir? konusuna bakın.

Özellikler listesini inceleyin

Özellikler listesine erişmek için:

  1. apigee.com/edge adresinde oturum açın.
  2. Bir kuruluş seçin.
  3. Yan gezinme menüsünde Geliştir > Özellikler'i seçin.

Özellikler ve klasörlerin geçerli listesi görüntülenir.

Özellikler listesi

Önceki şekilde belirtildiği gibi, spesifikasyon listesinden şunları yapabilirsiniz:

Yeni bir OpenAPI Belirtimi oluşturma

Yeni bir OpenAPI Belirtimi oluşturmak için:

  1. Yan gezinme çubuğunda Geliştir > Özellikler'i tıklayın.
  2. + Özellikler'i tıklayın.
  3. Açılır menüde Yeni Spesifikasyon'u tıklayın. Teknik özellik düzenleyici açılır.
  4. Örnek spesifikasyonunu kendi OpenAPI Specification ayrıntılarınızla değiştirin.
    Spesifikasyon düzenleyicisini kullanarak spesifikasyon oluşturma başlıklı makaleyi inceleyin.
  5. Belirtimi kaydetmek için Kaydet'i tıklayın.
  6. İstendiğinde spesifikasyon için bir ad girin.
  7. Kaydet'i tıklayın.

OpenAPI Spesifikasyonunu İçe Aktarma

OpenAPI Spesifikasyonunu içe aktarmak için:

  1. Yan gezinme çubuğunda Geliştir > Özellikler'i tıklayın.
  2. + Özellikler'i tıklayın.
  3. Açılır menüde aşağıdaki seçeneklerden birini tıklayın:
    • URL'yi içe aktararak spesifikasyonu bir URL'den içe aktarabilirsiniz. İstendiğinde adı ve URL'yi belirtin.
    • Spesifikasyon için yerel dizininize göz atmak üzere içe aktarma dosyası oluşturun.
      Bu özellik listeye eklenir.
  4. Spesifikasyon düzenleyicisinde spesifikasyonları görüntülemek ve düzenlemek için spesifikasyonun adını tıklayın.
    Spesifikasyon düzenleyicisini kullanarak spesifikasyon oluşturma bölümünü inceleyin.

Mevcut bir OpenAPI Spesifikasyonunu düzenleme

Mevcut bir OpenAPI Specification'ı açmak için:

  1. Yan gezinme çubuğunda Geliştir > Özellikler'i tıklayın.
  2. Teknik özellik listesinde spesifikasyonla ilişkilendirilmiş satırı tıklayın.
  3. Teknik özellik düzenleyicide spesifikasyonu düzenleyin.
    Spesifikasyon düzenleyicisini kullanarak spesifikasyon oluşturma başlıklı makaleyi inceleyin.

Özellikler listesindeki bir spesifikasyondan API proxy'si oluşturma

Apigee Edge ile API proxy'lerinizi, tasarlayıp spesifikasyon düzenleyicide kaydettiğiniz OpenAPI Specifications bölümünden oluşturabilirsiniz. Yalnızca birkaç tıklamayla Apigee Edge'de otomatik olarak oluşturulan yollar, parametreler, koşullu akışlar ve hedef uç noktaları içeren bir API proxy'sine sahip olursunuz. Ardından OAuth güvenliği, hız sınırlama ve önbelleğe alma gibi özellikler ekleyebilirsiniz.

OpenAPI Specification'dan bir API proxy'si oluşturduktan sonra, spesifikasyon değiştirilirse uygulanan değişiklikleri yansıtmak için API proxy'sini manuel olarak değiştirmeniz gerekir. Bir spesifikasyonda değişiklik yaparsam ne olur? bölümüne göz atın.

Spesifikasyon listesindeki bir OpenAPI Specification'dan API proxy'si oluşturmak için:

  1. Yan gezinme menüsünde Geliştir > Özellikler'i seçin.
  2. Gerekirse OpenAPI Specification'ı içeren klasöre gidin.
  3. İşlem menüsünü görüntülemek için imlecinizi API proxy'si oluşturmak istediğiniz OpenAPI Specification'ın üzerine getirin.
  4. proxy oluştur simgesini tıklayın. Proxy Oluşturma sihirbazı açılır ve Proxy ayrıntıları sayfası, aşağıdaki şekilde gösterildiği gibi OpenAPI Specification'dan değerler kullanılarak önceden doldurulur.
    proxy sihirbazı oluşturma
  5. İleri'yi tıklayın.
  6. OpenAPI Specification'dan API proxy'si oluşturma bölümünde açıklandığı gibi, Proxy Oluşturma sihirbazının kalan sayfalarında ilerleyin. (8. adımdan başlayın.)

Spesifikasyonu yeniden adlandırma

Bir spesifikasyonu yeniden adlandırmak için:

  1. Yan gezinme menüsünde Geliştir > Özellikler'i seçin.
  2. Gerekirse spesifikasyonu içeren klasöre gidin.
  3. İşlemler menüsünü görüntülemek için imleci, yeniden adlandırmak istediğiniz spesifikasyonun üzerine getirin.
  4. Belirtimi yeniden adlandır simgesini tıklayın.
  5. Spesifikasyon adını düzenleyin.
  6. Düzenlemeleri kaydetmek için Yeniden adlandır'ı, iptal etmek için ise İptal'i tıklayın.

Belirtimi bir klasöre taşıma

Yönetimi ve güvenliği kolaylaştırmak için spesifikasyonlarınızı klasörler halinde düzenleyebilirsiniz. Belirtimi bir klasöre taşımak için Klasörleri kullanarak spesifikasyonları düzenleme sayfasına bakın.

Spesifikasyon silme

Artık ihtiyaç duyulmayan veya geçersiz hale gelen spesifikasyonları dosya mağazasından silebilirsiniz.

Bir spesifikasyonu silmek için:

  1. Yan gezinme menüsünde Geliştir > Özellikler'i seçin.
  2. İşlemler menüsünü görüntülemek için imleci silmek istediğiniz spesifikasyonun üzerine getirin.
  3. Sil simgesi simgesini tıklayın.
  4. İstendiğinde silme işlemini onaylamak için Sil'i tıklayın.
  5. Artık ihtiyaç duyulmayan ilgili yapıları silin.