---
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/dual-api/capabilities/device-metadata
locale: id
generated_by: markdown-export
---

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.

- **Kontrak Web & Native:** diaktifkan dalam alur yang dikontrak untuk akun Anda. Proses mencantumkan `PROCESS_CAPACITY_DEVICE_METADATA` di `capacities`.
- **Kontrak API:** diaktifkan dalam Recipe API key Anda.

> **Peringatan: 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`.

Hubungi kontak Unico Anda untuk mengaktifkannya.

### Kemungkinan respons

Hasilnya dikembalikan dalam objek `deviceMetadata`:

- **Kontrak Web & Native:** di `authenticationInfo.deviceMetadata` dari [Dapatkan Proses](/dual-api/developers/api-reference/web-sdk/get-process).
- **Kontrak API:** di `deviceMetadata` dari [Dapatkan Proses](/dual-api/developers/api-reference/api/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 dikumpulkan perangkat tidak muncul di kontrak Web & Native dan bernilai `null` di kontrak API.

`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

| Surface | Didukung |
|---|:-:|
| **SDK** (Android, iOS, Flutter) | ✅ |
| **Web** (iFrame, Redirect) | ✅ |

### Kombinasi yang valid

Metadata Perangkat bukan bagian dari katalog `flow` yang telah dikomposisikan sebelumnya di [Alur yang tersedia](/dual-api/capabilities/available-flows). Kemampuan ini diaktifkan dalam alur yang dikontrak untuk akun Anda (kontrak Web & Native) atau dalam Recipe API key Anda (kontrak API), dan dapat diaktifkan bersama produk Unico lainnya dalam integrasi Web dan SDK.

### Kasus penggunaan yang menggunakan kemampuan ini

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