Mendapatkan penerbangan paket untuk aplikasi

  • Artikel

Gunakan metode ini di API pengiriman Microsoft Store untuk mencantumkan penerbangan paket untuk aplikasi yang terdaftar ke akun Pusat Mitra Anda. Untuk informasi selengkapnya tentang penerbangan paket, lihat 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 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}/listflights

Meminta kop

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

Parameter permintaan

Nama Jenis Deskripsi Diperlukan
applicationId string ID Toko aplikasi yang ingin Anda ambil penerbangan paketnya. Untuk informasi selengkapnya tentang ID Toko, lihat Menampilkan detail identitas aplikasi. Ya
top int Jumlah item yang akan dikembalikan dalam permintaan (yaitu, jumlah penerbangan paket yang akan dikembalikan). Jika akun Anda memiliki lebih banyak penerbangan paket daripada nilai yang Anda tentukan dalam kueri, isi respons menyertakan jalur URI relatif yang dapat Anda tambahkan ke metode URI untuk meminta halaman data berikutnya. Tidak
skip int Jumlah item yang akan dilewati dalam kueri sebelum mengembalikan item yang tersisa. Gunakan parameter ini untuk halaman melalui himpunan data. Misalnya, top=10 dan skip=0 mengambil item 1 sampai 10, top=10 dan skip=10 mengambil item 11 hingga 20, dan sebagainya. Tidak

Isi permintaan

Jangan berikan isi permintaan untuk metode ini.

Contoh permintaan

Contoh berikut menunjukkan cara mencantumkan semua penerbangan paket untuk aplikasi.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights HTTP/1.1
Authorization: Bearer <your access token>

Contoh berikut menunjukkan cara mencantumkan penerbangan paket pertama untuk aplikasi.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights?top=1 HTTP/1.1
Authorization: Bearer <your access token>

Respons

Contoh berikut menunjukkan isi respons JSON yang dikembalikan oleh permintaan yang berhasil untuk penerbangan paket pertama untuk aplikasi dengan tiga total penerbangan paket. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat bagian berikut ini.

{
  "value": [
    {
      "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
      "friendlyName": "myflight",
      "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
      },
      "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
      },
      "groupIds": [
        "1152921504606962205"
      ],
      "rankHigherThan": "Non-flighted submission"
    }
  ],
  "totalCount": 3
}

Isi Respons

Nilai Jenis Deskripsi
@nextLink string Jika ada halaman data tambahan, string ini berisi jalur relatif yang dapat Anda tambahkan ke URI permintaan dasar https://manage.devcenter.microsoft.com/v1.0/my/ untuk meminta halaman data berikutnya. Misalnya, jika parameter teratas isi permintaan awal diatur ke 2 tetapi ada 4 penerbangan paket untuk aplikasi, isi respons akan menyertakan @nextLink nilai applications/{applicationid}/listflights/?skip=2&top=2, yang menunjukkan bahwa Anda dapat memanggil https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 untuk meminta 2 penerbangan paket berikutnya.
nilai array Array objek yang menyediakan informasi tentang penerbangan paket untuk aplikasi yang ditentukan. Untuk informasi selengkapnya tentang data di setiap objek, lihat Sumber daya penerbangan.
totalCount int Jumlah total baris dalam hasil data untuk kueri (yaitu, jumlah total penerbangan paket untuk aplikasi yang ditentukan).

Kode kesalahan

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

Kode kesalahan Deskripsi
404 Tidak ada penerbangan paket yang ditemukan.
409 Aplikasi ini menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store.