> 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 baru **Aplikasi pengguna**, Anda akan bekerja dengan beberapa konfigurasi utama yang menentukan cara aplikasi eksternal Anda berintegrasi dengan platform Navixy. Mari kita bahas setiap komponen penting.

Mulailah dengan mengklik <img src="https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-b205ed1cd11ae77328c30a95f8af7d8d5be21be8%2Fchrome_py0qhiu5p8.webp?alt=media" alt="chrome_py0qhiu5p8.webp" data-size="line"> tombol di **Aplikasi pengguna** daftar. Di formulir konfigurasi yang muncul, lanjutkan dengan langkah-langkah berikut:

{% stepper %}
{% step %}

## Atur URL

Tentukan URL aplikasi Anda, alamat tempat aplikasi Anda dihosting; ini menjadi dasar integrasi.

{% hint style="danger" %}

* Pastikan URL valid, menggunakan koneksi HTTPS, mengarah ke sumber tepercaya, dan panjangnya tidak lebih dari 1000 karakter.
* Pastikan pengaturan iFrame pada sisi aplikasi telah diaktifkan, 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 salah satu saran parameter untuk menambahkannya ke akhir URL. Perluas deskripsi di bawah untuk mempelajari lebih lanjut tentang parameter dan contoh yang disarankan.

<details>

<summary>Memahami parameter URL yang disarankan</summary>

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.

</details>

![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\&token=557f4728-dad8-455c-a92a-ddd4fcb43694)

{% hint style="info" %}
Uji konfigurasi Anda untuk memastikan aplikasi dimuat dengan benar. Klik <img src="https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-78171811e50248dd9b883328ca7b69ec6cf767bf%2Fimage-20241217-083119.png?alt=media" alt="image-20241217-083119.png" data-size="line"> 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 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 memahami tujuan aplikasi dengan lebih jelas.
* **Ikon**: Pilih ikon yang mewakili fungsi aplikasi Anda untuk navigasi yang lebih terasa asli.
  {% endstep %}

{% step %}

## Pilih metode tampilan

Tentukan bagaimana aplikasi Anda dibuka dengan memilih salah satu dari dua opsi di **Buka di** daftar tarik-turun:

* **Tertanam**: Aplikasi muncul di dalam antarmuka platform
* **Tab baru**: Aplikasi terbuka di tab peramban terpisah

{% hint style="info" %}
Platform Navixy menggunakan iFrame untuk penyematan. Karena tidak semua URL dapat diproses dengan teknologi ini secara sukses, pastikan Anda meninjau hasil penyematannya terlebih dahulu. Jika Anda mengalami masalah dengan metode tampilan ini, pertimbangkan untuk menggunakan **Tab baru**.
{% endhint %}
{% endstep %}

{% step %}

## Atur autentikasi (opsional)

Konfigurasikan autentikasi jika aplikasi Anda mengandalkan API platform. Dalam kasus ini, platform akan menyediakan data autentikasi langsung ke aplikasi saat dibuka, sehingga Anda tidak perlu menerapkan fungsi login tambahan di sisi aplikasi Anda.\
Anda dapat memilih salah satu dari dua metode autentikasi:

* **Kunci API**
  * Metode ini untuk aplikasi yang tidak memerlukan pengelolaan peran atau izin pengguna.
  * API key ini sesuai dengan tingkat akses pemilik akun. Ini berarti memberikan API key kepada pengguna biasa dapat memberi mereka akses ke **semua data** yang tersedia bagi pengguna utama.\
    Misalnya, jika aplikasi Anda bekerja dengan perangkat GPS yang hanya memiliki hak akses terbatas atau sama sekali tidak memiliki akses, penggunaan API key tetap mengekspos semua perangkat GPS dari akun utama.
* **Kunci sesi**
  * Metode ini disarankan saat melibatkan pengelolaan peran.
  * 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 ini berisi kunci ini.
* Jika Anda telah memilih sebuah **Kunci sesi**, nilai parameter menyertakan 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 akan muncul di **Aplikasi pengguna** daftar dan bilah sisi platform. Aplikasi yang diaktifkan secara otomatis tersedia bagi pengguna akun.
{% endstep %}
{% endstepper %}

<figure><img src="https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-f3208949947b9860b2bd4665a35ccfa6708d32bb%2Fimage.png?alt=media" alt=""><figcaption><p>Contoh tampilan aplikasi pengguna yang disematkan</p></figcaption></figure>

<details>

<summary>Tips pemecahan masalah cepat</summary>

Jika aplikasi Anda tidak ditampilkan dengan benar saat disematkan, coba:

* Buka di tab baru sebagai gantinya
* Periksa apakah URL Anda benar dan dapat diakses
* Periksa apakah semua parameter diformat dengan benar

</details>

Aplikasi yang dibuat tetap dapat dikonfigurasikan 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](https://navixy.com/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=<question>&goal=<user_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.
