Mengelola perusahaan dan developer menggunakan Edge

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Jika Anda menginginkan kontrol yang lebih besar atas perusahaan dan developer yang berpartisipasi dalam program API yang dimonetisasi—misalnya, jika Anda ingin membuat perusahaan dan developer internal untuk tujuan pengujian—Anda dapat membuat perusahaan dan developer secara manual dengan UI dan API pengelolaan.

Pertimbangan utama yang menentukan apakah Anda perlu membuat perusahaan dan developer secara manual adalah apakah developer akan memerlukan kredensial untuk login ke UI pengelolaan, mengirim kredensial dalam panggilan ke Edge Management API, atau login ke portal developer.

  • Jika developer monetisasi Anda memerlukan kredensial login untuk mengakses UI atau API Edge, mereka harus memiliki akun admin Apigee mereka sendiri terlebih dahulu.
  • Jika Anda hanya perlu membuat developer pengujian yang tidak memerlukan kredensial (misalnya, jika Anda ingin melakukan panggilan API dengan developer pengujian fiktif), Anda tidak memerlukan akun Apigee.

Mengelola developer aplikasi menggunakan UI

Buat, kelola, dan aktifkan developer aplikasi menggunakan UI Edge, seperti yang dijelaskan dalam Mengelola developer aplikasi. Setelah developer aplikasi dibuat, Anda dapat menambahkannya ke perusahaan, seperti yang dijelaskan di bagian berikut.

Mengelola perusahaan menggunakan UI

Buat, kelola, dan aktifkan perusahaan, seperti yang dijelaskan di bagian berikut.

Menjelajahi halaman Perusahaan

Akses halaman Perusahaan, seperti yang dijelaskan di bawah.

Edge

Untuk mengakses halaman Perusahaan menggunakan UI Edge:

  1. Login ke apigee.com/edge.
  2. Pilih Publikasi > Monetisasi > Perusahaan di menu navigasi sebelah kiri.

Halaman Perusahaan akan ditampilkan.

Seperti yang ditandai dalam gambar, halaman Perusahaan memungkinkan Anda untuk:

Edge Klasik (Private Cloud)

Untuk mengakses halaman Perusahaan menggunakan UI Edge Klasik:

  1. Login ke http://ms-ip:9000, dengan ms-ip adalah alamat IP atau nama DNS node Server Pengelolaan.
  2. Pilih Publikasi > Perusahaan di menu navigasi atas.

Halaman Perusahaan akan ditampilkan.

  • Melihat daftar perusahaan saat ini
  • Mengelola perusahaan. Secara khusus, menambahkan, mengaktifkan, mengedit, dan menghapus perusahaan.
  • Melihat portal developer yang terhubung (khusus Drupal 7)

Menambahkan perusahaan

Untuk menambahkan perusahaan:

  1. Akses halaman Perusahaan.
  2. Klik + Perusahaan.
  3. Masukkan detail perusahaan.

    Kolom yang wajib diisi mencakup:

    • Nama Perusahaan
    • Administrator (pengguna yang merupakan administrator perusahaan utama)
    • Jenis Penagihan

    Bergantung pada konfigurasi penagihan monetisasi, Jenis Penagihan dapat ditetapkan secara default ke PREPAID atau POSTPAID. Untuk informasi selengkapnya, lihat Mengonfigurasi jenis penagihan prabayar dan pascabayar menggunakan API.

  4. Tambahkan satu atau beberapa developer ke perusahaan.
    1. Di bagian Developer, masukkan string di kolom Tambahkan Developer untuk menampilkan daftar developer yang cocok dengan string tersebut.
    2. Pilih developer dari menu drop-down.
    3. Ulangi untuk menambahkan developer tambahan ke perusahaan.
  5. Tambahkan satu atau beberapa atribut khusus.
    1. Di bagian Atribut khusus, klik + Baru.
    2. Masukkan nama dan nilai atribut kustom.
    3. Ulangi untuk menambahkan atribut khusus tambahan ke perusahaan.
  6. Klik Buat perusahaan.

Mengaktifkan dan menonaktifkan perusahaan

Untuk mengaktifkan dan menonaktifkan perusahaan:

  1. Akses halaman Perusahaan.
  2. Arahkan kursor ke perusahaan yang ingin diaktifkan, lalu aktifkan di menu tindakan.
    Nonaktifkan tombol untuk menonaktifkan perusahaan.

Mengedit perusahaan

