Kelola kategori developer

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

Kategori developer adalah pengelompokan developer atau perusahaan dengan karakteristik serupa yang memungkinkan Anda mengonfigurasi monetisasi untuk beroperasi di kategori tertentu tersebut. Misalnya, Anda dapat membuat paket tarif yang berlaku untuk semua developer yang mengembangkan aplikasi untuk pembagian keuntungan dengan membuat kategori developer bernama "revenue_sharing" dan menambahkan developer ke dalamnya. Untuk informasi selengkapnya tentang cara membuat paket tarif dengan kategori developer, lihat Membuat paket tarif.

Menjelajahi halaman Kategori Developer

Akses halaman Kategori Developer menggunakan UI Edge atau UI Edge Klasik, seperti yang dijelaskan di bagian berikut.

UI Edge

Untuk mengakses halaman Kategori Pengembangan:

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

Halaman Kategori Developer akan ditampilkan.

Seperti yang disorot dalam gambar, halaman Kategori Developer memungkinkan Anda untuk:

Edge Klasik (Private Cloud)

Untuk mengakses halaman Kategori Pengembangan 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 Publikasikan > Kategori Developer di menu navigasi atas.

Halaman Kategori Developer akan ditampilkan.

Halaman Kategori Developer memungkinkan Anda:

Menambahkan kategori developer

Untuk menambahkan kategori developer menggunakan UI:

  1. Akses halaman Kategori Pengembangan.
  2. Klik + Kategori Developer.
  3. Masukkan nama untuk kategori baru dan deskripsi singkat.
  4. Klik Buat Kategori Developer.

Menambahkan perusahaan ke kategori developer

Menambahkan perusahaan ke kategori developer. Perusahaan hanya dapat tergabung dalam satu kategori developer.

Untuk menambahkan perusahaan ke kategori developer:

  1. Pilih Publikasi > Perusahaan di menu navigasi atas.
  2. Pilih perusahaan yang ingin Anda tambahkan ke kategori developer.
  3. Klik Edit di halaman perusahaan.
  4. Pilih Kategori Developer untuk perusahaan.
  5. Klik Simpan.

Mengedit kategori developer

Untuk mengedit kategori developer menggunakan UI:

  1. Akses halaman Kategori Pengembangan.
  2. Arahkan kursor ke kategori developer yang ingin diedit, lalu klik .
  3. Masukkan kategori developer.
  4. Klik Perbarui Kategori Developer.

Menghapus kategori developer

Untuk menghapus kategori developer menggunakan UI:

  1. Akses halaman Kembangkan Kategori.
  2. Arahkan kursor ke kategori developer yang ingin Anda edit.
  3. Klik .
  4. Klik Delete untuk mengonfirmasi operasi.

Mengelola kategori developer menggunakan API

Kelola kategori developer menggunakan API, seperti yang dijelaskan di bagian berikut.

Menambahkan kategori developer menggunakan API

Tambahkan kategori developer dengan mengeluarkan permintaan POST ke /mint/organizations/{org_name}/developer-categories.

Saat mengeluarkan permintaan, Anda menentukan kategori name dan description dalam payload. Contoh:

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \
  -H "Content-Type:application/json"  \
  -d '{
    "name": "Gold",
    "description": "Gold membership"
  }' \
  -u email:password

Responsnya akan terlihat seperti ini:

{
  "description" : "Gold membership",
  "id" : "aa6f960a-d9fd-416e-be39-c071418aabd0",
  "name" : "Gold"
}

Menambahkan developer atau perusahaan ke kategori developer menggunakan API

Tambahkan developer atau perusahaan ke kategori developer saat Anda menambahkan atau mengedit perusahaan atau developer dengan mengeluarkan permintaan POST ke resource berikut:

  • /organizations/{org_name}/companies
  • /organizations/{org_name}/developers

