Dapatkan status pengiriman paket penerbangan

Gunakan metode ini di API pengiriman Microsoft Store untuk mendapatkan status pengiriman paket penerbangan. Untuk informasi selengkapnya tentang proses pembuatan pengiriman paket penerbangan 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 AD untuk digunakan di header permintaan untuk metode ini. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakannya sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda bisa mendapatkan yang baru.
  • Buat pengiriman paket penerbangan untuk salah satu aplikasi Anda. Anda dapat melakukan ini di Pusat Mitra, atau Anda dapat melakukan ini dengan menggunakan metode pembuatan pengiriman penerbangan paket .

Minta

Metode ini memiliki sintaks berikut. Lihat bagian berikut untuk contoh penggunaan dan deskripsi header dan badan permintaan.

Metode URI Permintaan
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status

Header permintaan

Header Jenis Deskripsi
Authorization string Wajib diisi. Token akses Azure AD dalam bentuk Bearertoken<>.

Parameter permintaan

Nama Jenis Deskripsi
applicationId string Wajib diisi. ID Toko aplikasi yang berisi pengiriman paket penerbangan yang ingin Anda dapatkan statusnya. Untuk informasi selengkapnya tentang ID Toko, lihat Melihat detail identitas aplikasi.
flightId string Wajib diisi. ID penerbangan paket yang berisi kiriman yang ingin Anda dapatkan statusnya. ID ini tersedia dalam data respons untuk permintaan membuat paket penerbangan dan mendapatkan paket penerbangan untuk aplikasi. Untuk penerbangan yang dibuat di Pusat Mitra, ID ini juga tersedia di URL untuk halaman penerbangan di Pusat Mitra.
submissionId string Wajib diisi. ID pengajuan yang Ingin Anda dapatkan statusnya. ID ini tersedia dalam data respons untuk permintaan membuat pengiriman penerbangan paket. Untuk kiriman yang dibuat di Pusat Mitra, ID ini juga tersedia di URL untuk halaman pengiriman di Pusat Mitra.

Isi permintaan

Jangan memberikan badan permintaan untuk metode ini.

Contoh permintaan

Contoh berikut menunjukkan cara mendapatkan status pengiriman paket penerbangan.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/status HTTP/1.1
Authorization: Bearer <your access token>

Respons

Contoh berikut menunjukkan badan respons JSON untuk panggilan yang berhasil ke metode ini. Badan respons berisi informasi tentang pengiriman yang ditentukan. Untuk detail selengkapnya tentang nilai dalam badan respons, lihat bagian berikut.

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Isi respons

Nilai Jenis Deskripsi
status string Status pengajuan. Ini bisa menjadi salah satu nilai berikut:
  • Tidak ada
  • Batal
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • TertundaPublication
  • Menerbitkan
  • Diterbitkan
  • PublishFailed
  • Preprocessing
  • PreProcessingFailed
  • Sertifikasi
  • CertificationFailed
  • Rilis
  • ReleaseFailed
statusDetails objek Berisi detail tambahan tentang status pengiriman, termasuk informasi tentang kesalahan apa pun. Untuk informasi selengkapnya, lihat Sumber daya Detail status.

Kode galat

Jika permintaan tidak dapat berhasil diselesaikan, respons akan berisi salah satu kode kesalahan HTTP berikut.

Kode kesalahan Deskripsi
404 Pengajuan tidak dapat ditemukan.
409 Aplikasi ini menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store.