Menerapkan pengiriman penerbangan paket
Gunakan metode ini di API pengiriman Microsoft Store untuk menerapkan pengiriman penerbangan paket baru atau yang diperbarui ke Pusat Mitra. Tindakan penerapan memperingatkan Pusat Mitra bahwa data pengiriman telah diunggah (termasuk paket terkait). Sebagai respons, Pusat Mitra menerapkan perubahan pada data pengiriman untuk penyerapan dan penerbitan. Setelah operasi penerapan berhasil, perubahan pada pengiriman ditampilkan di Pusat Mitra.
Untuk informasi selengkapnya tentang bagaimana operasi penerapan sesuai dengan 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 lalu perbarui pengiriman dengan perubahan yang diperlukan pada data pengiriman.
Minta
Metode ini memiliki sintaks berikut. Lihat bagian berikut untuk contoh penggunaan dan deskripsi header dan isi permintaan.
Metode | URI Permintaan |
---|---|
POST | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit |
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 yang ingin Anda terapkan. ID Toko untuk aplikasi tersedia di Pusat Mitra. |
flightId | string | Harus diisi. ID penerbangan paket yang berisi pengiriman untuk dilakukan. 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 yang akan dilakukan. 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 melakukan pengiriman penerbangan paket.
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/commit HTTP/1.1
Authorization: Bearer <your access token>
Respons
Contoh berikut menunjukkan isi respons JSON untuk panggilan yang berhasil ke metode ini. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat bagian berikut ini.
{
"status": "CommitStarted"
}
Isi respons
Nilai | Tipe | Deskripsi |
---|---|---|
status | string | Status pengiriman. Ini bisa menjadi salah satu nilai berikut:
|
Kode kesalahan
Jika permintaan tidak berhasil diselesaikan, respons akan berisi salah satu kode kesalahan HTTP berikut.
Kode kesalahan | Deskripsi |
---|---|
400 | Parameter permintaan tidak valid. |
404 | Pengiriman yang ditentukan tidak dapat ditemukan. |
409 | Pengiriman yang ditentukan ditemukan tetapi tidak dapat dilakukan dalam statusnya saat ini, atau aplikasi menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store. |
Topik terkait
- Membuat dan mengelola pengiriman menggunakan layanan Microsoft Store
- Mengelola pengiriman penerbangan paket
- Dapatkan pengiriman penerbangan paket
- Membuat pengiriman penerbangan paket
- Memperbarui pengiriman penerbangan paket
- Menghapus pengiriman penerbangan paket
- Mendapatkan status pengiriman penerbangan paket