Dapatkan penerbangan paket

  • Artikel

Gunakan metode ini di API pengiriman Microsoft Store untuk mendapatkan data untuk penerbangan paket untuk aplikasi yang terdaftar di akun Pusat Mitra Anda.

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 dapat memperoleh yang baru.

Minta

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

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

Meminta kop

Header Jenis Deskripsi
Authorization string Wajib diisi. Token akses Azure AD dalam bentukToken>pembawa<.

Parameter permintaan

Nama Jenis Deskripsi
applicationId string Wajib diisi. ID Toko aplikasi yang berisi penerbangan paket yang ingin Anda dapatkan. ID Toko untuk aplikasi tersedia di Pusat Mitra.
flightId string Wajib diisi. ID penerbangan paket yang akan didapatkan. 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.

Isi permintaan

Jangan berikan isi permintaan untuk metode ini.

Contoh permintaan

Contoh berikut menunjukkan cara mengambil informasi tentang penerbangan paket dengan ID 43e448df-97c9-4a43-a0bc-2a445e736bcd untuk aplikasi dengan nilai ID Toko 9WZDNCRD91MD.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd 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.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Isi Respons

Nilai Jenis Deskripsi
flightId string ID untuk penerbangan paket. Nilai ini disediakan oleh Pusat Mitra.
friendlyName string Nama penerbangan paket, seperti yang ditentukan oleh pengembang.
lastPublishedFlightSubmission objek Objek yang menyediakan informasi tentang pengiriman terakhir yang diterbitkan untuk penerbangan paket. Untuk informasi selengkapnya, lihat bagian Objek pengiriman di bawah ini.
pendingFlightSubmission objek Objek yang menyediakan informasi tentang pengiriman yang tertunda saat ini untuk penerbangan paket. Untuk informasi selengkapnya, lihat bagian Objek pengiriman di bawah ini.
groupIds array Array string yang berisi ID grup penerbangan yang terkait dengan penerbangan paket. Untuk informasi selengkapnya tentang grup penerbangan, lihat Penerbangan paket.
rankHigherThan string Nama yang mudah diingat dari penerbangan paket yang diberi peringkat lebih rendah dari penerbangan paket saat ini. Untuk informasi selengkapnya tentang peringkat grup penerbangan, lihat Penerbangan paket.

Objek pengiriman

Nilai lastPublishedFlightSubmission dan pendingFlightSubmission dalam isi respons berisi objek yang memberikan informasi sumber daya tentang pengiriman untuk penerbangan paket. Objek-objek ini memiliki nilai berikut.

Nilai Jenis Deskripsi
id string ID pengiriman.
resourceLocation string Jalur relatif yang dapat Anda tambahkan ke URI permintaan dasar https://manage.devcenter.microsoft.com/v1.0/my/ untuk mengambil data lengkap untuk pengiriman.

Kode kesalahan

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

Kode kesalahan Deskripsi
400 Permintaan tidak valid.
404 Penerbangan paket yang ditentukan tidak dapat ditemukan.
409 Aplikasi ini menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store.