Mendapatkan info peluncuran untuk pengiriman penerbangan
Gunakan metode ini di API pengiriman Microsoft Store untuk mendapatkan info peluncuran paket untuk pengiriman penerbangan paket. Untuk informasi selengkapnya tentang proses pembuatan pengiriman penerbangan paket dengan menggunakan API pengiriman Microsoft Store, lihat Mengelola pengiriman penerbangan paket.
Prasyarat
Untuk menggunakan metode ini, Anda harus terlebih dahulu melakukan hal berikut:
- Jika Anda belum melakukannya, selesaikan semua prasyarat untuk API pengiriman Microsoft Store.
- Dapatkan token akses Azure ACTIVE Directory untuk digunakan di header permintaan untuk metode ini. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakan token akses sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda dapat memperoleh yang baru.
- Buat pengiriman penerbangan paket untuk salah satu aplikasi Anda. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukan ini dengan menggunakan metode membuat pengiriman penerbangan paket.
Minta
Metode ini memiliki sintaks berikut. Lihat bagian berikut untuk contoh penggunaan dan deskripsi parameter header dan permintaan.
| Metode | URI Permintaan |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/packagerollout |
Header permintaan
| Header | Tipe | Deskripsi |
|---|---|---|
| Authorization | string | Harus diisi. Token akses Microsoft Azure ACTIVE Directory dalam bentuk token> Pembawa<. |
Parameter permintaan
| Nama | Tipe | Deskripsi |
|---|---|---|
| applicationId | string | Harus diisi. ID Toko aplikasi yang berisi pengiriman penerbangan paket dengan info peluncuran paket yang ingin Anda dapatkan. Untuk informasi selengkapnya tentang ID Penyimpanan, lihat Menampilkan detail identitas aplikasi. |
| flightId | string | Harus diisi. ID penerbangan paket yang berisi pengiriman dengan info peluncuran paket yang ingin Anda dapatkan. ID ini tersedia dalam data respons untuk permintaan membuat penerbangan paket dan mendapatkan penerbangan paket untuk aplikasi. Untuk penerbangan yang dibuat di Pusat Mitra, ID ini juga tersedia di URL untuk halaman penerbangan di Pusat Mitra . |
| submissionId | string | Harus diisi. ID pengiriman dengan info peluncuran paket yang akan didapatkan. ID ini tersedia dalam data respons untuk permintaan membuat pengiriman penerbangan paket. Untuk pengiriman yang dibuat di Pusat Mitra, ID ini juga tersedia di URL untuk halaman pengiriman di Pusat Mitra. |
Isi permintaan
Jangan berikan isi permintaan untuk metode ini.
Contoh permintaan
Contoh berikut menunjukkan cara mendapatkan info peluncuran paket untuk pengiriman penerbangan paket.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/packagerollout HTTP/1.1
Authorization: Bearer <your access token>
Respons
Contoh berikut menunjukkan isi respons JSON untuk panggilan yang berhasil ke metode ini untuk pengiriman penerbangan paket dengan peluncuran paket bertahap diaktifkan. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat Sumber daya peluncuran paket.
{
"isPackageRollout": true,
"packageRolloutPercentage": 25.0,
"packageRolloutStatus": "PackageRolloutInProgress",
"fallbackSubmissionId": "1212922684621243058"
}
Jika pengiriman paket penerbangan tidak mengaktifkan peluncuran paket bertahap, isi respons berikut akan dikembalikan.
{
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
}
Kode kesalahan
Jika permintaan tidak berhasil diselesaikan, respons akan berisi salah satu kode kesalahan HTTP berikut.
| Kode kesalahan | Deskripsi |
|---|---|
| 404 | Pengiriman penerbangan paket tidak dapat ditemukan. |
| 409 | Pengiriman penerbangan paket bukan milik penerbangan paket yang ditentukan, atau aplikasi menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store. |