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 melakukan panggilan. Lalu, bagaimana cara 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 kunci fungsi yang Anda build ke dalam proxy API, sehingga memberi Anda kontrol penuh atas akses dan perilaku API.

Itulah sebabnya developer aplikasi perlu mendaftar untuk menggunakan API Anda. Setelah ditambahkan, developer akan mendaftarkan aplikasi mereka, memilih API yang ingin digunakan, dan menerima kredensial API unik (kunci konsumen dan rahasia) 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 akun developer di portal terintegrasi dan Edge tetap sinkron.

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

  • Saat menambahkan developer melalui antarmuka administrator di portal, Anda dapat menetapkan sandi developer untuk portal 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. Oleh karena itu, developer harus mereset sandinya di portal sebelum dapat login ke portal.

  • Setiap perubahan yang dilakukan 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 Edge Klasik.

Edge

Untuk mengakses halaman Developer menggunakan UI Edge:

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

Halaman Developer akan ditampilkan.

Seperti yang ditandai 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 adalah 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 Buat.

Melihat dan mengedit detail developer

Melihat dan mengedit detail developer. Untuk organisasi yang mengaktifkan Monetisasi, Anda dapat mengedit atribut khusus monetisasi yang ditentukan di Mengonfigurasi atribut monetisasi.

Untuk melihat dan mengedit detail developer:

  1. Akses halaman Developer.
  2. Klik baris developer yang ingin Anda lihat dan edit untuk membuka detail developer.
  3. Di bagian Detail, informasi berikut akan 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 di dalam salah satu kolom berikut:
    • Nama Depan
    • Nama Belakang
    • Email
    • Nama pengguna
    Ubah konten dan tekan Enter untuk mengonfirmasi perubahan.
    Atribut khusus Atribut kustom yang ditentukan untuk developer. Konfigurasikan atribut khusus, sesuai kebutuhan. Untuk informasi selengkapnya, lihat:
    Aplikasi Aplikasi yang telah didaftarkan oleh developer. Lihat Mendaftarkan aplikasi.
  4. Aktifkan atau nonaktifkan developer di kolom Status.
    Untuk informasi selengkapnya, lihat Mengaktifkan dan menonaktifkan developer.

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

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

Mengelola atribut khusus untuk developer

Tambahkan hingga 18 atribut kustom untuk setiap developer, termasuk atribut monetisasi yang dijelaskan dalam 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 Kustom.
  4. Masukkan nama dan nilai atribut.
  5. Klik .
  6. Untuk menghapus atribut kustom, posisikan kursor ke atribut tersebut, lalu klik di menu tindakan.

Mengaktifkan dan menonaktifkan developer

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

Jika tidak aktif, developer masih dapat login ke portal developer dan membuat aplikasi, tetapi tidak ada kunci API yang sesuai yang akan berfungsi. Aplikasi developer masih mempertahankan statusnya yang disetujui (atau lainnya), begitu juga dengan 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

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

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

Untuk mengekspor data publikasi:

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

Data publikasi yang dipilih akan didownload sebagai file CSV.

Menghapus developer

Untuk menghapus developer:

  1. Akses halaman Developer.
  2. Posisikan kursor di atas baris developer yang ingin dihapus 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 yang menggunakan Edge tidak akan diterapkan 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 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 entitas, 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 cara mengelola perusahaan dan developer untuk monetisasi, lihat Mengelola perusahaan dan developer.

Mengonfigurasi atribut monetisasi

Saat mengedit developer menggunakan UI atau membuat atau mengedit developer menggunakan API, Anda dapat mengonfigurasi properti monetisasi yang ditentukan dalam tabel berikut. Awalnya, Anda 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 mencakup:

  • 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 akan dipotong dari saldo developer saat produk API digunakan. Developer harus mempertahankan saldo prabayar yang cukup 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.
  • KEDUANYA: Mendukung salah satu jenis penagihan. Setelan defaultnya adalah PREPAID.

Lihat Mengonfigurasi jenis penagihan prabayar dan pascabayar menggunakan API.

Kategori MINT_DEVELOPER_CATEGORY Kategori developer tempat Anda ingin menambahkan developer. Kategori developer adalah pengelompokan developer atau perusahaan dengan karakteristik serupa. Untuk informasi selengkapnya, lihat Mengelola kategori developer.
ID Perusahaan MINT_COMPANY_ID ID Perusahaan, jika ada. Untuk mengetahui 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
Adalah Broker MINT_IS_BROKER Tanda yang menentukan apakah pendapatan didasarkan pada pendapatan bersih.
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 menghasilkan invoice penagihan mandiri, bukan laporan pembagian keuntungan. Invoice penagihan mandiri adalah dokumen keuangan yang menjelaskan jumlah yang harus dibayar kepada developer. Laporan ini berfungsi sebagai invoice kepada Penyedia API atas nama developer.
No. Otorisasi Pembebasan Pajak MINT_TAX_EXEMPT_AUTH_NO Nomor pembebasan pajak pemerintah, jika ada.
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 memperbarui developer menggunakan API, Anda dapat mengonfigurasi atribut monetisasi yang dijelaskan di Mengonfigurasi atribut monetisasi, sesuai kebutuhan.