Untuk menambahkan developer atau perusahaan ke kategori developer saat Anda mengedit perusahaan atau developer, kirimkan permintaan PUT ke referensi berikut:

  • /organizations/{org_name}/companies/{company_id}
  • /organizations/{org_name}/developers/{developer_id}

Perusahaan atau developer hanya dapat tergabung dalam satu kategori developer.

Tentukan MINT_DEVELOPER_CATEGORY sebagai atribut dalam isi permintaan dengan ID internal kategori sebagai nilai. Misalnya, permintaan berikut menambahkan developer yang sudah ada ke kategori developer bernama "Gold", yang memiliki ID aa6f960a-d9fd-416e-be39-c071418aabd0.

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/K4jW2QLjZ1h8GFA8" \
  -H "Content-Type: application/json" \
  -d '{
   "email" : "developer@apigee.com",
    "developerId" : "K4jW2QLjZ1h8GFA8",
    "firstName" : "Dev",
    "lastName" : "One",
    "userName" : "devone",    
    "attributes" : [ {
      "name" : "MINT_REGISTRATION_ID",
      "value" : "dev1"
    }, {
      "name" : "MINT_DEVELOPER_LEGAL_NAME",
      "value" : "DEV ONE"
    }, {
      "name" : "MINT_DEVELOPER_TYPE",
      "value" : "TRUSTED"
    }, {
      "name" : "MINT_BILLING_TYPE",
      "value" : "PREPAID"
    }, {
      "name" : "MINT_IS_BROKER",
      "value" : "TRUE"
    }, {
      "name" : "MINT_DEVELOPER_CATEGORY",
      "value" : "aa6f960a-d9fd-416e-be39-c071418aabd0"
    }, {
      "name" : "MINT_DEVELOPER_ADDRESS",
      "value" : "{
                   "address1": "Dev One Address",
                   "city": "Pleasanton",
                   "country": "US",
                   "isPrimary": "true",
                   "state": "CA",
                   "zip": "94588"
                }"
    }
  }' \
  -u email:password

Melihat kategori developer menggunakan API

Melihat kategori developer tertentu atau semua kategori developer di organisasi.

Lihat kategori developer tertentu dengan mengeluarkan permintaan GET ke /mint/organizations/{org_name}/developer-categories/{category_id}, dengan {category_id} adalah identifikasi kategori developer (ID ditampilkan dalam respons saat Anda menambahkan kategori developer). Contoh:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

Lihat semua kategori developer API untuk organisasi dengan mengeluarkan permintaan GET ke /mint/organizations/{org_id}/developer-categories. Contoh:

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

Mengedit kategori developer menggunakan API

Edit kategori developer dengan mengeluarkan permintaan PUT ke /mint/organizations/{org_name}/developer-categories/{category_id}, dengan {category_id} adalah identifikasi kategori yang akan diperbarui. Anda perlu menentukan setelan yang diperbarui dan ID kategori developer dalam isi permintaan. Misalnya, permintaan berikut mengedit deskripsi kategori developer:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Content-Type: application/json"  \
  -d '{
    "id": "aa6f960a-d9fd-416e-be39-c071418aabd0",
    "description": "Premium membership"
  }' \
  -u email:password

Menghapus kategori developer menggunakan API

Hapus kategori developer dengan mengeluarkan permintaan DELETE ke /mint/organizations/{org_name}/developer-categories/{category_id}, dengan {category_id} adalah identifikasi kategori developer yang akan dihapus. Contoh:

curl -X DELETE "https://api.enterprise.apigee.com /v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

Properti konfigurasi kategori developer untuk API

Tabel berikut merangkum properti konfigurasi yang dapat ditetapkan menggunakan API.

Nama Deskripsi Default Wajib?
name

Nama properti. Tetapkan ke MINT_DEVELOPER_CATEGORY.

T/A Ya
value

ID kategori developer tempat developer ditambahkan.

T/A Ya, untuk menetapkan kategori developer.