Mengelola resource API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Mendaftarkan API

Saat mendaftarkan API dengan hub API, Anda akan membuat dan menyimpan entity yang merepresentasikan API. Kami memanggil entitas ini merupakan resource API. Resource API yang disimpan di hub API dapat ditelusuri dan memberikan operasional dan deskriptif tentang API. Baik pada saat mendaftarkan API atau setelahnya, Anda dapat menambahkan dan mengedit atribut resource API untuk membangun deskripsi API yang lengkap.

Konsol

Untuk mendaftarkan API:

  1. Di konsol Google Cloud, buka halaman APIs di Hub APIgee API.

    Buka hub API
  2. Klik Register API.
  3. Di bagian Detail umum, tentukan ID unik untuk API secara opsional. Jika Anda tidak memberikan ID, sistem akan membuatnya untuk Anda. Jika Anda ingin memasukkan ID, klik Tentukan ID Unik.

    ID harus terdiri dari 4-500 karakter, dan karakter yang valid adalah /[A-Z][a-z][0-9]-/. Tujuan adalah komponen terakhir dari nama resource API unik yang sepenuhnya memenuhi syarat, yang ada di format: projects/PROJECT/locations/LOCATION/apis/API_ID

  4. (Wajib) Berikan nama tampilan untuk resource API.
  5. Secara opsional, tambahkan atribut tambahan yang mendeskripsikan API. Anda dapat kembali ke API ini kapan saja untuk menambahkan atau mengubah atribut API. Lihat Mengedit resource API.
    • Informasi pemilik: (Opsional) Nama dan alamat email pemilik API.
    • Detail tambahan: (Opsional) Tentukan atribut untuk membantu menentukan API dan membuatnya lebih mudah dicari. Anda dapat menentukan nilai default untuk beberapa atribut ini di Setelan. Untuk mengetahui detailnya, lihat Mengelola atribut.
    • Atribut yang ditetapkan pengguna: (Opsional) Ini adalah atribut yang Anda tentukan di Setelan. Untuk mengetahui detailnya, lihat Mengelola atribut.
  6. Klik Daftar.

REST

Untuk mendaftarkan API, gunakan REST API Create API.

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
    "display_name": "DISPLAY_NAME",            # Required attribute
    "description": "DESCRIPTION"               # description is an optional attribute
    }
    'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis?api_id=API_ID

Ganti kode berikut:

  • HUB_PROJECT: Nama project host hub API Anda. Project host dipilih saat hub API disediakan.
  • HUB_LOCATION: Lokasi project host. Lokasi dipilih saat API telah disediakan.
  • API_ID: (Opsional) Masukkan ID unik untuk API. Jika Anda tidak memberikan parameter kueri ini, sistem akan membuatkan ID unik untuk Anda. ID harus terdiri dari 4-500 karakter, dan karakter yang valid adalah /[A-Z][a-z][0-9]-/. ID adalah komponen terakhir dari nama sumber daya API unik yang sepenuhnya memenuhi syarat, yang ada dalam format: projects/PROJECT/locations/LOCATION/apis/API_ID
  • DISPLAY_NAME: (Wajib) Nama tampilan resource API. Anda dapat menggunakan nama yang diinginkan.
  • DESCRIPTION: (Opsional) Anda dapat menambahkan sejumlah atribut opsional untuk mendeskripsikan resource API, termasuk deskripsi, pemilik, link ke dokumentasi API, dan banyak lagi. Atribut opsional ini dicantumkan dan dijelaskan dalam Definisi resource API.

Mencantumkan resource API

Bagian ini menjelaskan cara menampilkan daftar resource API di hub API. Dengan menambahkan filter, Anda membatasi API yang ditampilkan dalam respons.

Konsol

Untuk menampilkan daftar resource API:

  1. Di konsol Google Cloud, buka halaman APIs di Hub APIgee API.

    Buka hub API

    Daftar semua API yang ditambahkan ke hub API dicantumkan di halaman beranda API.

  2. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Penelusuran untuk menemukan API.

REST

Untuk menampilkan daftar semua resource API di project hub API Anda, gunakan List APIs API:

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis"
  -X GET -H "Authorization: Bearer: $(gcloud auth print-access-token)" -H "Content-Type: application/json"

Ganti kode berikut:

  • HUB_PROJECT: Nama project host hub API Anda. Project host dipilih saat hub API disediakan.
  • HUB_LOCATION: Lokasi project host. Lokasi dipilih saat API telah disediakan.

Contoh output:

{
  "apis": [
    {
      "name": "projects/myproject/locations/us-central1/apis/a035eb3b-658e-467a-89d3-9cca2bbacd32-2",
      "displayName": "TestApi2",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/a035eb3b-658e-467a-89d3-9cca2bbacd32-1",
      "displayName": "TestApi1",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/foo9013cfev",
      "displayName": "sample",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/foo90121",
      "displayName": "sample",
      "documentation": {}
    },
    ...
    ],
    "nextPageToken": "f4f4d78b-a974-46db-a214-dc139f8e9c8a"
  }

Contoh REST dengan filter

Anda dapat memfilter hasil daftar menggunakan API. Dalam contoh ini, kita memfilter API berdasarkan atribut yang ditentukan sistem:

curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis' \
  -d filter="owner.email=\"testowner3@gmail.com\"" -d page_size=10

