Mendapatkan semua aplikasi

  • Artikel

Gunakan metode ini di API pengiriman Microsoft Store untuk mengambil data untuk aplikasi yang terdaftar ke 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

Meminta kop

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

Parameter permintaan

Semua parameter permintaan bersifat opsional untuk metode ini. Jika Anda memanggil metode ini tanpa parameter, respons berisi data untuk 10 aplikasi pertama yang terdaftar ke akun Anda.

Parameter Jenis Deskripsi Diperlukan
top int Jumlah item yang akan dikembalikan dalam permintaan (yaitu, jumlah aplikasi yang akan dikembalikan). Jika akun Anda memiliki lebih banyak aplikasi 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 mengambil 10 aplikasi pertama yang terdaftar ke akun Anda.

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

Contoh berikut menunjukkan cara mengambil informasi tentang semua aplikasi yang terdaftar ke akun Anda. Pertama, dapatkan 10 aplikasi teratas:

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

Kemudian panggil GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink} secara rekursif hingga {@nextlink} null atau tidak ada dalam respons. Contohnya:

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=20&top=10 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=30&top=10 HTTP/1.1
Authorization: Bearer <your access token>

Jika Anda sudah mengetahui jumlah total aplikasi yang Anda miliki di akun Anda, Anda cukup meneruskan nomor tersebut di parameter teratas untuk mendapatkan informasi tentang semua aplikasi Anda.

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

Respons

Contoh berikut menunjukkan isi respons JSON yang dikembalikan oleh permintaan yang berhasil untuk 10 aplikasi pertama yang terdaftar ke akun pengembang dengan total 21 aplikasi. Untuk keringkasan, contoh ini hanya menampilkan data untuk dua aplikasi pertama yang dikembalikan oleh permintaan. Untuk detail selengkapnya tentang nilai dalam isi respons, lihat bagian berikut ini.

{
  "@nextLink": "applications?skip=10&top=10",
  "value": [
    {
      "id": "9NBLGGH4R315",
      "primaryName": "Contoso sample app",
      "packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp_ng6try80pwt52",
      "packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp",
      "publisherName": "CN=…",
      "firstPublishedDate": "2016-03-11T01:32:11.0747851Z",
      "pendingApplicationSubmission": {
        "id": "1152921504621134883",
        "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621134883"
      }
    },
    {
      "id": "9NBLGGH29DM8",
      "primaryName": "Contoso sample app 2",
      "packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp2_ng6try80pwt52",
      "packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp2",
      "publisherName": "CN=…",
      "firstPublishedDate": "2016-03-12T01:49:11.0747851Z",
      "lastPublishedApplicationSubmission": {
        "id": "1152921504621225621",
        "resourceLocation": "applications/9NBLGGH29DM8/submissions/1152921504621225621"
      }
      // Next 8 apps are omitted for brevity ...
    }
  ],
  "totalCount": 21
}

Isi Respons

Nilai Jenis Deskripsi
nilai array Array objek yang berisi informasi tentang setiap aplikasi yang terdaftar ke akun Anda. Untuk informasi selengkapnya tentang data di setiap objek, lihat Sumber daya aplikasi.
@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 10 tetapi ada 20 aplikasi yang terdaftar ke akun Anda, isi respons akan menyertakan @nextLink nilai applications?skip=10&top=10, yang menunjukkan bahwa Anda dapat memanggil https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 untuk meminta 10 aplikasi berikutnya.
totalCount int Jumlah total baris dalam hasil data untuk kueri (yaitu, jumlah total aplikasi yang didaftarkan ke akun Anda).

Kode kesalahan

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

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