API pengajuan Pusat Mitra untuk menaikkan aplikasi Azure di Pusat Mitra

Gunakan API pengajuan Pusat Mitrauntuk secara kueri terprogram, membuat pengajuan untuk, dan menerbitkan penawaran Azure. API ini berguna jika akun Anda mengelola banyak penawaran dan Anda ingin mengotomatiskan dan mengoptimalkan proses pengajuan untuk penawaran ini.

Prasyarat API

Ada beberapa aset terprogram yang Anda butuhkan untuk menggunakan API Pusat Mitra untuk Produk Azure:

  • Aplikasi Azure Active Directory.
  • Token akses Azure Active Directory (Azure AD).

Langkah 1: Menyelesaikan prasyarat untuk menggunakan API pengajuan Pusat Mitra

Sebelum Anda mulai menulis kode untuk memanggil API pengajuan Pusat Mitra, pastikan Anda telah menyelesaikan prasyarat berikut.

  • Anda (atau organisasi Anda) harus memiliki direktori Azure AD dan Anda harus memiliki izin Administrator global untuk direktori tersebut. Jika sudah menggunakan Microsoft 365 atau layanan bisnis lainnya dari Microsoft, Anda sudah memiliki direktori Azure AD. Jika tidak, Anda dapat membuat Azure AD baru di Pusat Mitra tanpa biaya tambahan.

  • Anda harus mengaitkan aplikasi Azure AD dengan akun Pusat Mitra dan mendapatkan ID penyewa, ID klien, dan kunci Anda. Anda memerlukan nilai-nilai ini untuk mendapatkan token akses Azure AD, yang akan Anda gunakan dalam panggilan ke API pengajuan Microsoft Store.

Cara mengaitkan aplikasi Azure AD dengan akun Pusat Mitra Anda

Untuk menggunakan API pengajuan Microsoft Store, Anda harus mengaitkan aplikasi Azure AD dengan akun Pusat Mitra Anda, mengambil ID penyewa dan ID klien untuk aplikasi, dan menghasilkan sebuah kunci. Aplikasi Azure AD mewakili aplikasi atau layanan tempat Anda ingin memanggil API pengajuan Pusat Mitra. Anda memerlukan ID penyewa, ID klien, dan kunci untuk mendapatkan token akses Azure AD yang Anda berikan ke API.

Catatan

Anda hanya perlu melakukan tugas ini sekali. Setelah Anda memiliki ID penyewa, ID klien, dan kunci, Anda dapat menggunakannya kembali kapan saja Anda perlu untuk membuat token akses Azure AD baru.

  1. Di Pusat Mitra, kaitkan akun Pusat Mitra organisasi Anda dengan direktori Azure AD organisasi Anda.
  2. Berikutnya, dari halamanPengguna di bagian Pengaturan akun di bagian Pusat Mitra, tambahkan aplikasi Azure AD yang mewakili aplikasi atau layanan yang akan Anda gunakan untuk mengakses pengajuan untuk akun Pusat Mitra Anda. Pastikan Anda menetapkan aplikasi ini sebagai peranManager. Jika aplikasi belum ada di direktori Azure AD, Anda dapat membuat aplikasi Azure AD baru di Pusat Mitra.
  3. Kembali ke halaman Pengguna, klik nama aplikasi Azure AD Anda untuk masuk ke pengaturan aplikasi, dan salin nilai ID Penyewa dan ID Klien.
  4. Klik Tambahkan kunci baru. Pada layar berikut, salin ke bawah nilai Kunci. Anda tidak akan bisa mengakses info ini lagi setelah meninggalkan halaman ini. Untuk informasi selengkapnya, lihat Mengelola kunci untuk aplikasi Azure AD.

Langkah 2 : Mendapatkan token akses Azure AD

Sebelum Anda memanggil salah satu metode di API pengajuan Pusat Mitra, Anda harus terlebih dahulu mendapatkan token akses Azure AD yang Anda berikan ke header Otorisasi dari setiap metode di API. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakannya sebelum masa berlakunya habis. Setelah masa berlaku token habis, Anda dapat refresh token dan terus menggunakannya untuk panggilan lebih lanjut ke API.

Untuk mendapatkan token akses, ikuti instruksi dalam Layanan ke Panggilan Layanan Menggunakan Mandat Klien untuk mengirim sebuah HTTP POST ke https://login.microsoftonline.com/<tenant_id>/oauth2/token titik akhir. Berikut adalah sampel permintaan:

JSONCopy

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource= https://api.partner.microsoft.com

Untuk tenant_id nilai di parameter POST URI dan client_iddan client_secret, tentukan ID penyewa, ID klien, dan kunci untuk aplikasi yang Anda ambil dari Pusat Mitra di bagian sebelumnya. Untuk parameter sumber daya, Anda harus menentukan https://api.partner.microsoft.com.

Langkah 3: Gunakan API pengajuan Microsoft Store

Setelah memiliki token akses Azure AD, Anda dapat memanggil metode di API pengajuan Pusat Mitra. Untuk membuat atau memperbarui pengajuan, Anda biasanya memanggil beberapa metode di API pengajuan Pusat Mitra dalam urutan tertentu. Untuk informasi tentang setiap skenario dan sintaks setiap metode, lihat Swagger API Penyerapan.

https://ingestionapi-swagger.azureedge.net/#/

Langkah berikutnya