Bagikan melalui

Dokumentasi API App Center

Penting

Visual Studio App Center dihentikan pada 31 Maret 2025, kecuali untuk fitur Analitik dan Diagnostik, yang akan terus didukung hingga 30 Juni 2026. Pelajari lebih lanjut.

Spesifikasi OpenAPI dari App Center (Swagger)

App Center mengekspos sekumpulan titik akhir API lengkap. Anda dapat menjelajahi API App Center melalui Spesifikasi OpenAPI App Center.

Spesifikasi App Center OpenAPI memungkinkan Anda mengautentikasi menggunakan token API Anda. Setelah diautentikasi, Anda dapat memanggil API App Center untuk mempelajari tentang API dan melihat data apa yang dikembalikannya.

Jenis token: token pengguna dan token aplikasi

App Center memaparkan dua jenis token API: token pengguna, dan token aplikasi.

Token API pengguna memiliki hak yang sama dengan yang Anda lakukan sebagai pengguna App Center. Token API pengguna berfungsi di semua organisasi dan aplikasi yang terkait dengan Anda.

Token API Aplikasi memiliki hak Manajer atau Penampil, tetapi hanya dalam satu aplikasi.

Setiap akun App Center dapat membuat hingga 5000 token API.

Petunjuk / Saran

Sebaiknya buat dan gunakan token App API untuk membatasi cakupan otorisasi hanya untuk satu aplikasi pada satu waktu (dan membatasi risiko jika token diekspos). Jika Anda perlu mengotomatiskan sesuatu di luar satu aplikasi, seperti bekerja dengan organisasi atau grup distribusi bersama, Anda harus membuat token API Pengguna.

Peringatan

Jangan sematkan token API ke dalam kode sumber. Token API harus diperlakukan sebagai rahasia, dan disimpan dengan aman.

Peringatan

Permintaan harus berisi isi payload untuk panggilan POST/PUT/PATCH API. Gunakan {} untuk payload kosong, jika tidak, panggilan API akan menerima respons kesalahan 411 Length Required.

Membuat token API App Center

  1. Navigasikan ke https://appcenter.ms dan masuk menggunakan kredensial akun Anda.

  2. Pilih aplikasi yang ingin Anda buat token APInya.

  3. Di sisi kiri, pilih Pengaturan.

  4. Di panel tengah, pilih Token API Aplikasi dari daftar menu.

  5. Di sudut kanan atas, klik Token API baru.

  6. Di bidang teks, masukkan nama deskriptif untuk token Anda.

  7. Pilih jenis akses untuk token API Aplikasi Anda:

    Akses Penuh: Token APP API akses penuh memiliki izin Manajer yang setara untuk aplikasi tersebut. Hanya Manajer yang dapat membuat token APP API akses penuh.

    Hanya-Dibaca: Token API Aplikasi hanya-dibaca memiliki izin akses setara dengan Penampil untuk aplikasi tersebut. Para manajer dan pengembang dapat membuat token API baca-saja aplikasi.

  8. Di bagian bawah panel, klik Tambahkan token API baru.

  9. Pop-up akan terbuka dengan token API Aplikasi Anda. Salin dan simpan di lokasi yang aman untuk digunakan nanti. Untuk alasan keamanan, Anda tidak dapat melihat atau menghasilkan token yang sama lagi setelah Mengklik tombol Tutup .

  10. Klik tombol Tutup .

Membuat token API Pengguna App Center

  1. Navigasikan ke https://appcenter.ms dan masuk menggunakan kredensial akun Anda.

  2. Di sudut kanan atas portal App Center, klik avatar akun Anda, lalu pilih Pengaturan Akun.

  3. Di panel tengah, pilih Token API Pengguna dari daftar menu.

  4. Di sudut kanan atas, klik Token API baru.

  5. Di bidang teks, masukkan nama deskriptif untuk token Anda.

  6. Pilih jenis akses untuk token API Pengguna Anda:

    Akses Penuh: Token API Pengguna akses penuh memiliki semua izin yang Anda miliki untuk akun /organisasi saat ini. Misalnya, jika Anda tidak memiliki izin manajer atau pengembang untuk aplikasi, pengguna tidak dapat menjalankan pengujian, meskipun Anda menggunakan token API Pengguna akses penuh.

    Baca-Saja: Token API Pengguna baca-saja memiliki izin akses Penampil untuk akun/organisasi saat ini. Misalnya, dengan token API Pengguna baca-saja, Anda dapat membaca data dari crash, analitik, dan mendapatkan informasi aplikasi dasar. Token API Pengguna yang hanya-bisa-dibaca tidak dapat mengubah pengaturan aplikasi, membuat konfigurasi ekspor, dll.

  7. Di bagian bawah panel, klik Tambahkan token API baru.

  8. Pop-up akan terbuka dengan token API Pengguna Anda. Salin dan simpan di lokasi yang aman untuk digunakan nanti. Untuk alasan keamanan, Anda tidak dapat melihat atau menghasilkan token yang sama lagi setelah Mengklik tombol Tutup .

  9. Klik tombol Tutup .

