Mengelola perusahaan dan developer menggunakan Edge

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

Jika ingin lebih mengontrol perusahaan dan developer yang berpartisipasi dalam program API yang dimonetisasi —misalnya, jika 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 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 Edge UI atau API, mereka harus memiliki akun administrator Apigee 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), tidak diperlukan akun Apigee.

Mengelola developer aplikasi menggunakan UI

Buat, kelola, dan aktifkan developer aplikasi menggunakan Edge UI, seperti yang dijelaskan di 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.

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 mengetahui 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 Add Developer untuk menampilkan daftar developer yang cocok dengan string tersebut.
   2. Pilih developer dari menu drop-down.
   3. Ulangi untuk menambahkan developer lain ke perusahaan.
5. Tambahkan satu atau beberapa atribut khusus.
   1. Di bagian Atribut khusus, klik + Baru.
   2. Masukkan nama dan nilai atribut khusus.
   3. Ulangi untuk menambahkan atribut khusus lain 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 Anda aktifkan dan 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 Anda edit dan 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 Anda hapus dan 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 Edge management API, lihat bagian API berikut:

• Membuat perusahaan
• Membuat developer
  Catatan: Konfigurasi informasi monetisasi saat membuat developer dengan meneruskan atribut khusus.
• Menambahkan atau memperbarui developer perusahaan
  Catatan: Secara opsional, Anda dapat menetapkan peran kepada developer, meskipun tidak wajib. Untuk mendapatkan daftar peran developer, lihat Mengambil peran developer.
• Mencantumkan konfigurasi monetisasi untuk semua developer atau untuk satu developer
  Catatan: Tentukan informasi monetisasi dengan meneruskan atribut khusus saat membuat atau memperbarui developer. Anda dapat melihat atribut khusus monetisasi yang ditetapkan menggunakan API standar (non-monetisasi) untuk mencantumkan semua developer atau satu developer.

Mengelola peran developer menggunakan API

Anda dapat membuat peran menggunakan API monetisasi. Hal ini memungkinkan Anda menetapkan peran untuk partner. Misalnya, Anda dapat menetapkan peran administrator dan developer aplikasi untuk a partner. Peran tersebut kemudian dapat ditetapkan ke karyawan partner tertentu.

Membuat peran developer

Untuk membuat peran developer, kirim 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, kirim 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 diekspos ke API:

Mengambil tarif pajak untuk developer menggunakan API

Anda bisa mendapatkan tarif pajak saat ini untuk developer dengan mengirim 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.