Mendaftarkan developer aplikasi

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

Daftarkan dan kelola developer aplikasi Anda, seperti yang dijelaskan di bagian berikut. (Pendaftaran aplikasi adalah proses terpisah, seperti yang dijelaskan dalam Mendaftarkan aplikasi dan mengelola kunci API).

Pengantar

Edge memberikan banyak manfaat yang sepenuhnya bergantung pada mengetahui siapa yang memanggil API Anda. Misalnya, keamanan API, pengelolaan traffic, dan sejumlah besar data analisis bergantung pada mengetahui siapa yang menelepon. Dan bagaimana Edge mengetahui siapa yang memanggil API Anda? Dengan membaca informasi unik di setiap panggilan API, seperti ID pengguna, kunci API, atau token OAuth. Informasi unik tersebut mengunci atau membuka fungsionalitas yang Anda bangun ke dalam proxy API Anda, sehingga memberi Anda kontrol penuh atas akses dan perilaku API.

Itulah sebabnya developer aplikasi perlu mendaftar untuk menggunakan API Anda. Setelah ditambahkan, developer mendaftarkan aplikasi mereka, memilih API yang ingin digunakan, dan menerima kredensial API unik (kunci dan rahasia konsumen) yang diperlukan untuk mengakses API Anda.

Cara mendaftarkan developer aplikasi

Daftarkan developer aplikasi menggunakan salah satu metode berikut:

Rekomendasi untuk mengelola akun developer di portal developer

Apigee merekomendasikan agar Anda mengelola akun developer langsung di portal developer.

Jika Anda menggunakan portal terintegrasi, ini adalah satu-satunya cara untuk memastikan bahwa akun developer di portal terintegrasi dan Edge tetap sinkron.

Jika Anda menggunakan portal developer berbasis Drupal, mengelola akun developer secara langsung di portal developer akan memberikan keuntungan berikut:

  • Saat menambahkan developer melalui antarmuka administrator di portal, Anda dapat menetapkan sandi developer untuk portal tersebut dan memicu pesan email otomatis yang dikirim ke developer.

    Saat menambahkan atau mengubah developer menggunakan Edge, tidak ada email yang dikirim ke developer dan Anda tidak dapat menetapkan sandi untuk developer di portal tersebut. Oleh karena itu, developer harus mereset sandi mereka di portal sebelum dapat login ke portal.

  • Setiap perubahan yang dibuat pada akun developer di portal akan otomatis dikirim ke Edge.

Jika memutuskan untuk mengelola akun developer berbasis Drupal menggunakan Edge, Anda harus menyinkronkan developer aplikasi antara portal dan Edge.

Menjelajahi halaman Developer

Akses dan jelajahi halaman Developer menggunakan UI Edge dan UI Classic Edge.

Edge

Untuk mengakses halaman Developers menggunakan Edge UI:

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

Halaman Developer akan ditampilkan.

Seperti yang disorot dalam gambar, halaman Developer memungkinkan Anda:

Edge Klasik (Private Cloud)

Untuk mengakses halaman Developer menggunakan UI Edge Klasik:

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

Halaman Developer akan ditampilkan.

Menambahkan developer

Untuk menambahkan developer:

  1. Akses halaman Developer.
  2. Klik + Developer.
  3. Masukkan detail developer, termasuk nama depan, nama belakang, email, dan nama pengguna.
  4. Klik Create.

Melihat dan mengedit detail developer

Lihat dan edit detail developer. Untuk organisasi yang mendukung Monetisasi, Anda dapat mengedit atribut khusus monetisasi yang ditentukan dalam Mengonfigurasi atribut monetisasi.

Untuk melihat dan mengedit detail developer:

  1. Akses halaman Developer.
  2. Klik baris developer yang ingin dilihat dan diedit untuk membuka detail developer.
  3. Di bagian Detail, informasi berikut ditampilkan. Edit detail developer, sesuai kebutuhan.
    Detail Deskripsi
    Detail Nama depan dan belakang, nama pengguna, dan email developer; status dan durasi pendaftaran; serta ID developer.
    Untuk mengedit detail developer, klik salah satu kolom berikut:
    • Nama Depan
    • Nama Belakang
    • Email
    • Nama pengguna
    Ubah konten dan tekan Enter untuk mengonfirmasi perubahan.
    Atribut khusus Atribut khusus yang ditentukan untuk developer. Konfigurasikan atribut khusus, sesuai kebutuhan. Untuk mengetahui informasi selengkapnya, lihat:
    Aplikasi Aplikasi yang telah didaftarkan oleh developer. Lihat Mendaftarkan aplikasi.
  4. Aktifkan atau nonaktifkan developer di kolom Status.
    Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan dan menonaktifkan developer.