Menggunakan Token API dalam permintaan API

Saat mengirim permintaan API ke App Center dari aplikasi, Anda harus menyertakan token API di header setiap permintaan yang dikirim ke App Center.

Teruskan token API di properti header permintaan X-API-Token .

Menemukan nama aplikasi dan nama pemilik App Center Anda

Beberapa fungsi API dan permintaan CLI App Center memerlukan nama aplikasi atau nama pemilik sebagai parameter.

Misalnya, panggilan API untuk menghapus pengguna dari aplikasi memerlukan keduanya: DELETE /v0.1/apps/{owner_name}/{app_name}/users/{user_email}.

Anda dapat menemukan nama aplikasi dan nama pemilik dari URL App Center, atau menggunakan CLI App Center.

Temukan owner_name dan app_name dari URL App Center

  1. Pindah ke https://appcenter.ms.
  2. Navigasi ke aplikasi Anda.
  3. Saat Anda melihat URL aplikasi, URL tersebut dalam format https://appcenter.ms/users/{owner-name}/apps/{app-name}.

Pemilik dapat menjadi pengguna atau organisasi. Contohnya:

Pemilik URL Nama pemilik Nama aplikasi
Pengguna https://appcenter.ms/users/AlexLerxst/apps/Caravan-01 AlexLerxst Karavan-01
Organisasi https://appcenter.ms/orgs/BallardFlowers/apps/BouquetOrders-app BallardFlowers BouquetOrders-aplikasi

Temukan owner_name dan app_name dari App Center CLI

Jika Anda belum menginstal CLI App Center, instruksi penginstalan dan penggunaan dapat ditemukan di dokumentasi App Center CLI.

Setelah diinstal, ambil daftar aplikasi yang dapat Anda akses dengan menjalankan:

appcenter apps list

App Center CLI akan menampilkan daftar aplikasi, dengan format {owner-name}/{app-name}.

Lihat dokumentasi App Center CLI untuk daftar lengkap fungsi baris perintah.

Menggunakan Token API dalam Spesifikasi OpenAPI App Center

Spesifikasi OpenAPI Pusat Aplikasi menangani autentikasi API untuk Anda, sehingga Anda tidak perlu menempelkan token API ke header untuk permintaan Anda. Untuk menguji API App Center dengan token API Anda:

  1. Akses spesifikasi OpenAPI App Center untuk menjelajahi API kami.

  2. Di sudut kanan atas, klik tombol Otorisasi .

  3. Di bawah bagian APIToken , tempelkan token API ke nilai dan klik Otorisasi.

    Mengatur token API untuk mengotorisasi penggunaan App Center

  4. Jika menunjukkan "Resmi" dan tombol Keluar, otorisasi berhasil. Di sudut kanan atas pop-up, klik "X" untuk keluar dari pop-up.

Melakukan panggilan API pertama Anda menggunakan OpenAPI (Swagger)

Bagian ini menunjukkan kepada Anda cara menggunakan halaman OpenAPI App Center dengan menggunakan panggilan GET /v0.1/userAPI . Panggilan API ini mengembalikan data profil pengguna.

  1. Buat token API dengan mengikuti instruksi di atas.
  2. Otorisasi halaman Spesifikasi OpenAPI untuk menggunakan token API Anda mengikuti instruksi di bagian sebelumnya.
  3. Di bawah Akun, klik GET /v0.1/user.
  4. Di sudut kiri, klik tombol Coba .
  5. Klik tombol Jalankan di bawah bagian Parameter .
  6. Hebat! Sekarang Anda dapat melihat respons di bawah bagian Respons .

Mencabut Token API

Jika token API bocor, Anda harus segera mencabutnya untuk mencegah akses tidak sah ke akun App Center Anda.

Mencabut token API Pengguna

  1. Pindah ke https://appcenter.ms.
  2. Di sudut kanan atas portal App Center, klik avatar akun Anda, lalu pilih Pengaturan Akun.
  3. Di panel tengah, pilih Token API Pengguna dari menu.
  4. Centang kotak di samping token yang ingin Anda cabut, dan klik tombol Hapus di sudut kanan atas.

Mencabut token API Aplikasi

  1. Pindah ke https://appcenter.ms.
  2. Pilih aplikasi yang ingin Anda cabut token APInya.
  3. Di sisi kiri, pilih Pengaturan.
  4. Di panel tengah, pilih Token API Aplikasi dari menu.
  5. Centang kotak di samping token yang ingin Anda cabut, dan klik tombol Hapus di sudut kanan atas.
  • Last updated on