Device Service

Manages device registration and trust for security tracking.

Capture Device Info

POST /v1/devices/trust

Registers device information when a user opens the application. Used for security monitoring and device trust management.

Request Body:

{
  "device_id": "a1b2c3d4e5f6...",
  "user_id": "cus_abc12345",
  "device_name": "iPhone 15 Pro",
  "manufacturer": "Apple",
  "model": "iPhone15,3",
  "os": "iOS 18.0",
  "ip_address": "192.168.1.100",
  "created_at": "2025-01-15T10:00:00Z"
}

Field	Type	Required	Description
device_id	string	Yes	Device IMEI hash (SHA-256)
user_id	string	Yes	Associated customer ID
device_name	string	Yes	Human-readable device name
manufacturer	string	No	Device manufacturer
model	string	No	Device model identifier
os	string	No	Operating system and version
ip_address	string	Yes	Device IP address
created_at	timestamp	Yes	Timestamp of the access

Response:

{
  "trusted": "true"
}

---

Get Device Info

GET /v1/devices/{device_id}

Retrieves information about a registered device.

Path Parameters:

Parameter	Type	Description
device_id	string	Hashed device IMEI

Response:

{
  "object": "device",
  "device_exists": true
}

If the device is not registered:

{
  "object": "device",
  "device_exists": false
}