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 agar beroperasi pada kategori tertentu tersebut. Misalnya, Anda dapat membuat paket tarif yang berlaku untuk semua developer yang mengembangkan aplikasi untuk pembagian keuntungan dengan membuat kategori developer yang disebut "revenue_sharing" dan menambahkan developer ke dalamnya. Untuk mengetahui informasi selengkapnya tentang cara membuat paket tarif dengan kategori developer, lihat Membuat paket tarif.

Menjelajahi halaman Kategori Developer

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

UI Edge

Untuk mengakses halaman Kembangkan Kategori:

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

Halaman Kategori Developer akan ditampilkan.

Seperti yang ditunjukkan dalam gambar, halaman Kategori Developer memungkinkan Anda:

Classic Edge (Private Cloud)

Untuk mengakses halaman Develop Categories 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 untuk:

Menambahkan kategori developer

Untuk menambahkan kategori developer menggunakan UI:

  1. Akses halaman Develop Categories.
  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 termasuk dalam satu kategori developer.

Untuk menambahkan perusahaan ke kategori developer:

  1. Pilih Publikasikan > 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 Develop Categories.
  2. Arahkan kursor ke kategori developer yang ingin Anda edit, lalu klik .
  3. Masukkan kategori developer.
  4. Klik Perbarui Kategori Developer.

Menghapus kategori developer

Untuk menghapus kategori developer menggunakan UI:

  1. Akses halaman Develop Categories.
  2. Posisikan kursor di atas kategori developer yang ingin Anda edit.
  3. Klik .
  4. Klik Hapus 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 mengirimkan permintaan POST ke /mint/organizations/{org_name}/developer-categories.

Saat mengirimkan permintaan, Anda harus 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 mengirimkan permintaan POST ke masing-masing resource berikut:

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

Untuk menambahkan developer atau perusahaan ke kategori developer saat Anda mengedit perusahaan atau developer, kirim permintaan PUT ke masing-masing resource 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 di 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 dalam organisasi.

Lihat kategori developer tertentu dengan mengirimkan 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

Melihat semua kategori developer API untuk organisasi dengan mengirimkan 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 mengirimkan 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 di 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 mengirimkan 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. Ditetapkan ke MINT_DEVELOPER_CATEGORY.

T/A Ya
value

ID kategori developer tempat developer ditambahkan.

T/A Ya, untuk menetapkan kategori developer.