API pengiriman Pusat Mitra untuk menyetorkan aplikasi Azure di Pusat Mitra

Artikel
11/10/2023

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

Prasyarat API

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

aplikasi Microsoft Entra.
token akses Microsoft Entra.

Langkah 1: Menyelesaikan prasyarat untuk menggunakan API pengiriman Pusat Mitra

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

Anda (atau organisasi Anda) harus memiliki direktori Microsoft Entra dan Anda harus memiliki izin Administrator global untuk direktori tersebut. Jika Anda sudah menggunakan Microsoft 365 atau layanan bisnis lainnya dari Microsoft, Anda sudah memiliki direktori Microsoft Entra. Jika tidak, Anda dapat membuat ID Microsoft Entra baru di Pusat Mitra tanpa biaya tambahan.
Anda harus mengaitkan aplikasi Microsoft Entra dengan akun Pusat Mitra Anda dan mendapatkan ID penyewa, ID klien, dan kunci Anda. Anda memerlukan nilai-nilai ini untuk mendapatkan token akses Microsoft Entra, yang akan Anda gunakan dalam panggilan ke API pengiriman Microsoft Store.

Cara mengaitkan aplikasi Microsoft Entra dengan akun Pusat Mitra Anda

Untuk menggunakan API pengiriman Microsoft Store, Anda harus mengaitkan aplikasi Microsoft Entra dengan akun Pusat Mitra Anda, mengambil ID penyewa dan ID klien untuk aplikasi, dan membuat kunci. Aplikasi Microsoft Entra mewakili aplikasi atau layanan tempat Anda ingin memanggil API pengiriman Pusat Mitra. Anda memerlukan ID penyewa, ID klien, dan kunci untuk mendapatkan token akses Microsoft Entra yang Anda teruskan 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 membuat token akses Microsoft Entra baru.

Di Pusat Mitra, kaitkan akun Pusat Mitra organisasi Anda dengan direktori Microsoft Entra organisasi Anda.
Selanjutnya, dari halaman Pengguna di bagian Pengaturan akun di Pusat Mitra, tambahkan aplikasi Microsoft Entra yang mewakili aplikasi atau layanan yang akan Anda gunakan untuk mengakses pengiriman untuk akun Pusat Mitra Anda. Pastikan Anda menetapkan aplikasi ini sebagai peranManajer. Jika aplikasi belum ada di direktori Microsoft Entra, Anda dapat membuat aplikasi Microsoft Entra baru di Pusat Mitra.
Kembali ke halaman Pengguna , klik nama aplikasi Microsoft Entra Anda untuk masuk ke pengaturan aplikasi, dan salin nilai ID Penyewa dan ID Klien.
Klik Tambahkan kunci baru. Pada layar berikut, salin nilai Kunci. Anda tidak akan dapat mengakses info ini lagi setelah meninggalkan halaman ini. Untuk informasi selengkapnya, lihat Mengelola kunci untuk aplikasi Microsoft Entra.

Langkah 2: Mendapatkan token akses Microsoft Entra

Sebelum Anda memanggil salah satu metode di API pengiriman Pusat Mitra, Anda harus terlebih dahulu mendapatkan token akses Microsoft Entra yang Anda berikan ke header Otorisasi dari setiap metode di API. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakan token akses sebelum masa berlakunya habis. Setelah masa berlaku token habis, Anda dapat merefresh token dan terus menggunakannya untuk panggilan di lain waktu ke API.

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

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 nilai tenant_id di parameter POST URI dan client_id dan 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: Menggunakan API pengiriman Microsoft Store

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

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