> 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
Saat menyiapkan sebuah **aplikasi pengguna**, Anda akan bekerja dengan beberapa konfigurasi kunci yang menentukan bagaimana aplikasi eksternal Anda terintegrasi dengan platform Navixy. Mari kita bahas setiap komponen penting.
Mulailah dengan mengeklik tombol di **Aplikasi pengguna** daftar. Di formulir konfigurasi yang muncul, lanjutkan dengan langkah-langkah berikut:
{% stepper %}
{% step %}
## Menyiapkan 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 daya tepercaya, dan tidak melebihi 1.000 karakter.
* Pastikan pengaturan iFrame pada aplikasi diaktifkan di sisi aplikasinya, jika tidak Anda tidak akan dapat membukanya di antarmuka platform.
{% endhint %}
{% endstep %}
{% step %}
## Mengonfigurasi 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 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 cocok 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 cocok 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.
{% hint style="info" %}
Uji konfigurasi Anda untuk memastikan aplikasi dimuat dengan benar. Klik untuk menampilkan pratinjau.
{% endhint %}
{% endstep %}
{% step %}
## Menyesuaikan 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 fungsi aplikasi atau soroti informasi penting (hingga 50 karakter). Deskripsi yang informatif membantu pengguna Anda memperoleh pemahaman yang lebih jelas tentang tujuan aplikasi.
* **Ikon**: Pilih ikon yang mewakili fungsi aplikasi Anda untuk navigasi yang lebih alami.
{% endstep %}
{% step %}
## Pilih metode tampilan
Tentukan cara aplikasi Anda dibuka dengan memilih salah satu dari dua opsi di **Buka di** menu tarik-turun:
* **Tertanam**: 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 teknologi ini secara berhasil, pastikan Anda meninjau hasil penyematan. Jika Anda mengalami masalah dengan metode tampilan ini, pertimbangkan untuk menggunakan **Tab baru**.
{% endhint %}
{% endstep %}
{% step %}
## Menyiapkan autentikasi (opsional)
Konfigurasikan autentikasi jika aplikasi Anda bergantung pada API platform. Dalam hal ini, platform akan menyediakan data autentikasi secara langsung kepada aplikasi saat aplikasi dibuka, sehingga tidak perlu menerapkan fungsi masuk tambahan di sisi aplikasi Anda.\
Anda dapat memilih salah satu dari dua metode autentikasi:
* **kunci API**
* Metode ini ditujukan untuk aplikasi yang tidak memerlukan pengelolaan 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.\
Sebagai contoh, jika aplikasi Anda bekerja dengan perangkat GPS yang aksesnya dibatasi bagi pengguna atau bahkan tidak ada akses sama sekali, penggunaan Kunci API tetap akan mengekspos semua perangkat GPS dari akun utama.
* **Kunci sesi**
* Metode ini direkomendasikan ketika pengelolaan peran terlibat.
* Meneruskan kunci sesi pengguna saat ini ke aplikasi.
{% hint style="info" %}
Memilih **kunci API** metode secara otomatis menonaktifkan **Kunci sesi** metode, 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 **kunci API**, nilai parameter berisi kunci ini.
* Jika Anda memilih **Kunci sesi**, nilai parameter mencakup kunci sesi pengguna saat ini yang sedang 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 tersedia bagi pengguna akun.
{% endstep %}
{% endstepper %}
Contoh tampilan aplikasi pengguna yang tersemat
Tips pemecahan masalah cepat
Jika aplikasi Anda tidak ditampilkan dengan benar saat disematkan, coba:
* Buka di tab baru sebagai gantinya
* Verifikasi bahwa URL Anda benar dan dapat diakses
* Periksa apakah semua parameter diformat dengan benar
Aplikasi yang dibuat tetap sepenuhnya dapat dikonfigurasi 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.