6. Adım: Bir API yayınlayın

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

Bu adımda, aşağıdaki adımları uygulayarak portalda bir API yayınlayacaksınız:
1. OpenAPI spesifikasyonu oluşturma
2. Spesifikasyondan API proxy'si oluşturma
3. API ürünü oluşturma
4. API'yi portalınızda yayınlama

1. adım: OpenAPI spesifikasyonu oluşturun

Her OpenAPI spesifikasyonu, API yaşam döngüsü boyunca doğru bilgi kaynağı olarak kullanılır. Geliştirmeden yayınlamaya kadar API yaşam döngüsünün her aşamasında aynı spesifikasyon kullanılır.

OpenAPI spesifikasyonu oluşturmak için:

  1. Özellikler sayfasını açmak için sol gezinme çubuğunda Geliştirme > Özellikler'i seçin.
  2. + Spec > URL'yi İçe Aktar'ı tıklayın.
  3. İçe aktarma iletişim kutusuna aşağıdaki bilgileri girin:
  4. İçe aktarma adı: helloworld
  5. İçe aktarma URL'si: https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml

  6. İçe Aktar'ı tıklayın.

2. Adım: Spesifikasyondan API proxy'si oluşturma

API'yi açıklayan bir OpenAPI spesifikasyonundan API proxy'si oluşturun.

OpenAPI spesifikasyonundan API proxy'si oluşturmak için:

  1. İşlemler menüsünü görüntülemek için Spesifikasyonlar sayfasında imlecinizi helloworld spesifikasyonunun üzerine getirin.
  2. Spesifikasyondan API proxy'si oluşturmak için simgesini tıklayın.
    Proxy Oluştur sihirbazı açılır ve Ayrıntılar sayfası, OpenAPI spesifikasyonundaki değerlerle önceden doldurulur.
  3. Açıklama alanını şu şekilde düzenleyin: Merhaba dünya için API proxy'si.
  4. İleri'yi tıklayın.
  5. Politikalar sayfasında:

    • Güvenlik: Yetkilendirme bölümünde Geçir (yetkilendirme yok)'u seçin.
    • Güvenlik: Tarayıcı bölümünde CORS üstbilgileri ekle'yi seçin .

    Geçir ve CORS üstbilgileri ekle seçeneklerinin belirlendiği Proxy oluşturma sihirbazındaki Ortak politikalar sayfası

  6. İleri'yi tıklayın.

  7. Akışlar sayfasında tüm işlemlerin seçildiğinden emin olun ve Sonraki'yi tıklayın.
    Proxy Akışları Oluşturma

  8. Sanal Ana Makineler sayfasında tüm sanal ana makinelerin seçildiğinden emin olun ve Sonraki'yi tıklayın.

  9. Özet sayfasında, İsteğe Bağlı Dağıtım bölümünde dağıtmak istediğiniz ortamı seçin.

  10. Oluştur'u tıklayın.

Özet sayfasında, yeni API proxy'nizin başarıyla oluşturulduğu ve test ortamınıza dağıtıldığına dair bir onay görürsünüz.

3. Adım: API ürünü oluşturun

API tüketicilerinize sunmak istediğiniz API kaynaklarını içeren bir API ürünü oluşturun.

API ürünü oluşturmak için:

  1. API Ürünleri sayfasını açmak için sol gezinme çubuğunda Yayınla > API Ürünleri'ni seçin.
  2. + API Ürünü'nü tıklayın.
    Yeni Ürün sayfası görüntülenir.
  3. API ürününüz için Ürün Ayrıntıları'nı girin.
    Not: API ürününü yayınladığınızda Görünen Ad ve Açıklama alanları varsayılan olarak portalda gösterilir. Değerleri 4. Adım: API'yi portalınızda yayınlayın bölümünde düzenleyebilirsiniz.
    Alan Değer
    Ad Merhaba Dünya
    Görünen Ad Merhaba Dünya
    Açıklama Basit Merhaba Dünya örneği
    Ortam API proxy'sinin dağıtıldığı ortamı seçin.
    Erişim Herkese açık
    Erişim isteklerini otomatik olarak onaylama Etkin
    Kota (boş bırakın)
    İzin verilen OAuth kapsamları (boş bırakın)
  4. API ürününüze eklenecek API proxy'lerini tanımlamak için API kaynakları bölümünde Proxy ekle'yi tıklayın.
    API Kaynağı Ekle iletişim kutusu görüntülenir.
  5. API Proxy'yi (seçili değilse) tıklayın ve listeden Mock-Target-API'yi seçin.
  6. Ekle'yi tıklayın.
  7. API ürününü kaydetmek için Kaydet'i tıklayın.

    Tüm alanların ayarlandığını gösteren Hello World API ürünü

4. Adım: API'yi portalınızda yayınlayın

Müşterilerinizin API hakkında bilgi edinip kullanabilmesi için API'yi portalınızda yayınlayın.

API'yi portalınızda yayınlamak için:

  1. Portalınızdaki API'ler sayfasına gidin:
    1. Sol gezinme çubuğunda Yayınla > Portallar'ı seçin.
    2. Portalı açmak için İlk portalım satırını tıklayın.
    3. API'ler sayfasını görüntülemek için API kataloğu'nu tıklayın.
  2. +'yı tıklayın.
  3. Kataloga API ürünü ekle iletişim kutusunda Merhaba Dünya'yı seçin ve İleri'yi tıklayın.
  4. API ayrıntıları bölümünde aşağıdaki seçenekleri yapılandırın:
    • API'yi portalınızda yayınlamak için Yayınlandı (katalogda listelendi)'yi seçin.
    • Görünen resim için:
      1. Resim seç'i tıklayın.
      2. Resim seçin iletişim kutusunda mevcut resimler listesinden home-background.jpg dosyasını tıklayın.
      3. Seç'i tıklayın.
      4. Resmi önizleyin ve Seç'i tıklayın.
    • Kategoriler bölümünde Başlayın'ı girin ve Enter tuşuna basın.

    Diğer tüm değerleri varsayılan ayarlarında bırakın.

  5. OpenAPI spesifikasyonunuzun anlık görüntüsünden API referans dokümanlarını otomatik olarak oluşturmak için API dokümanları bölümünde:
    1. OpenAPI belgesi'ni seçin.
    2. Doküman seç'i tıklayın.
    3. Özelliklerim sekmesini seçin (seçili değilse).
    4. Özellikler listesinden helloworld'u seçin.
    5. Seç'i tıklayın.
  6. API ayrıntılarını kaydetmek için Kaydet'i tıklayın.

    Tüm alanların ayarlandığını gösteren Hello World API

API referans dokümanlarını görüntülemek için:

  1. Canlı portaldaki değişiklikleri görüntülemek için Canlı Portal'ı tıklayın (veya başka bir sekmede açıksa canlı portalı yenileyin).
  2. Yayınlanan API'yi görüntülemek için üst gezinme çubuğunda API'ler'i tıklayın.
  3. API referans dokümanlarını görüntülemek için Merhaba Dünya kartını tıklayın. API'nizi deneyin.

Bu API'yi deneyin paneliyle yayınlanan örnek hedef API


Tebrikler! Eğitimi başarıyla tamamladınız. Daha fazla bilgi edinmeye hazır mısınız? Entegre portalınızı oluşturma başlıklı makaleyi inceleyin.