> 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 utama 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 %}
## Siapkan URL
Tentukan URL aplikasi Anda, alamat tempat aplikasi Anda di-host, karena URL tersebut menjadi dasar integrasi.
{% hint style="danger" %}
* Pastikan URL valid, menggunakan koneksi HTTPS, mengarah ke sumber yang tepercaya, dan tidak melebihi 1.000 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 di 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. Perluas 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 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 menyaring informasi yang dipersonalisasi.
* Contoh: `https://your-app.com/dashboard?user_id=12345`
3. `?timezone={timezone}`\
Parameter waktu yang 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 %}
## 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 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 natural.
{% 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 terbuka 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 dengan metode tampilan ini, pertimbangkan untuk menggunakan **Tab baru**.
{% endhint %}
{% endstep %}
{% step %}
## Siapkan autentikasi (opsional)
Konfigurasikan autentikasi jika aplikasi Anda bergantung pada API platform. Dalam hal ini, platform akan memberikan data autentikasi langsung ke aplikasi saat dibuka, sehingga tidak perlu menerapkan fungsionalitas login 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.\
Misalnya, jika aplikasi Anda bekerja dengan perangkat GPS yang memiliki hak akses terbatas atau bahkan tidak dapat diakses sama sekali oleh pengguna, penggunaan kunci API tetap akan menampilkan semua perangkat GPS dari akun utama.
* **Kunci sesi**
* Metode ini direkomendasikan ketika pengelolaan peran digunakan.
* 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 sebuah **kunci API**, nilai parameter berisi kunci ini.
* Jika Anda memilih sebuah **Kunci sesi**, nilai parameter mencakup kunci sesi pengguna saat ini yang digunakan untuk mengakses aplikasi.
Pastikan aplikasi mampu membaca dan menggunakan parameter ini.
{% endstep %}
{% step %}
## Simpan aplikasi baru
Klik tombol **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 tertanam
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 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 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.