> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/id/guide/account/user-applications/creating-new-user-applications.md). # Membuat Aplikasi pengguna baru Siapkan aplikasi Pengguna baru di Navixy dengan mengonfigurasi URL integrasi dan parameter lainnya untuk menghubungkan alat eksternal ke antarmuka platform. Saat menyiapkan sebuah **Aplikasi pengguna**, Anda akan bekerja dengan beberapa konfigurasi utama yang menentukan bagaimana aplikasi eksternal Anda terintegrasi dengan platform Navixy. Mari kita bahas setiap komponen penting. Mulailah dengan mengeklik chrome_py0qhiu5p8.webp tombol di **Aplikasi pengguna** daftar. Di formulir konfigurasi yang muncul, lanjutkan dengan langkah-langkah berikut: {% stepper %} {% step %} ## Atur URL Tentukan URL aplikasi Anda, yaitu alamat tempat aplikasi Anda dihosting; ini menjadi dasar integrasi. {% hint style="danger" %} * Pastikan URL valid, menggunakan koneksi HTTPS, mengarah ke sumber tepercaya, dan tidak melebihi 1000 karakter. * Pastikan aplikasi memiliki pengaturan iFrame yang diaktifkan di sisinya, jika tidak, Anda tidak akan dapat membukanya di antarmuka platform. {% endhint %} {% endstep %} {% step %} ## Konfigurasikan parameter dasar Untuk mempersonalisasi aplikasi Anda, Anda dapat menyertakan berbagai parameter dalam URL. Anda dapat menambahkan parameter secara manual di kolom URL atau menggunakan salah satu saran kami: bahasa, ID pengguna, atau zona waktu. Klik salah satu saran parameter untuk menambahkannya ke akhir URL. Buka deskripsi di bawah untuk mempelajari lebih lanjut tentang parameter yang disarankan dan contohnya.
Memahami parameter URL yang disarankan Navixy menyarankan beberapa parameter dasar untuk personalisasi 1. `?locale={locale_code}`\ Parameter bahasa yang secara otomatis menyesuaikan dengan bahasa platform pengguna. * Contoh: `https://your-app.com/dashboard?locale=en` 2. `?user_id={user_identifier}`\ Parameter konteks pengguna yang meneruskan identitas pengguna untuk memfilter informasi yang dipersonalisasi. * Contoh: `https://your-app.com/dashboard?user_id=12345` 3. `?timezone={timezone}`\ Parameter waktu yang secara otomatis menyesuaikan dengan zona waktu platform pengguna. * Contoh: `https://your-app.com/dashboard?timezone=UTC+1` Anda dapat mengedit nama parameter yang disarankan atau menentukan nilai tertentu untuknya.
![Contoh URL aplikasi dengan parameter](https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5ef1c1516fcc65f19333029d0918f4a42d1a5605%2FURL_with_Params.png?alt=media) {% hint style="info" %} Uji konfigurasi Anda untuk memastikan aplikasi dimuat dengan benar. Klik image-20241217-083119.png untuk menampilkan pratinjau. {% endhint %} {% endstep %} {% step %} ## Sesuaikan tampilan Buat identitas yang mudah dikenali untuk aplikasi Anda agar mudah diakses. Pengaturan berikut akan membantu Anda melakukannya: * **Label**: Tambahkan nama yang unik dan deskriptif untuk aplikasi Anda (hingga 24 karakter). Nama ini ditampilkan di bilah sisi platform. * **Deskripsi**: Tambahkan penjelasan singkat dengan detail tentang fungsionalitas aplikasi atau sorot informasi penting (hingga 50 karakter). Deskripsi yang informatif membantu pengguna Anda memahami tujuan aplikasi dengan lebih jelas. * **Ikon**: Pilih ikon yang mewakili fungsi aplikasi Anda untuk navigasi yang lebih menyatu dengan platform. {% endstep %} {% step %} ## Pilih metode tampilan Tentukan cara aplikasi Anda terbuka dengan memilih salah satu dari dua opsi di **Buka di** menu tarik-turun: * **Tersemat**: Aplikasi muncul di dalam antarmuka platform * **Tab baru**: Aplikasi dibuka di tab browser terpisah {% hint style="info" %} Platform Navixy menggunakan iFrame untuk penyematan. Karena tidak semua URL dapat diproses dengan sukses menggunakan teknologi ini, pastikan untuk melihat pratinjau hasil penyematan. Jika Anda mengalami masalah apa pun dengan metode tampilan ini, pertimbangkan untuk menggunakan **Tab baru**. {% endhint %} {% endstep %} {% step %} ## Atur autentikasi (opsional) Konfigurasikan autentikasi jika aplikasi Anda bergantung pada API platform. Dalam hal ini, platform akan menyediakan data autentikasi secara langsung kepada aplikasi saat dibuka, sehingga tidak perlu menerapkan fungsi login tambahan di sisi aplikasi Anda.\ Anda dapat memilih salah satu dari dua metode autentikasi berikut: * **kunci API** * Metode ini untuk aplikasi yang tidak memerlukan manajemen peran atau izin pengguna. * Kunci API sesuai dengan tingkat akses Pemilik akun. Ini berarti memberikan kunci API kepada pengguna biasa dapat memberi mereka akses ke **semua data** yang tersedia bagi pengguna utama.\ Misalnya, jika aplikasi Anda bekerja dengan perangkat GPS yang hak akses pengguna terbatas atau tidak sama sekali, penggunaan kunci API tetap mengekspos semua perangkat GPS dari akun utama. * **Kunci sesi** * Metode ini direkomendasikan ketika manajemen peran terlibat. * Meneruskan kunci sesi pengguna saat ini ke aplikasi. {% hint style="info" %} Memilih **kunci API** metode ini secara otomatis menonaktifkan **Kunci sesi** metode lainnya, dan sebaliknya. Hanya satu metode yang dapat digunakan pada satu waktu. {% endhint %} Saat autentikasi diaktifkan, platform menambahkan `?session_key=` parameter ke URL aplikasi Anda. * Jika Anda telah memilih sebuah **kunci API**, nilai parameter berisi kunci ini. * Jika Anda memilih sebuah **Kunci sesi**, nilai parameter menyertakan kunci sesi pengguna saat ini yang sedang digunakan untuk mengakses aplikasi. Pastikan aplikasi mampu membaca dan menggunakan parameter ini. {% endstep %} {% step %} ## Simpan aplikasi baru Klik **Simpan** tombol. Aplikasi Anda muncul di **Aplikasi pengguna** daftar dan bilah sisi platform. Aplikasi yang diaktifkan secara otomatis menjadi tersedia bagi pengguna akun. {% endstep %} {% endstepper %}

Contoh tampilan aplikasi pengguna yang disematkan

Tips pemecahan masalah cepat Jika aplikasi Anda tidak ditampilkan dengan benar saat disematkan, coba: * Buka di tab baru sebagai gantinya * Memverifikasi bahwa URL Anda benar dan dapat diakses * Memeriksa bahwa semua parameter diformat dengan benar
Aplikasi yang dibuat tetap dapat dikonfigurasi sepenuhnya setelah disimpan. Anda dapat menyesuaikan parameter dan tampilannya kapan saja. Untuk mempelajari lebih lanjut tentang pengelolaan aplikasi, lihat [Mengelola Aplikasi pengguna yang sudah ada](/docs/user/id/guide/account/user-applications/managing-existing-user-applications.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/user/id/guide/account/user-applications/creating-new-user-applications.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.