Membuat penerbangan paket

  • Artikel

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

Catatan

Metode ini membuat penerbangan paket tanpa pengiriman apa pun. Untuk membuat pengiriman untuk penerbangan paket, lihat metode dalam 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 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
KIRIM https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

Meminta header

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 ingin Anda buat penerbangan paketnya. Untuk informasi selengkapnya tentang ID Toko, lihat Menampilkan detail identitas aplikasi.

Isi permintaan

Isi permintaan memiliki parameter berikut.

Parameter Jenis Deskripsi Diperlukan
friendlyName string Nama penerbangan paket, seperti yang ditentukan oleh pengembang. Tidak
groupIds array Array string yang berisi ID grup penerbangan yang terkait dengan penerbangan paket. Untuk informasi selengkapnya tentang grup penerbangan, lihat Penerbangan paket. Tidak
rankHigherThan string Nama yang mudah diingat dari penerbangan paket yang diberi peringkat lebih rendah dari penerbangan paket saat ini. Jika Anda tidak mengatur parameter ini, penerbangan paket baru akan memiliki peringkat tertinggi dari semua penerbangan paket. Untuk informasi selengkapnya tentang peringkat grup penerbangan, lihat Penerbangan paket. Tidak

Contoh permintaan

Contoh berikut menunjukkan cara membuat penerbangan paket baru untuk aplikasi yang memiliki ID Toko 9WZDNCRD911W.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

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",
  "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 dalam permintaan.
groupIds array Array string yang berisi ID grup penerbangan yang terkait dengan penerbangan paket, seperti yang ditentukan dalam permintaan. Untuk informasi selengkapnya tentang grup penerbangan, lihat Penerbangan paket.
rankHigherThan string Nama yang mudah diingat dari penerbangan paket yang diberi peringkat segera lebih rendah dari penerbangan paket saat ini, seperti yang ditentukan dalam permintaan. Untuk informasi selengkapnya tentang peringkat grup penerbangan, lihat Penerbangan paket.

Kode kesalahan

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

Kode kesalahan Deskripsi
400 Permintaan tidak valid.
409 Penerbangan paket tidak dapat dibuat karena statusnya saat ini, atau aplikasi menggunakan fitur Pusat Mitra yang saat ini tidak didukung oleh API pengiriman Microsoft Store.