Pendaftaran aplikasi OAuth 2.0

Mendaftar aplikasi OAuth 2.0 Anda memungkinkan akses ke sumber daya Roblox. Setelah pendaftaran, Roblox memberikan ID klien dan rahasia unik untuk aplikasi yang dapat Anda gunakan untuk mendapatkan otorisasi dari pengguna untuk mengakses informasi dan sumber daya Roblox mereka.

Daftarkan aplikasi Anda

Untuk mendaftarkan aplikasi:

1. Di Dasbor Pembuat, buka halaman Aplikasi OAuth 2.0.
2. Klik tombol Buat Aplikasi.
3. Masukkan Nama Aplikasi yang valid dan unik secara global.
4. Baca dan setujui Ketentuan Layanan Roblox dan klik Buat.
5. Salin dan simpan ID Klien dan Rahasia di tempat yang aman. Setelah menutup halaman, Anda tidak akan lagi memiliki akses ke rahasia tersebut dan hanya dapat menghasilkan yang baru. Setelah Anda selesai mendaftarkan aplikasi, Anda masih dapat mengakses dan mengedit properti aplikasi lainnya.
6. Klik Lanjutkan untuk Mengedit untuk mengonfigurasi aplikasi Anda, yang dijelaskan dalam bagian berikut.

Konfigurasi informasi umum

Setelah Anda mendaftar aplikasi Anda, Anda harus mengonfigurasi informasi umumnya, termasuk:

• Deskripsi, yang terlihat oleh semua orang di komunitas Roblox.
• Gambar thumbnail untuk aplikasi Anda. Ukuran file yang direkomendasikan adalah setidaknya 150x150 piksel.
• Tautan Masuk sebagai titik masuk aplikasi Anda, seperti halaman utama situs web aplikasi.
• URL Ketentuan Privasi dan URL Ketentuan Layanan untuk dibaca pengguna akhir sebelum mengizinkan aplikasi Anda. Setiap URL harus menggunakan HTTPS dan tidak lebih dari 256 karakter.

Tambahkan izin

Untuk memastikan kontrol akses dan keamanan yang tepat dalam aplikasi Anda, Anda harus menambahkan Ruang Izin. Ada dua jenis ruang izin yang tersedia:

• Ruang identitas untuk otentikasi, seperti openid untuk ID pengguna dan profile untuk profil lengkap. Jika Anda memilih ruang profile, Anda juga harus memilih openid.
• Ruang izin khusus API, seperti asset:read untuk izin baca aset. Pilih hanya jumlah ruang minimum yang Anda butuhkan untuk aplikasi Anda.

Tambahkan URL pengalihan

URL Pengalihan adalah titik masuk kembali aplikasi Anda yang digunakan pengguna saat mereka selesai mengizinkan aplikasi Anda. Pastikan URL pengalihan Anda memenuhi persyaratan berikut:

• Semua URL pengalihan harus dalam salah satu bentuk berikut:

  • HTTPS biasa, misalnya: https://www.example.com.`
  • Jalur di localhost dengan HTTP atau HTTPS (sertifikat yang ditandatangani sendiri) untuk tujuan debug lokal, misalnya:

    • `http://localhost:80``
    • `https://localhost:80``
  • Skema khusus untuk aplikasi atau tujuan tertentu, misalnya:

    • my-app-scheme:/
    • my-app-scheme://foo/bar/...
    • my-app://action?param1=value1&param2=value2
• Panjang maksimum sebuah URL pengalihan adalah 256 karakter.
• Anda dapat menambahkan hingga 10 URL pengalihan. Dengan beberapa URL pengalihan, Anda dapat memiliki lingkungan pengujian dan memungkinkan pengguna untuk beralih antara dua situs tanpa waktu henti.

Kirim untuk ulasan

Untuk meminimalkan kemungkinan aplikasi jahat merusak komunitas, mendaftar aplikasi tidak membuatnya dapat diakses secara luas. Sebagai gantinya, aplikasi tetap dalam mode pribadi dengan batas 10 pengguna unik. Mode ini berguna untuk pengujian dan debugging dalam tim Anda.

Jika Anda ingin memperluas basis pengguna untuk aplikasi Anda, Anda perlu menerbitkannya dalam mode publik dengan mengirimkannya untuk ulasan:

1. Buka halaman aplikasi OAuth 2.0.
2. Klik tombol Edit dan Publikasikan untuk aplikasi yang ingin Anda terbitkan.
3. Isi semua informasi yang diperlukan dan klik tombol Ulas dan Publikasikan. Pesan dengan batasan pada izin aplikasi Anda selama periode ulasan yang sedang berlangsung akan muncul.
4. Klik Kirim untuk Ulasan.

Sementara ulasan aplikasi Anda sedang menunggu, Anda tidak dapat mengedit atau mengirim permintaan lain sampai permintaan ulasan yang sedang berlangsung disetujui atau ditolak. Aplikasi Anda akan tetap dalam mode pribadi selama ulasan. Ketika aplikasi Anda disetujui, itu akan beralih ke mode publik, dan Anda tidak dapat mengembalikannya kembali ke mode pribadi.

Terlepas dari apakah aplikasi Anda disetujui atau ditolak, Anda akan menerima pemberitahuan email tentang hasilnya ketika ulasan selesai.

Edit dan hapus aplikasi Anda

Anda dapat mengedit atau menghapus aplikasi Anda dengan langkah-langkah berikut jika aplikasi tersebut tidak sedang dalam ulasan:

1. Buka halaman aplikasi OAuth 2.0.

2. Klik Edit atau Hapus untuk aplikasi yang diinginkan.

   • Jika Anda memilih untuk mengedit aplikasi, ikuti langkah-langkah dan persyaratan yang sama dari pendaftaran.
   • Jika Anda memilih untuk menghapus aplikasi, klik Ya, Hapus untuk mengonfirmasi penghapusan. Setelah Anda menghapus aplikasi, Anda tidak dapat memulihkannya.

Mengubah informasi umum aplikasi Anda atau URL pengalihan tidak memerlukan pengguna untuk mengizinkan ulang aplikasi. Namun, jika Anda menambahkan atau mengubah ruang izin, Anda harus mendapatkan otorisasi untuk izin baru dari pengguna Anda dan memperoleh sekumpulan token baru. Jika Anda tidak mendapatkan otorisasi untuk ruang baru, aplikasi Anda dapat terus menggunakan token yang ada, tetapi dibatasi hanya pada ruang sebelumnya.

Untuk aplikasi dalam mode pribadi, sistem secara otomatis memperbarui editan Anda dengan pengguna Anda. Untuk aplikasi dalam mode publik, Anda harus menyerahkan aplikasi untuk ulasan lagi untuk mencerminkan perubahan ini. Jika tidak, sistem menyimpan perubahan yang belum diterbitkan untuk Anda tanpa merilisnya ke komunitas.