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

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

Bu adımda, aşağıdaki adımları uygulayarak portalda bir API yayınlayacaksınız:
1. OpenAPI Belirtimi Oluşturma
2. Spesifikasyondan API proxy'si oluşturma
3. Bir API ürünü oluşturun
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 bilgi kaynağı işlevi görür. API yaşam döngüsünün, geliştirmeden yayınlamaya kadar her aşamasında aynı spesifikasyon kullanılır.

OpenAPI Belirtimi oluşturmak için:

  1. Özellikler sayfasını açmak için sol gezinme çubuğunda Geliştir > Özellikler'i seçin.
  2. + Özellikler > 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. Import'u (İçe aktar) tıklayın.

2. Adım: Özelliklerden bir API Proxy'si oluşturun

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

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

  1. Özellikler sayfasında, imleci helloworld spesifikasyonunun üzerine getirerek işlemler menüsünü görüntüleyin.
  2. Spesifikasyondan API proxy'si oluşturmak için simgesini tıklayın.
    Proxy Oluşturma sihirbazı açılır ve Ayrıntılar sayfası, OpenAPI Specification'dan alınan değerler kullanılarak önceden doldurulur.
  3. Açıklama alanını şu şekilde düzenleyin: hello world için API proxy'si.
  4. Sonraki'yi tıklayın.
  5. Politikalar sayfasında:

    • Güvenlik: Yetkilendirme bölümünde Geçiş (yetkilendirme yok) seçeneğini belirleyin.
    • Güvenlik: Tarayıcı bölümünde, CORS üstbilgileri ekle'yi seçin .

    Create Proxy sihirbazında, Passthrough ve Add CORS üstbilgileri seçili haldeki yaygın politikalar sayfası

  6. Sonraki'yi tıklayın.

  7. Akışlar sayfasında tüm işlemlerin seçili olduğundan emin olun ve İleri'yi tıklayın.
    Proxy Akışları Oluşturma

  8. Virtual Hosts (Sanal Ana Bilgisayarlar) sayfasında tüm sanal ana makinelerin seçili olduğundan emin olun ve Next (İleri) seçeneğini tıklayın.

  9. Özet sayfasında, İsteğe Bağlı Dağıtım altında dağıtım yapmak istediğiniz ortamı seçin.

  10. Create'i (Oluştur) 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: Bir API ürünü oluşturun

API tüketicilerinize göstermek 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: Görünen Ad ve Açıklama alanları, API ürününü yayınladığınızda varsayılan olarak portalda görüntülenir. 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 hello world örneği
    Ortam API proxy'sinin dağıtılacağı ortamı seçin.
    Erişim Herkese açık
    Erişim isteklerini otomatik olarak onayla Etkin
    Kota (boş bırakın)
    İzin Verilen OAuth Kapsamları (boş bırakın)
  4. API kaynakları bölümünde, API ürününüze eklenecek API proxy'lerini tanımlamak için Proxy ekle'yi tıklayın.
    API Kaynağı Ekle iletişim kutusu görüntülenir.
  5. API Proxy'yi tıklayın (seçili değilse) ve listeden Örnek-Hedef-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 hakkında bilgi edinmesini ve kullanmasını sağlamak için API'yi portalınızda yayınlayın.

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

  1. Portalınızda API'ler sayfasına gidin:
    1. Sol gezinme çubuğunda Yayınla > Portallar'ı seçin.
    2. Portalı açmak için My first portal (İ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. Kataloğa bir API ürünü ekleyin iletişim kutusunda Hello World'ü seçin ve Sonraki'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ıza yayınlamak için Yayınlandı (katalogda listelenir) seçeneğini belirleyin.
    • Görünen resim için:
      1. Resim seç'i tıklayın.
      2. Resim seçin iletişim kutusundaki mevcut resimler listesinden home-background.jpg seçeneğini tıklayın.
      3. Select'i (Seç) tıklayın.
      4. Resmi önizleyin ve Seç'i tıklayın.
    • Kategoriler için 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 Belirtiminizin anlık görüntüsünden API referans belgelerini otomatik olarak oluşturmak için API belgeleri bölümünde:
    1. OpenAPI dokümanı'nı seçin.
    2. Doküman Seç'i tıklayın.
    3. Spesifikasyonlarım sekmesini seçin (önceden seçilmemişse).
    4. Özellikler listesinden helloworld seçeneğini belirleyin.
    5. Select'i (Seç) tıklayın.
  6. API ayrıntılarını kaydetmek için Kaydet'i tıklayın.

    Hello World API'de tüm alanlar ayarlandı

API referans belgelerini 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 üstteki gezinme çubuğunda API'ler seçeneğini tıklayın.
  3. API referans belgelerini görüntülemek için Hello World 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 sayfasına gidin.