API管理与调试使用教程

简介

启动API管理

  1. 在YonStudio开发工具中新建或导入项目(如果不导入,点击API将弹出错误提示信息)
  2. 点击YonStudio开发工具左侧竖列菜单的「API」图标按钮,可启动进入「API管理」界面

image-1

面板功能区介绍

image-1

image-2

根据途中红色数字编号,对应功能如下:

  1. API、请求变量定义面板切换
  2. 搜索框与新增按钮
  3. API列表(列表中的每个文件夹称为一个分类)
  4. 根据API生成代码
  5. API详情、从左至右依次为请求method、url与发送请求按钮
  6. request区域
  7. response区域
  8. 变量配置面板

创建API

创建API的方式两种:

  1. 通过搜索框右侧"+"按钮创建:将鼠标移入按钮会弹出操作面板,点击新建API方法,会弹出编辑API名称弹窗,输入API名称点击"确定"即可在对应的分类下成功创建

    image-3

    image-4

  2. 通过分类右侧"..."按钮创建:选择一个分类后,对应分类右侧会出现"..."按钮,鼠标移入右侧"..."按钮会弹出操作面板,点击新建API方法,会弹出编辑API名称弹窗,输入API名称点击"确定"即可在对应的分类下成功创建

    image-5

    image-4

注意事项:

  1. 在没有分类的情况下,需要先通过搜索框右侧"+"按钮创建分类,然后即可进行正常的API创建流程

    image-6

  2. 通过搜索框右侧"+"按钮创建的API会默认创建到当前选中的分类下

删除API/分类

  • 删除API:选中要删除的API,对应的API右侧会出现"..."按钮,鼠标移入右侧"...",会弹出相应操作面板,点击删除,会弹出二次确认框以免误操作,点击删除按钮,即可成功删除

  • 删除分类:选中要删除的分类,对应的分类右侧会出现"..."按钮,鼠标移入右侧"...",会弹出相应操作面板,点击删除,会弹出二次确认框以免误操作,点击确定删除按钮,即可成功删除。若改分类下存在API,需要先删除所有分类内的API才可以删除该分类

    image-7

    image-8

查看/修改API配置

修改API配置信息

选中需要调试或修改的API,在右侧API操作面版可以看到当前API的请求信息、请求参数,点击发送按钮,即可看到当前配置的响应详情

image-9

如图为API基础配置:

  1. 设置请求类型,点击下拉选择相应的请求类型
  2. 请求地址,输入相应的API请求地址
  3. 发送请求按钮,当配置完请求参数,点击即可发送请求获得响应

request配置面板

  1. image-10query配置面板,在每一列配置需要的query参数,在发送请求时会以query的形式携带参数
  2. image-11header配置面板,输入相应的配置,会在发送请求时配置到header中
  3. image-12配置body请求体,在相应的请求方式下配置请求体,会根据所选请求类型,在body中携带配置好的参数

response响应面板

  1. image-13主要用于查看API返回数据,可根据自己偏好选择格式化后的数据或是返回的原始数据,右侧下拉选项为格式化的依据
  2. image-14查看response响应的header信息

修改API名称

选中要编辑的API,对应的分类右侧会出现"..."按钮,鼠标移入右侧"...",在弹出的操作面板中选择重命名,输入想要修改的名称点击确定即可

配置变量

点击变量tab按钮,切换到变量操作面板,在面板中以Key,Value的形式配置全局变量,在API调用的时候,使用{Key}的形式即可使用配置好的变量。如下图

image-15

image-16

注:变量值不能引用变量,如下,是错误的

image-17

生成API代码

点击分类列表下面的"生成API代码"按钮,即可根据现有的API在根目录下的apiModel文件夹中自动生成可用代码,其中包含三个文件,分别是apiModel.js、config.js和req.js

  • apiModel.js文件:生成API对应的方法,在项目中使用,直接引入该文件,按调试时定义好的API名为函数名称调用即可

    image-18如图,①为引用文件,②调用生成的API方法,③结果打印,证明调用成功

  • config.js文件:主要保存在API调试时配置的变量信息

  • req.js:该文件是对请求方法的封装

是否仍需要帮助? 请保持联络!
最后更新于 2023/01/18