nVisual二次开发——第一章 入门介绍

"本文档详细介绍了nVisual软件的登录接口和用户信息接口。首先,通过POST方法的/wapi/v1/authenticate接口,使用JSON格式提交用户名和密码获取token,token有效时间为半小时。获取token后,其他接口需携带此token以BearerToken形式在请求头中。其次,展示了GET方法的/wapi/v1/users/{id}
摘要由CSDN通过智能技术生成

nVisual已被广泛推广,在实际项目进行中遇到了一些接口对接的需求,为了让大家更方便的使用nVisual软件二次开发,小编准备开一个接口介绍专题,方便大家快速上手使用nVisual开放的对外接口进行定制需求的开发和接口对接。

nVisual的对外接口通过token认证权限。如果需要调用nVisual内其他对外接口,第一步就要获取token,在传入的token正确的情况下,接口方能正常处理数据。下面是获取token的对应接口文档:

1. 登录接口

接口描述:传入用户名密码,验证可否登录,获取token

  • URL地址:http://ip:port /wapi/v1/authenticate
  • 访问方法::POST
  • 数据格式:JSON
  • 传参
    样例数据
    {
        "username":"*******",
        "password":"*******"
    }
英文参数名中文参数名类型必填默认值描述
username用户名string
password密码string
  • 回参

返回成功样例

{

    "code"200,

    "data": {

        "access_token""eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJZYW5nRmFuIiwibmFtZSI6IllhbmdGYW4iLCJpYXQiOjE2NTE5MDU3MDN9.9izzwA50yKbRIL-oyhaKFJ1qG_VwIo71tha4fIw5CVdlSURxI05QPxPNGOZ6kMeX3XqCzQcR2Sl5FyVgXdPMpw",

        "expires""2022-05-07T19:41:43.479",

        "authority""Admin",

        "token_type""bearer",

        "issued""2022-05-07T14:41:43.479",

        "user""YangFan",

        "userId"94000000000053,

        "expires_in"17999

    }

}

英文参数名中文参数名类型描述
code状态码Int200成功,其他失败,例5005是用户名密码错误
data会参数据Map
access_token令牌String之后请求接口都需要带着令牌,否则请求不通过
expires令牌过期时间String不用管
authority用户权限String例如Admin为管理员权限,其他具体参照权限表
token_type令牌类型String传入token的时候注意我们是 Bearer Token
issued令牌创建时间String不用管
user用户名String
userId用户名idLong
expires_in

不用管

返回失败样例

{

    "code"5005,

    "message""5005 Bad credentials"

}

在token成功获取后,有半小时过期时间,在使用token请求接口后,token过期时间会刷新,当token过期则需要重新获取,否则其他接口会因token错误而请求失败。token内也会携带用户名和用户权限,有些接口请求失败可能与获取token的用户权限不够有关。

获取到token后,请求其他接口时需要请求头内以Bearer Token方式携带。举在postman调用获取用户信息接口请求为例:

下面附带根据用户id获取用户信息的接口文档:

2. 获取用户信息接口

接口描述:传入用户id获取用户信息

  • URL地址:http://ip:port /wapi/v1 /users/{id}/user_id
  • ​访问方法::GET
  • ​数据格式:JSON
  • 传参

样例请求

release.nvisual.com:8089/wapi/v1/users/94000000000053/user_id

  • 回参

返回成功样例

{

    "id"94000000000053,

    "username""*****",

    "domain"12000000000005,

    "email""*****@nwvdi.com",

    "password""",

    "lastLogin""2022-05-07T07:14:57.000+0000",

    "lastActivityDate""2022-05-07T07:15:14.000+0000",

    "description""****",

    "comments""****",

    "enabled"true,

    "language"1,

    "passwordChanged"false,

    "tokenValidFrom""2022-01-04T06:29:44.687+0000",

    "defaultPage""24000000074693",

    "authorities": [

        "Admin"

    ],

    "loggedOff"true

}

英文参数名中文参数名类型描述
Id用户idLong
username用户名string
domain分组idLong
lastLogin最后登录时间

String

lastActivityDate最后操作时间String
description描述String
defaultPage默认登录页面String空默认跳转顶页 24000000000001,否则跳到对应页面

述文章展示了获取nVisual内token的接口和根据用户id获取用户信息的接口,下一期小编会带大家学习如何使用nVisual的swagger,nVisual的所有对外接口都在swagger页面内介绍使用方式并可测试。


评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

nVisual

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值