登录设备

POST

/terminal/core/v1/user/login

最后修改时间：2025-12-30 09:15:03

登录设备

1、前置操作
（1）搜索设备
通过搜索接口搜索到设备，获取到设备基本信息：IP地址、SN（产品序列号）、产品名称等

2、后置操作
在后续的每次请求中，都需要在请求头Header中携带登录时下发的Token，请求头的名称为 Authorization，值为登录时下发的Token。

3、防止暴力登录
连续失败3次后，则需间隔60秒后才能再次重试。

4、流程图

请求参数

Header 参数

Body 参数application/json

示例

{
    "sn": "10016102136445658ABC",
    "username": "admin",
    "password": "88888888",
    "loginType":2,
    "clientId":1,
    "clientName":"屏精灵PC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://192.168.0.220:12000/terminal/core/v1/user/login' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sn": "10016102136445658ABC",
    "username": "admin",
    "password": "88888888",
    "loginType":2,
    "clientId":1,
    "clientName":"屏精灵PC"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "message": "",
    "data": {
        "logined": true,
        "password": "tester",
        "sn": "10016102136445658ABC",
        "token": "1722678297190UWSo6okfy123",
        "username": "admin",
        "validation": true
    }
}

🟢200失败

修改于 2025-12-30 09:15:03

修改显示屏用户信息