Langkah 6: Memublikasikan API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Pada langkah ini, Anda akan memublikasikan API ke portal dengan melakukan langkah-langkah berikut:

  1. Membuat proxy API dari spesifikasi
  2. Membuat produk API
  3. Memublikasikan API ke portal

Langkah 1: Buat Proxy API dari spesifikasi

Membuat proxy API dari Spesifikasi OpenAPI yang menjelaskan API.

Untuk membuat proxy API dari Spesifikasi OpenAPI:

  1. Di UI Apigee, pilih Develop > Proxy API di menu navigasi sebelah kiri untuk membuka halaman proxy API.

  2. Klik Create New.
    Tambahkan proxy API

    Wizard Create Proxy akan terbuka dan meminta Anda untuk memilih jenis proxy API yang akan dibuat.

  3. Di bagian Reverse Proxy (paling umum), klik Use OpenAPI Spec. Gunakan Spesifikasi OpenAPI

    Dialog Use OpenAPI Spec akan ditampilkan.

  4. Salin dan tempel URL berikut di kolom OpenAPI Spec URL pada tab URL:

    https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml

  5. Klik Pilih.
    Wizard Create Proxy akan terbuka dan halaman Proxy details telah diisi sebelumnya menggunakan nilai dari Spesifikasi OpenAPI.

    Halaman detail proxy di wizard Create Proxy, yang telah diisi otomatis dengan konten

  6. Edit kolom Description sebagai berikut: Proxy API untuk halo dunia.

  7. Klik Next.

  8. Di halaman Kebijakan:

    • Di bagian Keamanan: Otorisasi, pilih Lulus (tanpa otorisasi).
    • Di bagian Keamanan: Browser, pilih Tambahkan header CORS .

    Halaman kebijakan umum di wizard Create Proxy dengan header Passthrough dan Add CORS dipilih

  9. Klik Next.

  10. Di halaman Flows, pastikan semua operasi dipilih, lalu klik Next.
    Membangun Alur Proxy

  11. Di halaman Ringkasan, pilih lingkungan yang ingin di-deploy di bagian Deployment Opsional.

  12. Klik Create and deploy.

Di halaman Summary, Anda akan melihat konfirmasi bahwa proxy API baru telah berhasil dibuat dan di-deploy ke lingkungan yang dipilih.

Langkah 2: Buat produk API

Buat produk API yang berisi resource API yang ingin Anda ekspos kepada konsumen API.

Untuk membuat produk API:

  1. Di UI Apigee, pilih Publikasikan > Produk API di menu navigasi sebelah kiri untuk membuka halaman Produk API.
  2. Klik +CREATE.
    Halaman Produk ditampilkan.
  3. Masukkan Product Details untuk produk API Anda.
    Catatan: Kolom Nama Tampilan dan Deskripsi ditampilkan di portal saat Anda memublikasikan produk API secara default. Anda dapat mengedit nilai ini di Langkah 3: Publikasikan API ke portal Anda.
    Kolom Nilai
    Nama Halo Dunia
    Nama Tampilan Halo Dunia
    Deskripsi Contoh halo dunia sederhana
    Lingkungan Pilih lingkungan tempat proxy API di-deploy.
    Akses Public
    Menyetujui permintaan akses secara otomatis Enabled
    Kuota (biarkan kosong)
    Cakupan OAuth yang Diizinkan (biarkan kosong)
  4. Di bagian Operasi, klik TAMBAHKAN OPERASI untuk mengidentifikasi operasi yang akan ditambahkan ke produk API Anda.
  5. Di bagian Source, klik API proxy lalu pilih Mock-Target-API dari drop-down.
  6. Di bagian Operation, masukkan garis miring ke depan (/) di kolom Path. Abaikan kolom lainnya.
  7. Klik Save untuk menyimpan Operasi.
  8. Dialog Add Operation akan ditampilkan. Menambahkan proxy Mock-Target-API API di dialog Add Operation
  9. Klik Tambahkan.
  10. Klik Simpan.

Langkah 3: Publikasikan API ke portal Anda

Publikasikan API ke portal Anda agar pelanggan dapat mempelajari dan menggunakannya.

Untuk memublikasikan API ke portal Anda:

  1. Di UI Apigee, buka halaman API di portal Anda:
    1. Pilih Publikasikan > Portal di menu navigasi kiri.
    2. Klik di baris My first portal untuk membuka portal.
    3. Klik API Catalog untuk menampilkan halaman API.
  2. Klik +.
  3. Pilih Hello World dalam dialog Add an API product to the catalog, lalu klik Next.
  4. Di bagian Detail API, konfigurasikan opsi berikut:
    • Pilih Dipublikasikan (tercantum dalam katalog) untuk memublikasikan API ke portal Anda.
    • Untuk Display image:
      1. Klik Pilih gambar.
      2. Klik home-background.jpg dari daftar gambar yang ada pada dialog Pilih gambar.
      3. Klik Pilih.
      4. Lihat pratinjau gambar, lalu klik Select.
    • Untuk Kategori, masukkan Mulai, lalu tekan Enter.

    Biarkan semua nilai lainnya ditetapkan ke default.

    Bagian detail API saat menambahkan API ke portal

  5. Di bagian dokumentasi API, untuk membuat dokumentasi referensi API secara otomatis dari snapshot OpenAPI Anda Spesifikasi:
    1. Pilih Dokumen OpenAPI.
    2. Klik Pilih Dokumen.
    3. Pilih tab Impor dari URL.
    4. Masukkan helloworld di kolom Spec name.
    5. Salin dan tempel URL berikut di kolom URL dan tekan Enter: 
      https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml
    6. Klik Pilih.

    Bagian dokumentasi API saat menambahkan API ke portal

  6. Klik Simpan.

Untuk melihat dokumentasi referensi API:

  1. Di UI Apigee, klik Live Portal untuk melihat perubahan di portal live (atau memuat ulang portal live jika sudah terbuka di tab lain).
  2. Di portal live:
    a. Klik API di menu navigasi atas untuk melihat API yang dipublikasikan.
    b. Klik kartu Hello World untuk melihat dokumentasi referensi API.
    k. Coba gunakan API Anda.

Mock Target API dipublikasikan dengan panel Coba API ini