Kelola kategori developer

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

Kategori developer adalah kumpulan developer atau perusahaan dengan karakteristik serupa yang memungkinkan Anda mengonfigurasi monetisasi agar beroperasi pada kategori spesifik tersebut. Misalnya, Anda dapat membuat paket tarif yang berlaku bagi semua developer yang mengembangkan aplikasi untuk pembagian keuntungan dengan membuat kategori developer yang disebut "pendapatan_pembagian" 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 Classic Edge, seperti yang dijelaskan di bagian berikut.

Menambahkan kategori developer

Untuk menambahkan kategori developer menggunakan UI:

1. Akses halaman Develop Kategori.
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 tersebut.
5. Klik Simpan.
   

Mengedit kategori developer

Untuk mengedit kategori developer menggunakan UI:

1. Akses halaman Develop Kategori.
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 Develop Kategori.
2. Arahkan kursor ke kategori developer yang ingin diedit.
3. Klik .
4. Klik Hapus untuk mengonfirmasi operasi.

Mengelola kategori developer menggunakan API

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

Menambahkan kategori developer menggunakan API

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

Saat mengajukan permintaan, tentukan 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 mengajukan 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, berikan permintaan PUT ke 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 dalam isi permintaan dengan ID internal kategori sebagai nilainya. 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 sebuah 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

Mengedit kategori developerdengan mengeluarkan permintaan PUT ke /mint/organizations/{org_name}/developer-categories/{category_id}, dengan {category_id} adalah identifikasi kategori yang akan diperbarui. Anda perlu menentukan dalam isi permintaan setelan yang diperbarui dan ID kategori developer. 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 HAPUS 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 diisi?
name	Nama properti. Setel ke MINT_DEVELOPER_CATEGORY.	T/A	Ya
value	ID kategori developer yang ditambahi developer.	T/A	Ya, untuk menetapkan kategori developer.