LM视频中间件登陆说明

登录流程

登陆API接口参见这里，登陆流程如图示：

在这里插入图片描述

向LM视频中间件发送登录消息，消息携带用户名、密码(二次MD5加密)；
登录成功，LM视频中间件返回唯一token串；
成功收到token后，开启定时器（周期60秒）,把token串放入HTTP URL Query参数列表中，向LM视频中间发送保活消息；
通过token与LM视频中间通信，操作资源、实时视频、历史回放等；
调用登出接口，释放用户资源。

注意

LM返回的token具有唯一性
第三方应用在获取到token后，务必进行第三步定时保活，否则180秒后，平台会释放token资源，导致接口调用失败或者正在播放、回放的视频异常断开
第五步登出接口，非必须调用，LM平台在心跳周期内没有收到保活消息，会自动释放资源

消息示例

登录消息

请求
用户名：admin
密码：admin
两次MD5加密后：c3284d0f94606de1fd2af172aba15bf3

    GET http://192.168.3.23:9030/api/v1/login?username=admin==&password=c3284d0f94606de1fd2af172aba15bf3 HTTP/1.1          
    User-Agent: PostmanRuntime/7.29.2          
    Accept: */*          
    Postman-Token: fd3c0945-d5cc-46df-8433-525ecd85e07c          
    Host: 192.168.3.23:9030         
    Accept-Encoding: gzip, deflate         
    Connection: keep-alive

!!! info “应答”

成功

      HTTP/1.1 200 OK
      Server: nginx
      Content-Type: application/json
      Content-Length: 129
      Connection: keep-alive
      Session: 25aefbab-a87c-49b5-9419-b5345e274351
      Access-Control-Allow-Origin: *

      {
          "result": 200,
          "message": "OK",
          "Token": "25aefbab-a87c-49b5-9419-b5345e274351",
          "Expires": 60,
          "userId": 2
      }

失败

     HTTP/1.1 422 invalid password
     Server: nginx
     Content-Type: application/json
     Content-Length: 108
     Connection: keep-alive
     Access-Control-Allow-Origin: *

     {
         "result": 422,
         "message": "invalid password",
         "Token": "",
         "Expires": 0,
         "userId": 0
     }

保活消息

请求
保活请求不需要携带 用户名 和密码参数，但是需要把登录成功返回的 token 当作URL Query参数中发送至LM视频中间件
示例中返回的token:25aefbab-a87c-49b5-9419-b5345e274351

    GET http://192.168.3.23:9030/api/v1/login?token=25aefbab-a87c-49b5-9419-b5345e274351 HTTP/1.1
    User-Agent: PostmanRuntime/7.29.2
    Accept: */*
    Postman-Token: 19420ea2-fb6b-490d-a7b3-e79d47471a20
    Host: 192.168.3.23:9030
    Accept-Encoding: gzip, deflate, br
    Connection: keep-alive

应答

成功

HTTP/1.1 200 OK
Server: nginx
Content-Type: application/json
Content-Length: 131
Connection: keep-alive
Session: 0892f7c2-3a34-4a65-b866-5a4c5895bd42
Access-Control-Allow-Origin: *

{
    "result": 200,
    "message": "OK",
    "Token": "0892f7c2-3a34-4a65-b866-5a4c5895bd42",
    "Expires": 60,
    "userId": 0
}

失败

HTTP/1.1 424 user not login
Server: nginx
Content-Type: application/json
Content-Length: 106
Connection: keep-alive
Access-Control-Allow-Origin: *

{
    "result": 424,
    "message": "user not login",
    "Token": "",
    "Expires": 0,
    "userId": 0
}

常见错误码

result	message	说明
200	OK	成功
421	user not existed	用户不存在
422	invalid password	密码错误
423	invalid server	服务错误或授权到期
424	user not login	用户未登录