# 设备上下线日志 * **说明** > 分页获取用户上下线日志记录。校验条件包括： > * 开始时间、结束时间格式 * **URL**：/v1/user/data/userLog?startTime=XX&endTime=XX&pageNo=XX&pageSize=XX * **请求方式**：GET * **Header参数**： | **Header\_Key** | **Header\_Value** | | :---: | :---: | | **ts** | 精确到ms的时间戳 | | **openid** | openid，每个个人用户的唯一标识 | | **applicationid** | 应用ID，每个开发者的唯一标识 | | **sign** | 加密签名，算法为SHA1\(HTTPMethod+RequestURI+params+ts+openkey+applicationkey\) | * **请求内容**： ``` { "startTime": "yyyy-MM-ddTHH:mm:ss", "endTime": "yyyy-MM-ddTHH:mm:ss", "pageNo": 0, "pageSize": 30 } ``` | **参数名称** | **中文名称** | **类型** | **限制** | **必须** | **说明** | | :--- | :---: | :---: | :---: | :---: | :--- | | **did** | 设备id | 字符串 | 6~32 | 是 | 设备唯一标识 | | **startTime** | 开始时间 | 字符串 | 时间格式yyyy-MM-ddTHH:mm:ss | 是 | 开始时间 | | **endTime** | 结束时间 | 字符串 | 时间格式yyyy-MM-ddTHH:mm:ss | 是 | 结束时间 | | **pageNo** | 起始页 | 整数 | 11 | 否 | 起始条数，默认0 | | **pageSize** | 每页大小 | 整数 | 11 | 否 | 每页大小，默认30，最大可设置为1000 | * **返回内容** **成功时：** > 返回内容 ``` { "code": 0, "data": [ { "timestamp": "yyyy-MM-ddTHH:mm:ss", "online": 1, "onlineTime": 3600, "ip": "192.168.0.1", "province": "山东省", "city": "济宁市", "district": "任城区" }, { "timestamp": "yyyy-MM-ddTHH:mm:ss", "online": 0, "onlineTime": 3600, "ip": "192.168.0.1", "province": "山东省", "city": "济宁市", "district": "任城区" } ] } ``` > 返回参数说明只包含请求说明中不同的参数，或者与请求参数含义不同的 | **参数名称** | **中文名称** | **类型** | **说明** | | :--- | :--- | :--- | :--- | | **timestamp** | 上线/下线时间 | 字符串 | 上线/下线时间 | | **online** | 上线/下线 | 整数 | 0:下线 1:上线 | | **onlineTime** | 在线时长 | 数值 | 设备本次在线时长，单位秒 | | **province** | 省 | 字符串 | 设备登录地址 | | **city** | 市 | 字符串 | 设备登录地址 | | **district** | 区县 | 字符串 | 设备登录地址 | **失败时：** ``` { "code": ERRORCODE //ERRORCODE可以去错误码目录中查找 } ```