找回密码
 立即注册

QQ登录

只需一步,快速开始

Tony.Fu 活字格认证 Wyn认证
超级版主   /  发表于:2021-7-5 09:55  /   查看:4753  /  回复:0
本帖最后由 Bella.Yuan 于 2023-1-5 18:30 编辑

前言:
  Wyn拥有丰富的Api接口,从用户登录认证,到文档管理权限设定,甚至数据源的管理维护都可以通过API接口实现
  那么如果在项目中有集成需要,或是需要通过代码进行事半功倍的自动维护时,往往会不知从何处开始上手集成

  而本文就会详细介绍Wyn的API接口使用方式,并指导各位读者一步步实现集成效果

本系列教程计划分为上下2个章节
上篇 基础知识
    wyn中使用API的基本方式,以及第一个API: 获取token的介绍
    (适用于Web经验不多,对API调用不熟悉的同学)

下篇 实战技巧
  ①.如何寻找自己需要的API接口
  ②.实战:使用Web JSON实现从数据源到数据集的全部维护工作



=====上篇 基础知识=====
工具推荐:
1.支持网络请求查看及调试的浏览器 (文中使用Google Chrome)
2.能组织并发送Web请求的调试工具 (文中使用Postman)
首先是Wyn的API示例,如下图所示:
image.png756608886.png
这是一个最常见的GraphQL调用,而Wyn中的api主要分为GraphQL和Restful API两种
除了登录请求,每一个API都需要用到一个token参数作为用户信息的认证
而本篇就以第一步 - 获取token信息为例进行说明:

  1. URL: http://localhost:51980/connect/token
  2. <div>
  3. </div><div>Param:grant_type=password&username=admin&password=admin&client_id=integration&client_secret=eunGKas3Pqd6FMwx9eUpdS7xmz&access-token-lifetime=86400</div>
复制代码
参数一览:

参数名 备注 示例值
grant_type 授权类型 password
username 用户名 admin
password 密码 admin
client_id API客户端,通常都是固定值 integration
client_secret 客户端验证密钥 eunGKas3Pqd6FMwx9eUpdS7xmz
access-token-lifetime token的有效时间(单位是秒)

建议设定token时指定access-token-lifetime参数 控制每个token的有效时间
由于缺省值是315360000 (十年) ,如果不指定,长期运行后可能存在无用的token堆积导致性能下降的情况

【下篇】

0 个回复

您需要登录后才可以回帖 登录 | 立即注册
返回顶部