Dengan Apigee Edge untuk Cloud Publik, Edge menyimpan entity berikut dalam cache selama minimal 180 detik setelah entity diakses.

  • Token akses OAuth. Artinya, token yang dicabut mungkin masih berhasil selama maksimal tiga menit, sampai batas cache-nya berakhir.
  • Entitas Key Management Service (KMS) (Aplikasi, Developer, Produk API).
  • Atribut khusus pada token OAuth dan entitas KMS.

Mengelola atribut khusus untuk developer

Tambahkan hingga 18 atribut khusus untuk setiap developer, termasuk atribut monetisasi yang dijelaskan dalam artikel Mengonfigurasi atribut monetisasi.

Untuk mengelola atribut khusus:

  1. Akses halaman Developer.
  2. Klik baris developer yang atribut kustomnya ingin Anda kelola untuk membuka detail developer.
  3. Klik + di bagian Atribut Khusus.
  4. Masukkan nama dan nilai atribut.
  5. Klik .
  6. Untuk menghapus atribut khusus, posisikan kursor di atas atribut lalu klik di menu tindakan.

Mengaktifkan dan menonaktifkan developer

Saat developer aplikasi mendaftar sendiri di portal Anda, Anda dapat mengonfigurasi apakah developer aplikasi aktif secara default atau tidak.

Saat developer tidak aktif, developer masih dapat login ke portal developer dan membuat aplikasi, tetapi tidak satu pun kunci API terkait yang akan berfungsi. Aplikasi developer masih mempertahankan status disetujui (atau lainnya), seperti halnya kunci API, meskipun tidak valid saat developer tidak aktif.

Untuk mengaktifkan atau menonaktifkan developer:

  1. Akses halaman Developer.
  2. Klik baris developer yang ingin Anda aktifkan atau nonaktifkan untuk membuka detail developer.
  3. Di bagian Detail, tetapkan kolom Status ke Aktif atau Tidak aktif, sesuai kebutuhan.
  4. Ulangi langkah-langkah tersebut jika developer berada di beberapa organisasi.

Mengekspor data publikasi

Ekspor data publikasi berikut sebagai file nilai yang dipisahkan koma (CSV):

  • Detail Pengembang
  • Detail produk API, aplikasi, dan developer

Untuk mengekspor data publikasi:

  1. Akses halaman Developer.
  2. Klik Export CSV...
  3. Pilih Developer atau Developer, Aplikasi, dan Produk dari drop-down.

Data publikasi yang dipilih akan didownload sebagai file CSV.

Menghapus developer

Untuk menghapus developer:

  1. Akses halaman Developer.
  2. Arahkan kursor ke baris developer yang ingin Anda hapus untuk menampilkan menu tindakan.
  3. Klik .
  4. Klik Delete untuk mengonfirmasi penghapusan.

Menyinkronkan developer aplikasi antara portal dan Edge

Jika Anda menggunakan portal developer berbasis Drupal untuk memublikasikan API, perubahan yang dilakukan pada developer aplikasi menggunakan Edge tidak akan disebarkan ke portal. Anda harus login ke portal sebagai administrator portal dan menyinkronkan portal dengan Edge agar perubahan tersebut muncul di portal.

Untuk menyinkronkan portal developer Anda dengan developer aplikasi yang ditentukan di Edge, lihat bagian berikut:

Mengelompokkan developer ke dalam perusahaan

Dengan monetisasi, perusahaan adalah kumpulan developer yang dikelola sebagai satu entitas. Perusahaan dapat berupa pengelompokan apa pun yang sesuai dengan organisasi Anda, seperti unit bisnis, lini produk, atau divisi. Mengelompokkan developer ke dalam perusahaan berguna jika Anda perlu memiliki beberapa developer yang terkait dalam satu entitas perusahaan. Misalnya, Anda mungkin perlu menyiapkan perusahaan yang berbeda untuk tujuan penagihan. Namun, developer di organisasi Anda tidak perlu dikaitkan dengan perusahaan. Perhatikan bahwa developer selalu merupakan satu entity, yang diidentifikasi secara unik oleh elemen email. Jika developer adalah bagian dari perusahaan, Anda akan melihat Nama perusahaan di halaman Developer.

