A AuthMS API Wiki API Reference iam.tianv.com →

GET /devices

获取当前用户的所有登录设备列表

会话与设备 `bearerAuth` application/json

Responses

StatusDescriptionSchema
200设备列表dto.DeviceListResponse
401未授权dto.SimpleResponseWrapper

Referenced Schemas

dto.DeviceListResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
items array of

See dto.DeviceResponse

No 统一使用 items
message string No
pagination object No 分页信息(嵌套对象)
timestamp string No
total integer No 总条数(平铺,便于直接读取)

dto.DeviceResponse

用户设备信息(含安全增强字段)

FieldTypeRequiredExampleConstraintsDescription
browser string No Safari 浏览器
created_at string No 2026-01-01T00:00:00Z 首次登录
device_fingerprint string No sha256:abc123def 设备指纹
device_name string No My iPhone 设备名称
id string No dev_abc123 设备ID
ip string No 192.168.1.1 IP
is_trusted boolean No True 是否信任
last_seen string No 2026-04-15T10:30:00Z 最近使用
login_count integer No 42 登录次数
os string No iOS 17 系统
session_id string No sess_123 关联会话
trust_score integer No 85 信任评分
type string No mobile 类型
user_id string No usr_abc123 用户ID

dto.SimpleResponseWrapper

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No

gitee_com_linmes_authms_base_dto.PageInfo

FieldTypeRequiredExampleConstraintsDescription
has_next boolean No HasNext indicates whether there is a next page
has_prev boolean No HasPrev indicates whether there is a previous page
page integer No Page is the current page number (1-based)
page_size integer No PageSize is the number of items per page
total integer No Total is the total number of items across all pages
total_pages integer No TotalPages is the total number of pages