nVisual二次开发——第一章 入门介绍
nVisual已被广泛推广，在实际项目进行中遇到了一些接口对接的需求，为了让大家更方便的使用nVisual软件二次开发，小编准备开一个接口介绍专题，方便大家快速上手使用nVisual开放的对外接口进行定制需求的开发和接口对接imtoken。
nVisual的对外接口通过token认证权限imtoken。如果需要调用nVisual内其他对外接口，第一步就要获取token，在传入的token正确的情况下，接口方能正常处理数据。下面是获取token的对应接口文档：
1. 登录接口
接口描述：传入用户名密码imtoken，验证可否登录，获取token
URL地址：
访问方法:：POST
数据格式：JSON
传参
样例数据
{ "username":"*******", "password":"*******" }
回参
返回成功样例
展开全文
{ "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": 5005, "message": "5005 Bad credentials" }
在token成功获取后，有半小时过期时间，在使用token请求接口后，token过期时间会刷新，当token过期则需要重新获取，否则其他接口会因token错误而请求失败imtoken。token内也会携带用户名和用户权限，有些接口请求失败可能与获取token的用户权限不够有关。
获取到token后，请求其他接口时需要请求头内以Bearer Token方式携带imtoken。举在postman调用获取用户信息接口请求为例：
下面附带根据用户id获取用户信息的接口文档：
2. 获取用户信息接口
接口描述：传入用户id获取用户信息
URL地址：
访问方法:：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 }
上述文章展示了获取nVisual内token的接口和根据用户id获取用户信息的接口，下一期小编会带大家学习如何使用nVisual的swagger，nVisual的所有对外接口都在swagger页面内介绍使用方式并可测试imtoken。
相关文章
发表评论