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 Spesifikasyonları hakkında daha fazla bilgi için OpenAPI Spesifikasyonu nedir? başlıklı makaleyi inceleyin.

Teknik özellikler listesini inceleme

Ö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 > Spesifikasyonlar'ı seçin.

Mevcut spesifikasyon ve klasör listesi gösterilir.

Özellik listesi

Önceki şekilde vurgulandığı gibi, spesifikasyonlar listesinden şunları yapabilirsiniz:

Yeni bir OpenAPI spesifikasyonu oluşturma

Yeni bir OpenAPI spesifikasyonu oluşturmak için:

  1. Yan gezinme çubuğunda Geliştir > Spesifikasyonlar'ı tıklayın.
  2. + Spec'i tıklayın.
  3. Açılır menüden Yeni Şartname'yi tıklayın. Şartname düzenleyici açılır.
  4. Örnek spesifikasyonu kendi OpenAPI Spesifikasyonu ayrıntılarınızla değiştirin.
    Spesifikasyon düzenleyiciyi kullanarak spesifikasyon oluşturma başlıklı makaleyi inceleyin.
  5. Spesifikasyonu kaydetmek için Kaydet'i tıklayın.
  6. İstendiğinde spesifikasyon için bir ad girin.
  7. Kaydet'i tıklayın.

OpenAPI spesifikasyonu içe aktarma

OpenAPI spesifikasyonu içe aktarmak için:

  1. Yan gezinme çubuğunda Geliştir > Spesifikasyonlar'ı tıklayın.
  2. + Spec'i tıklayın.
  3. Açılır menüden aşağıdaki seçeneklerden birini tıklayın:
    • Spesifikasyonu bir URL'den içe aktarmak için URL'yi içe aktar'ı tıklayın. İstendiğinde adı ve URL'yi belirtin.
    • Spesifikasyonu bulmak için yerel dizininize göz atmak üzere Dosyayı içe aktar'ı tıklayın.
      Spesifikasyon listeye eklenir.
  4. Spesifikasyon düzenleyicide görüntülemek ve düzenlemek için spesifikasyonun adını tıklayın.
    Spesifikasyon düzenleyiciyi kullanarak spesifikasyon oluşturma başlıklı makaleyi inceleyin.

Mevcut bir OpenAPI Spesifikasyonu'nu düzenleme

başlıklı makaleyi inceleyin.

Mevcut bir OpenAPI Spesifikasyonu'nu açmak için:

  1. Yan gezinme çubuğunda Geliştir > Spesifikasyonlar'ı tıklayın.
  2. Şartname listesinde, şartnameyle ilişkili satırı tıklayın.
  3. Şartnameyi şartname düzenleyicide düzenleyin.
    Spesifikasyon düzenleyiciyi kullanarak spesifikasyon oluşturma başlıklı makaleyi inceleyin.

Spesifikasyon listesindeki bir spesifikasyondan API proxy'si oluşturma

Apigee Edge ile, spec düzenleyicide tasarlayıp kaydettiğiniz OpenAPI spesifikasyonlarından API proxy'lerinizi oluşturabilirsiniz. Yalnızca birkaç tıklamayla, Apigee Edge'de yollar, parametreler, koşullu akışlar ve hedef uç noktalar otomatik olarak oluşturulmuş bir API proxy'niz olur. Ardından, OAuth güvenliği, sıklık sınırlama ve önbelleğe alma gibi özellikler ekleyebilirsiniz.

Bir OpenAPI spesifikasyonundan 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 spesifikasyonu değiştirirsem ne olur? başlıklı makaleyi inceleyin.

Belirtim listesindeki bir OpenAPI belirtiminden API proxy'si oluşturmak için:

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

Bir spesifikasyonu yeniden adlandırma

Bir spesifikasyonu yeniden adlandırmak için:

  1. Yan gezinme menüsünde Geliştir > Spesifikasyonlar'ı 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. Şartnameyi yeniden adlandırma simgesini tıklayın.
  5. Şartname adını düzenleyin.
  6. Düzenlemeleri kaydetmek için Yeniden adlandır'ı, iptal etmek için İptal'i tıklayın.

Bir spesifikasyonu klasöre taşıma

Yönetimi ve güvenliği kolaylaştırmak için spesifikasyonlarınızı klasörler halinde düzenleyebilirsiniz. Bir spesifikasyonu klasöre taşımak için Klasörleri kullanarak spesifikasyonları düzenleme başlıklı makaleyi inceleyin.

Şartname silme

Artık ihtiyaç duyulmayan veya geçersiz hale gelen spesifikasyonları dosya deposundan silebilirsiniz.

başlıklı makaleyi inceleyin.

Bir spesifikasyonu silmek için:

  1. Yan gezinme menüsünde Geliştir > Spesifikasyonlar'ı 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. İstemde silme işlemini onaylamak için Sil'i tıklayın.
  5. Artık gerekli olmayan ilgili yapıları silin.