Untuk mengedit perusahaan:

  1. Akses halaman Perusahaan.
  2. Arahkan kursor ke perusahaan yang ingin diedit, lalu klik di menu tindakan.
  3. Perbarui detail perusahaan, sesuai kebutuhan.
  4. Klik Perbarui perusahaan untuk menyimpan perubahan.

Menghapus perusahaan

Untuk menghapus perusahaan:

  1. Akses halaman Perusahaan.
  2. Arahkan kursor ke perusahaan yang ingin dihapus, lalu klik di menu tindakan.
  3. Klik Hapus untuk mengonfirmasi operasi penghapusan.

Mengelola perusahaan dan developer menggunakan API

Penggunaan API untuk mengelola perusahaan dan developer dijelaskan di bagian berikut.

Membuat dan memperbarui perusahaan dan developer menggunakan API

Untuk mengelola perusahaan dan developer dengan API pengelolaan Edge API, lihat bagian API berikut:

Mengelola peran developer menggunakan API

Anda dapat membuat peran menggunakan API monetisasi. Dengan demikian, Anda dapat menetapkan peran untuk partner. Misalnya, Anda dapat menetapkan peran administrator dan developer aplikasi untuk partner. Peran tersebut kemudian dapat ditetapkan kepada karyawan partner tertentu.

Membuat peran developer

Untuk membuat peran developer, buat permintaan POST ke organizations/{org_name}/developer-roles. Saat membuat permintaan, Anda harus menentukan nama dan deskripsi peran serta identifikasi organisasi dalam isi permintaan. Contoh:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "appDeveloper",
   "description": "App Developer",
   "organization": {
       "id": "{org_name}"
   }
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

Mengambil peran developer

Untuk mengambil peran developer, buat permintaan GET ke organizations/{org_id}/developer-roles. Contoh:

$ curl -H "Accept:application/json" -X GET \
"https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

Responsnya akan terlihat seperti ini (hanya sebagian respons yang ditampilkan):

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

Setelan konfigurasi peran developer untuk API

Opsi konfigurasi peran developer berikut ditampilkan ke API:

Nama Deskripsi Default Wajib?
name

Nama peran developer.

T/A Ya
description

Deskripsi peran developer.

T/A Ya

Mengambil tarif pajak untuk developer menggunakan API

Anda bisa mendapatkan tarif pajak saat ini untuk developer dengan mengirimkan permintaan GET ke organizations/{org_name}/tax-engine. Saat membuat permintaan, Anda harus menentukan identifikasi developer sebagai parameter kueri. Contoh:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \
-u email:password

Responsnya akan terlihat seperti ini:

0.09

Melakukan tugas khusus developer lainnya menggunakan API

Banyak tugas terkait monetisasi yang dapat Anda lakukan untuk organisasi, seperti membuat paket tarif atau membuat kondisi notifikasi, juga dapat Anda lakukan untuk developer perorangan. Misalnya, Anda dapat membuat rekening bank untuk developer tertentu atau membuat laporan pendapatan untuk developer tertentu.

Tabel berikut mencantumkan tugas khusus developer yang dapat Anda lakukan menggunakan API monetisasi. Tabel ini juga mencantumkan tempat Anda dapat menemukan petunjuk mendetail tentang cara melakukan tugas ini.

Tugas Tempat menemukan petunjuk
Melihat persyaratan dan ketentuan yang diterima oleh developer

Melihat persyaratan dan ketentuan yang disetujui oleh developer atau perusahaan yang menggunakan API

Melihat paket API yang diterima oleh developer

Melihat paket produk API yang diterima oleh developer atau perusahaan yang menggunakan API

Membuat paket tarif developer

Mengelola paket tarif

Melihat paket tarif yang tersedia untuk developer

Menjelajahi halaman paket tarif

Melihat paket tarif yang tersedia untuk developer tertentu yang berisi produk tertentu

Melihat paket tarif yang diterima untuk developer yang berisi produk API menggunakan API

Hanya melihat paket tarif developer yang diterima

Melihat semua paket tarif yang diterima oleh developer menggunakan API

Memberikan kredit kepada developer

Mengeluarkan kredit

Menetapkan batas kredit untuk developer

Menetapkan batas kredit menggunakan API

Melihat batas kredit developer

Mengambil batas kredit menggunakan API

"Menambahkan saldo" (menambahkan jumlah ke) saldo prabayar developer

Mengelola saldo akun prabayar

Melihat saldo prabayar developer

Melihat saldo akun prabayar untuk developer

Menyiapkan kondisi notifikasi untuk developer

Menyiapkan notifikasi menggunakan template notifikasi

Membuat dan melihat definisi laporan untuk developer

Mengelola laporan