Untuk informasi selengkapnya tentang mengelola perusahaan dan developer untuk monetisasi, lihat Mengelola perusahaan dan developer.

Mengonfigurasi atribut monetisasi

Saat mengedit developer menggunakan UI atau membuat maupun mengedit developer menggunakan API, Anda dapat mengonfigurasi properti monetisasi yang ditentukan dalam tabel berikut. Pertama-tama, Anda harus mengonfigurasi properti monetisasi untuk organisasi saat mengedit profil organisasi.

Nama kolom Nama atribut khusus Deskripsi
Alamat MINT_DEVELOPER_ADDRESS

Alamat developer, termasuk kolom berikut: Alamat (baris 1 dan 2), Kota, Negara Bagian, Kode Pos, dan Negara.

Profil Penagihan MINT_BILLING_PROFILE

Siklus penagihan untuk organisasi Anda. Nilai yang valid meliputi:

  • PRORATED: Penagihan didasarkan pada jumlah hari produk API digunakan dalam satu bulan kalender.
  • CALENDAR_MONTH: Penagihan dilakukan setiap bulan.
Jenis Penagihan MINT_BILLING_TYPE

Model pembayaran developer yang digunakan untuk penagihan. Nilainya bisa berupa salah satu dari berikut:

  • PREpaid: Developer membayar di muka untuk penggunaan produk API. Dana dipotong dari saldo developer saat produk API digunakan. Developer harus memiliki saldo prabayar yang memadai untuk membeli produk API.
  • POSTpaid: Developer ditagih setiap bulan (melalui invoice) untuk penggunaan produk API. Developer membayar penggunaan produk API berdasarkan persyaratan pembayaran yang ditetapkan oleh paket yang disertakan dalam invoice.
  • BOTH: Mendukung kedua jenis penagihan. Setelan default-nya adalah PRABAYAR.

Lihat Mengonfigurasi jenis penagihan prabayar dan pascabayar menggunakan API.

Kategori MINT_DEVELOPER_CATEGORY Kategori developer yang ingin Anda tambahi developer. Kategori developer adalah kumpulan developer atau perusahaan dengan karakteristik yang serupa. Untuk informasi selengkapnya, lihat Mengelola kategori developer.
ID Perusahaan MINT_COMPANY_ID ID Perusahaan, jika ada. Untuk informasi selengkapnya, lihat Mengelompokkan developer ke dalam perusahaan.
Jenis Developer MINT_DEVELOPER_TYPE Properti ini tidak digunakan oleh Apigee.

Jenis developer. Nilai yang valid mencakup: TRUSTED atau UNTRUSTED

Pialang MINT_IS_BROKER Tanda yang menentukan apakah pendapatan didasarkan pada internet atau tidak.
Nama resmi MINT_DEVELOPER_LEGAL_NAME Nama resmi developer yang akan digunakan di semua laporan.
Catatan: Atribut ini diperlukan jika developer tidak dikelompokkan dengan perusahaan dan ingin berlangganan paket tarif yang dipublikasikan.
Penagihan Mandiri MINT_HAS_SELF_BILLING Tanda yang menentukan apakah invoice penagihan mandiri diaktifkan atau tidak. Jika diaktifkan (true), monetisasi akan membuat invoice penagihan mandiri, bukan laporan pembagian keuntungan. Invoice penagihan mandiri adalah dokumen keuangan yang menjelaskan jumlah yang harus dibayarkan kepada developer. Faktur ini berfungsi sebagai invoice kepada Penyedia API atas nama developer.
Otorisasi Bebas Pajak # MINT_TAX_EXEMPT_AUTH_NO Nomor pembebasan pajak pemerintah, jika berlaku.
Tarif Pajak MINT_APPROX_TAX_RATE Perkiraan tarif pajak untuk developer. Tentukan nilai desimal dengan jumlah maksimum 3 karakter sebelum desimal dan 4 karakter setelah desimal.

Mengelola developer menggunakan API

Mengelola developer menggunakan Developer API.

Saat membuat dan mengupdate developer menggunakan API, Anda dapat mengonfigurasi atribut monetisasi yang dijelaskan dalam Mengonfigurasi atribut monetisasi, sesuai kebutuhan.