【嵌入式集成-API调用】从零开始的API使用教程 上篇 基础知识

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

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

本系列教程计划分为上下2个章节

上篇 基础知识

    wyn中使用API的基本方式，以及第一个API: 获取token的介绍
    (适用于Web经验不多，对API调用不熟悉的同学)

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

=====上篇 基础知识=====

工具推荐:

1.支持网络请求查看及调试的浏览器 (文中使用Google Chrome)

2.能组织并发送Web请求的调试工具 (文中使用Postman)

首先是Wyn的API示例，如下图所示:

这是一个最常见的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堆积导致性能下降的情况

【下篇】