---
title: Metadata Perangkat
description: Kemampuan yang mengembalikan metadata perangkat yang digunakan dalam pengambilan gambar, seperti platform, IP, lokasi, dan sinyal risiko yang terdeteksi di perangkat tersebut.
canonical: https://developer.unico.io/id/capabilities/device-metadata
locale: id
generated_by: markdown-export
---

# Metadata Perangkat

Kemampuan ini mengembalikan data perangkat yang digunakan pengguna untuk pengambilan gambar, bersama dengan hasil produk lain yang dikontrak.

### Apa yang dilakukannya

Mengumpulkan metadata perangkat yang digunakan dalam sesi pengambilan gambar dan sinyal risiko yang terdeteksi di perangkat tersebut (detail data di bawah).

Ini bukan validasi: kemampuan ini tidak pernah menyetujui atau menolak proses, dan tidak pernah membuat proses gagal. Gunakan data ini dalam aturan risiko Anda sendiri atau mesin keputusan internal Anda.

### Input

Tidak diperlukan field tambahan. Kemampuan ini menggunakan sesi pengambilan gambar yang sudah dimiliki proses.

- **Web:** pengambilan gambar yang dilakukan dalam perjalanan Unico.
- **API dengan Unico SDK:** pengambilan gambar yang dilakukan oleh Unico SDK di aplikasi Anda.

> **Metadata bergantung pada Unico SDK:** Unico SDK adalah komponen yang mengumpulkan metadata, selama pengambilan gambar. Integrasi API dapat menggunakan atau tidak menggunakan Unico SDK:
>
> - **API dengan Unico SDK:** metadata dikembalikan seperti biasa.
> - **API tanpa Unico SDK:** tidak ada metadata, dan responsnya adalah `not_found`.

Kemampuan ini diaktifkan dalam alur yang dikontrak untuk akun Anda. Hubungi kontak Unico Anda untuk mengaktifkannya.

### Kemungkinan respons

Hasilnya dikembalikan dalam objek `authenticationInfo.deviceMetadata` dari [Dapatkan Proses](/id/developers/api-reference/get-process).

| `status` | Arti |
| --- | --- |
| `found` | Metadata perangkat ditemukan. Field di bawah diisi dengan data yang dikumpulkan perangkat. |
| `not_found` | Tidak ada metadata perangkat untuk pengambilan gambar ini, misalnya proses API tanpa Unico SDK. |
| `unavailable` | Metadata tidak dapat diambil pada saat itu. Hasil proses tidak terpengaruh. |

Ketika `status` adalah `found`:

| Field | Tipe | Deskripsi |
| --- | --- | --- |
| `deviceId` | string | Pengidentifikasi perangkat. |
| `platform` | string | Platform asal pengambilan gambar, misalnya `WEB`, `ANDROID`, `IOS`. |
| `ip` | string | Alamat IP perangkat. |
| `ipCountry` | string | Negara alamat IP. |
| `ipGeoCoordinates` | object | Lokasi alamat IP (`lat`, `lng`). |
| `gpsCoordinates` | object | Lokasi yang dilaporkan oleh GPS perangkat (`lat`, `lng`). |
| `osName` | string | Nama sistem operasi. |
| `osVersion` | string | Versi sistem operasi. |
| `browserName` | string | Nama browser. Hanya Web. |
| `userAgent` | string | User agent browser. Hanya Web. |
| `appStore` | string | Toko aplikasi tempat aplikasi Anda diinstal. Hanya SDK native. |
| `detectedSignals` | array of strings | Grup sinyal risiko yang terdeteksi di perangkat. Kosong jika tidak ada yang terdeteksi. |

Field yang tidak muncul berarti perangkat tidak mengumpulkan data tersebut.

`detectedSignals` hanya mencantumkan grup yang terdeteksi. Sebuah grup terdeteksi ketika setidaknya satu sinyalnya ditemukan:

| Grup | Arti |
| --- | --- |
| `origin_obfuscated` | Asal akses yang sebenarnya disembunyikan, misalnya oleh Tor atau alat anti-fingerprinting. |
| `untrusted_location` | Lokasi mungkin palsu, misalnya oleh proxy, VPN, atau GPS spoofer. |
| `environment_altered` | Lingkungan perangkat diubah, misalnya emulator atau perangkat yang di-root atau di-jailbreak. |
| `app_manipulated` | Aplikasi telah dirusak, di-hook, atau di-debug. |
| `assisted_session` | Orang lain mungkin mengendalikan sesi, misalnya melalui berbagi layar atau bot. |
| `payload_untrusted` | Data yang dikirim oleh perangkat telah dirusak. |

Tidak semua sinyal ada di setiap platform, sehingga perangkat yang sama dapat menampilkan grup yang berbeda di web dan di SDK native.

### Ketersediaan

| Komponen integrasi yang diperlukan |
| --- |
| SDK  Web or SDK |

### Kombinasi yang valid

Metadata Perangkat bukan bagian dari alur yang telah dikomposisikan sebelumnya di [Alur yang tersedia](/id/developers/start/flows). Kemampuan ini dapat diaktifkan bersama produk Unico lainnya dalam integrasi Web dan SDK, dalam alur yang dikontrak untuk akun Anda.

### Produk yang menggunakan kemampuan ini

Kemampuan ini dapat ditambahkan ke produk Unico mana pun dalam integrasi Web dan SDK.

Terakhir diperbarui pada **28 Okt 2026**