Ganti kode berikut:

  • HUB_PROJECT: Nama project host hub API Anda. Project host dipilih saat hub API disediakan.
  • HUB_LOCATION: Lokasi project host. Lokasi dipilih saat API telah disediakan.

Contoh output, difilter menurut pemilik:

{
  "apis": [
    {
      "name": "projects/myproject/locations/us-central1/apis/theme-park-management-api",
      "displayName": "Theme Park Management API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/restaurant-api",
      "displayName": "Restaurant API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/casino-management-api",
      "displayName": "Casino Management API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/hotel-boooking-api",
      "displayName": "Hotel Booking API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/test-march-26-api3",
      "displayName": "Test Pets API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/test-march-26-api2",
      "displayName": "Test Pets API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/test-march-26-api1",
      "displayName": "Test Pets API",
      "documentation": {}
    }
  ]
}

Mendapatkan detail resource API

Bagian ini menjelaskan cara mendapatkan detail tentang resource API.

Konsol

Untuk melihat detail resource API:

  1. Di konsol Google Cloud, buka halaman APIs di Hub APIgee API.

    Buka hub API
  2. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Penelusuran untuk menemukan API.
  3. Klik API untuk melihat halaman detailnya.

REST

Untuk melihat detail resource API, gunakan API Get API resource details:

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID"
  -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X GET -H "Content-Type: application/json"

Ganti kode berikut:

  • HUB_PROJECT: Nama project host hub API Anda. Project host dipilih saat hub API disediakan.
  • HUB_LOCATION: Lokasi project host. Lokasi dipilih saat API telah disediakan.
  • API_ID: ID unik resource API.

Contoh output:

{
  "name": "projects/myproject/locations/us-central1/apis/myapi",
  "displayName": "My Test API",
  "description": "This is a test API.",
  "documentation": {},
  "owner": {
    "displayName": "Test API,
    "email": "testowner@gmail.com"
  },
  "versions": [
    "projects/myproject/locations/us-central1/apis/myapi/versions/myapi-version1"
  ],
  "createTime": "2024-03-26T10:13:15.668867002Z",
  "updateTime": "2024-03-26T10:13:16.700716401Z"
}

Menghapus resource API

Bagian ini menjelaskan cara menghapus resource API.

Konsol

Jika Anda menghapus API di UI, semua versi dasar API dan spesifikasi API terkait (jika ada) akan dihapus.

Cara menghapus resource API:

  1. Di konsol Google Cloud, buka halaman APIs di Hub APIgee API.

    Buka hub API
  2. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Penelusuran untuk menemukan API yang akan dihapus.
  3. Dari menu Tindakan (sisi kanan baris yang berisi API), klik Hapus.

REST

Untuk menghapus API dari hub API, gunakan Delete API API.

Secara {i>default<i}, API hanya bisa dihapus jika semua versi yang mendasarinya akan dihapus. Jika Anda ingin menghapus semua versi pada API dalam satu langkah, setel Parameter kueri force ke true di Delete REST API.

curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID'

Ganti kode berikut:

  • HUB_PROJECT: Nama project host hub API Anda. Project host dipilih saat hub API disediakan.
  • HUB_LOCATION: Lokasi project host. Lokasi dipilih saat API telah disediakan.
  • API_ID: ID unik resource API yang akan dihapus.

Untuk menghapus API dan semua versi yang mendasarinya, tetapkan parameter kueri force ke true. Contoh:

curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID?force=true'

Mengedit resource API

Bagian ini menjelaskan cara mengedit resource API. Tidak semua atribut resource API dapat diedit. Untuk mengetahui daftar atribut yang dapat diedit, lihat dokumen referensi Patch API.

Konsol

Untuk mengedit API:

  1. Di konsol Google Cloud, buka halaman APIs di Hub APIgee API.

    Buka hub API
  2. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Penelusuran untuk menemukan API yang akan diedit.
  3. Klik API untuk melihat halaman detailnya.
  4. Klik Edit API.
  5. Di halaman Edit API, buat perubahan. Klik Lanjutkan untuk berpindah ke kumpulan atribut yang dapat diedit berikutnya.
    • Detail umum: Anda dapat mengedit nama tampilan API.
    • Informasi pemilik: Nama dan alamat email pemilik API.
    • Detail tambahan: Atribut ini adalah atribut yang ditentukan sistem. Anda dapat menentukan nilai default kustom untuk atribut ini dalam Kelola atribut.
    • Atribut buatan pengguna: Ini adalah atribut khusus yang ditentukan pengguna. Anda dapat menentukan atribut khusus di Kelola atribut.
  6. Klik Simpan.

REST

Untuk mengedit resource API, gunakan Patch resource API.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
          "display_name": "Updated Test Docs API",        # Example request body with changes
          "description": "This is the updated test API.",
          "owner": {
            "display_name": "Updated Docs Owner",
            "email": "updateddocsowner@gmail.com"
            }
          }
          ' https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID

Ganti kode berikut:

  • HUB_PROJECT: Nama project host hub API Anda. Project host dipilih saat hub API disediakan.
  • HUB_LOCATION: Lokasi project host. Lokasi dipilih saat API telah disediakan.
  • API_ID: ID unik API yang akan diperbarui.
  • Isi Permintaan: Gunakan isi permintaan untuk menentukan atribut yang ingin diubah. Lihat deskripsi isi permintaan API.