swagger的api接档怎么实现

对于开发者来说，设计 api 文档，调试接口，做性能测试，生成没可数据，这些日常工作呢，一定不陌生。当项目开始之后呢，我们一般先用 swogger 设计 api 文档， 那这个时候呢，后端还没有做好接口，前端呢，就只能先用磨合数据进行测试。 又因为 mok js 和 swag 数据不互通，所以我们需要在 mok js 中重新定义接口和参数。当后端进行开发时，也要在 pose 慢中再定义一次接口和参数。 如果在开发过程中，后端发现 swag 少定义了参数，又只是在 pos 的慢逐进行了修改，忘了修改 swag， 那等到连条的时候，就会发现前端跟后端的对接出现了问题， 测试的测试用力呢，也跑不起来，系统连跳一团糟，项目经理直接封了 pose 慢，吉米特、 moke js 多个系统之间不互通，需要我们多次重复的定义接口，就很容易产生问题。 这个时候呢，不要着急，为了解决这个问题，我们开发了 a p i post。 简单来说呢， a p i post 等于 poss 慢加 s walk 加 moke j s。 针对前端的伙伴，我们可以进行接口文档预览，接口调试自动生成前端代码。 针对后端的伙伴呢，我们可以在调试接口的时候，一键生成接口文档，再也不用去浪费时间手动编写啦。与此同时呢，前后端还可以通过 mok 指定接口规范，即使后端的数据库尚未搭建 aps 代码上位编写，依然可以提前让前端进入研发流程。针对测试同学呢，也可以通过协作参与从指定规范到接口测试的全流程。而且对于管理者来说，我们的六点零版本单独开辟了管理中心，方便成体系的管理团队、项目以及人员。 这样的话，我们就可以通过统一规范的协作来打通工作流程啦，避免了我们在多个软件之间来回切换，不仅提升了效率，也降低了办公数据丢失的风险。 除此之外，我们从五点零系列开始就支持了用户在礼线环境下使用。而在全新的六点零版本，我们又支持了外边版以及 pose 慢无缝迁移，并且新增了联想输入、实时协作等等几十项优化点，只为做出一 便捷易用、上手快的工具。在往后的视频里呢，我们也会逐一讲解 app pose 中强大的功能点，教你快速上手 app pose， 提升工作效率，让大家都可以早点下班。

好，我们来完善一下这个添加啊，在这里呢先把这一块关掉，然后呢找到我们这个控制器，然后呢写一个添加的，在这个地方我们看一下我们这个首页， 他呢添加是 add 的方法，看到没有 add 方法，那么我们在这呢写个 add 的方法， a d d 不需要穿参素啊， retry 一下 w 好，那么这个克林特呢也是一样，直接复制复制过来，可能有同学说，哎，这个地方我这不需要数据啊，怎么不需要数据，我们下了框，是不是好，在这里呢我们就是弯 六 bug。 第二 case 等于 rwat， 然后呢克里特点，然后呢 cos 信，这里呢有个 o snike， snike 好，然后呢我们这个地方给他添加试图 rap， 试图啊，添加好，添加 好天 添加石头。这里呢添加好之后呢我们在这个包地里面这个先给个 s 三，这里呢是显示就是学员添加学员信息， 下面呢是飞儿的赛的啊，飞儿的赛的好，这个里面呢我们给他优信， 嗯，比那个 i t 妙点比定 flam。 这里呢我们需要操作的是 iddstu 的方法，这个这个我们的控制器呢一样的是哈姆控制器 里面呢他提交的方式啊是 pos 提交 ok， 剩下的呢我们就要显示是吧显示 atm 点， vivo 就是用户， 然后呢是 a t 妙， 第二他是 boss， 他 boss 啊，这里呢就是他对应的是我们的内蒙啊， sl 大写对于那个子弹 好，我们呢就是一嗯复制粘贴 密码，密码呢，我们要用帕斯曼的，帕斯曼的呢这是 pwd 年龄，年龄这块呢 a 级， 还有呢就是我们的性别。 新棉的这里就是瑞丢八筒了啊，接着 好，后面呢给个蓝再来一个竖默认选中， 这里记着啊，爱的符号要加冒号，要不然的话显示就是文本，他会报错，这里呢是女 ok 这里呢只有一个 单选按钮能够选中。好，接下来呢就是我们的啊问题， 问题呢就是需要一个 steat 的啊，然后呢这里给个内蒙 pv i d 这里呢是否一起便利 在这呢是 opple 型啊， opple 型 里面呢一个歪六歪六呢就是这里呢是绑定 ipam 第二 k i d 显示的内容呢是艾特吗？点 qmok 还有呢一个答案， 答案接下来呢也是要呢是一个文本 啊，对应的答案的自带一个我们的提交按钮 上面一台然后呢 w 就是提交这里呢也可以叫做添加啊。 好，这就好了，接下来呢我们要写这个呃 a d d s t u 这个方法在控制器这一块把这一块呢给他靠背下来 这里呢我们要传就是一个实体对象 stos 那么同样的道理，首先呢给他，因为他要添加，添加完成之后呢要跳转到隐带实页面， 所以说呢这里需要 rengx tux x 啊，这里呢引带子 一样的这里呢也需要一个克里特对象从那边接收啊， app 里面传递接收数据完了之后呢耳位铲 克林特点 stu 这里呢 stu 呃 snk 就是添加了方法把 s 传递过来，在这呢添加他会爆错，为什么呢？来咱们看一下啊， 好添加四五六， 然后呢二十 舒淇点添加这里呢提示 q i d niro 更新是吧，这里是闹，但是呢你看到我们的显示页面最后一个 他是不是又添加出来了呀？好，所以说呢，这块怎么改呢？我们把这个呢刚才这个块先关掉，找到我们这个 oppo ip i s 啊，思维格这个 gs， 找到最下面我们的 sto 这个实体类，这块他解析啊，解析的实体类，这块我们找到这， ok， 在这是吧？好，这个地方呢我们添加一个属性，叫做欧奥福，这里呢奥福的欧要大写啊， 好，然后呢把这个给他放进去，接下来呢这个地方加个逗号，给他加上一个 no 处， 好，保存一下，保存一下之后呢，我们需要把我们这个地方添加的这个这个辅引用啊给他删掉， 删掉之后呢，在这里我们通过这个选中文件啊，之前是 uir 选中文件浏览，找到我们这个 oppo ipssvigigs。 啊，一样的，这个秘密空间 是跟之前一样完成， ok， 然后保存一下，那么我们这一块接 下来呢，找到我们这个 sus nike， 这个方法对应的呢，来看下面这是 pose 的呀，他就是添加的方法。好，我们找到这个 stex， 就是状态啊，好， 两百，给他复制一下，加个或者这里呢改成两百零一，两百零一呢，这个状态就是创建成功，因为这呢没有这个两百零一，给他手动添加一下， ok， 这就好了啊，好，我们呢重新给他运行一下， 好点，添加六六六六，然后呢以年龄十九女是吧？好，这里呢黎明， 好，添加，我们找到最后， ok， 在这，这是不是黎明是不是就出来了呀？黎明就出来了，好，这一块呢我们就添加完成了啊，添加完。

你这 pose man 咋长得跟我用的那个不一样呀？我这不是 pose man， 但是的确跟你很像，我这叫 api pose 是我新发现的一个工具，你看你可以看一下它这个界面的确给你的，你看颜色啊什么的啊，包括它这个界面功能，你看这只是一创建一个 pose 的球球，对不对 啊？我这里是这个请求参数啊，点击发送按钮，同样跟 pos 曼一样，会有响应的数据，对不对？响应的数据，但是这个比 pos 曼强大的是一个点，是吗？你看这里可以管理这个接口的目录，对，不同目录底下创建不同的接口，你明白吗？这是一个点啊，还有一个点他有个团队协作的功能， 其实你你现在也是测试，在公司就要开发流程当中，你看后端人员提供接口，对吧？提供接口文档给前端，前端开发，前端开发上，然后测 测试，你测试的时候也是验证结果了，对不对？所以说这个需要咱们三同一个协作，那就这个团队里边，我创建一个项目， 咱们三方都在里边，他后端比如说要调整接口，他在那边去改的时候，哎，你我咱们同步就可以在这边看到这个动态的修改的过程， 不存在说因为他改了，我不知道这个更新的这个东西啊，还有一个点啊，我觉得特别好，就是他还可以一键生成文档，你看 这有个分享按钮，点击分享按钮的时候，他会生成外网链接跟内网链接，来复制下这个外外网链接，复制外网链接发一下，你看他就把我刚才 刚才演示在那里边创建的所有的接口，就会生成这么一个，你看接口文档，这直接像个网站一样，这么一个接口文档，你看这个接口文档里边基本的接口请求 参数，请求参数享用的参数的自带描述，非常详细。我觉得这个这个功能就特别好了啊， 帮助服务端的小伙伴就减胜了，比那个我们平常用那个死歪一个就清晰多了好多了。还有个是你，你测试用的，你看他有个流程测试，你应该知道吧？嗯啊， 你看就是刚才你在那边创业的接口，比如说你登录接口，登录完以后你才能用新闻列表，对吧？所以说你把它两个加进来，然后点击开始测试，你看他会先请求登录接口，登录接口请求完了后，他会自动的给这个新闻接口去带上 tok 啊，带上 tok， 然后 这个结果请求冲冠，那足以说明他两个的关联关系是正确的。所以我觉得这个你们这个，呃，做这种流程测试的时候会很好很多，你知道。

这是一个号称全网最强的 a p i 工具，结合了 postman， swagger， mark 以及 j m letter 于一体，通过一套系统，一份数据，解决多个系统之间的数据同步问题。不管你是前端、后端还是测试，都可以使用它。 你可以在这里创建你的团队，创建好团队后，可直接添加你的团队成员。在真实的开发中，创建团队是很有必要的。 接着在该团队下创建你的项目。进入到项目，选择快捷请求测试我们的接口。当你复制一个带有参数的请求链接，他会自动识别链接的所有参数，并且识别后的参数支持修改。 测试完成后的接口，点击右上角保存按钮，可快速的保存当前测试接口，并且生成一份简 清晰的文档，这对后端同学来说简直是福音，可大大减少写文档的时间。 接着来看如何创建请求接口。回到项目首页，选择新建接口，输入请求路径，再输入动态参数后，会自动同步到请求参数的内容中。下面的返回响应就是平时后端返回的数据，你只需要在这里填写返回的参数， 设置每个参数的返回类型，之后的一切请交给 a p i fox。 点击预览，选择动态生成，他会利用本身强大的智能 mark 返回一些接近实 实际的模拟数据。使用一些通用的参数名称，即使不设定 mark 规则，也能产生接近真实的数据，比如 username， email， sex 等。 当然，这里的每一个参数都是可以设置对应 mark 规则的，毕竟 a p i fox 本身的 mark 是很智能的。可以看到这里的 mark 规则还是挺多的，同时也是允许我们自定义 mark 规则。 如果你之前习惯使用的是其他 a p i 管理工具，比如 postman， swagger 等，而此时又想切换到 p i fox， 利用导入数据可快速实现无缝衔接。以 sweater 为例，通过已有的在线文档链接进行导入， 等待几秒，文档里的所有接口都将会被解析到 a p f ox 目前已支持导入几十种类型的接口文档。关于不同文档的导入方式，请移步到官网，本期就先到这，下期继续探索。

有的同学会问我使用 a p i fox 能不能像 swag 那样，直接使用代码里面的注释来生成 a p i 文档音， 我们会推荐你还是可以使用 spider 来生成文档，然后自动导入到 a p fox 里面，这样呢，既能够自动生成文档，又可以使用 a p fox 的方便的帽壳自动化测试功能了。 这就是一个用 swagger 生成的 api 文档，如果说我们要把它导入到 api fox 里面来呢，你可以看到这里会有一个地址，一个 jason 的一个 uil， 我们来复制它。好的， 然后呢，我们打开 ipfox， 我们进到项目设置的导入数据，然后我们可以把这个自动导入打开，在这里呢把刚才这个酸 格的数据源的 url 粘起来。对，然后呢，我们这里还可以去啊调整这个导入的频率啊，包括是否覆盖啊等等的这样一些东西。对，然后我们点击保存好，然后他就会开始导入了， 这样呢，我们的这个 swag 生成的文档就已经导入进到了 a p i fox 里面来，同时呢，它如果你在 这个啊代码里面去更改的这个文档的话，那他也会以每三小时一次的这个方式来同步到 ipfox 里面去，你就可以使用这个 ipfox 的，其他的像 moch 啊，像这个自动化测试等等的功能都可以跟所有挨个的文档去打通，打一个冰箱，然后 它的价格比 ipfox 表情功能。哈喽，大家好，有的同学在使用 apfox 的时候会看到新哦，那个结束了。

添加枫叶呢，这里我们就不用手写那个枫叶麻烦直接用他系统自带的啊，在这呢，我们点右键。嗯，添在这 添加。呃，管理 augat 服务，在这输一个叉点派对。 好，这个地方是不是一个叉点派几点 mvc 点扣啊，好把它安装啊，记着呃，我们之前是不是呃因为那封号卡，嗯，不是，哎哎， 商量的。扣的话直接是装拍击类似的 mvc 啊，对吧，记着啊，这里是 s 刀链的扣 mvc。 所以说你要安装什么呢？要安装叉点 太极类似的点 mac 点扣。好吧，这个地方是八点一把这个安装安装就好了啊，安装完了之后呢， 他就会在这个依赖巷里面，你看包看到没有，是不是有个差点拍击类似的 mac 点扣啊，好，接下来呢这个地方引用啊，引用这地方很重要。 uc 差点拍击类似他 是这样的饮用啊，而不是差点派吉利斯特点 mvc 点扣是差点派吉利斯特，好吧，好，是这样的饮用。接下来因为这这个地方是易步的啊，因为这是易步提交这个 snike 他是一不提交。所以说呢，我们这里呢就需要给他整一个歪六瓣 啊，还记得吗？ wifi 是不是提交数据啊？他临时的对不对？提交到前面啊， wifi 个点奈斯特等于 s t u 点拍吉利斯特， 看到没有，这一个突拍吉利斯特，还有一个突拍吉利斯特 snk 突拍吉利斯特。艾斯尼克我们用在什么时候呢？用在前台，你是调用用那个。呃，阿加克斯调用的时候创业。好吧，这里呢我们就用 出牌吉利斯特啊，完了之后呢，里面传一个太极，然后呢每页显示十条数据 啊，这里要说一下，第一个参数是当前第几页啊？第几 一？第二个参数是什么？每页显示十条数据啊，十条数据。这块要记着啊，这个地方可以设置的，对不对？好，还有一个地方是在哪呢？在这 硬扯派几等于一末日情况下他是有第一页啊，对不对？你这里要加上啊，硬扯派几等于一好，完了之后呢，我们再引代词这个页面，我们这要优信引用优信。 然后呢插点拍吉利斯特啊，插点拍吉利斯特， ok， 那么在这呢是拍吉利斯特，呃， 哎，拍吉他累死他，看到没有？哎，拍吉他累死他，然后呢肩括号呃 s 呃，应该是麦 stu 点 stu。 然后呢这一块就是麦累死他， 等于 y 六半个点类似他是吧？好，但是呢，这块要给他类型转换，怎么类型转换呢？就是把这一块给他复制过来就可以了啊，哎，拍些类似他， ok， 好，这块是不是就好了呀？好了之后呢，切记啊，因为我们这块呢，是不是，呃，他是把那个对象传过来呀？所以说呢，我们这块因为你要分叶，分叶的话对象是不是就要发生变化呀？ 所以说我们这块呢就要用到这个麦利斯特啊，麦利斯特好，后面呢在这个推爆的后面给他艾特佛，艾特妙点拍， 这里呢有一个叫做拍击点突，我看啊，拍击在这呢，我们还需要把这个引用一下，优信 x 点拍吉利斯特点 mc 点扣好。引用，引用完了之后呢，这块就可以点了啊，点看到没有？是不是有一个拍吉利斯拍点啊，是吧，拍吉利斯拍点好，首先呢第一个参数是谁呢？是不 我们这个麦利斯的对象啊？啊？麦利斯对象，为啥你每次分夜，你要根据谁来分啊？是不是根据这个对象他来分夜啊？啊？麦利斯，后面呢？是，比如说太极啊，对象是什么呢？就是 ur l 点 x， 然后呢，这个里面我们要提交到哪个页面呢？是不是就是我们那个方法呀？引，带个死方法。逗号这里呢，后面给个妞啊，妞，对象是不是传职啊？传谁 当前的耶稣就开了啊，这就好了，这就好了，好吧，好，走是不出来了呀，第二页对吧？第三页，看到没有？ 战术变好了，第四页，第五页，第六页，是不是我们每页十条数据啊？啊？第七页啊，第十页，对吧？第一页， ok， 好，这数枫叶是不完成了呀。好，你们待会试试看，好吧。

大家好，这节课呢，我们开始学习将购自动生产 app 文档的开发方式，这节课主要讲解呢，嗯，基于第三方的软件包 drf gunyisg 这个软件包来生成 jungo 的 apr 的自动化的一个文档， 那么我们也顺带把江狗自带的内置的 api 文档生成的方式做一个讲解， 因为江狗自带的内置的实际上是江狗 rest from work 这个框架自带的 apr 的文档生成的方式啊，江狗 rest friend work 这个框架呢，实际上也有很多第三方的软件包啊，我们这里面呢主要讲一个用用的比较主流的一个第三方的软件包 drfysg 这个软件包。 那么我们先看一下这节课要讲的一个内容啊，首先呢就是我们用这个软件包，那么呢 就要首先就要安装他，是吧？安装他这个主要，嗯，拍摄的安装方式相对比较简单了，前面我们也安装过很多第三方的软件包， 然后呢其次呢，呃，就需要配置 drfy sg 这个模块以及 uil 路径的配置啊，这里面呢，我们可以看到这个是一个完整的配置啊， 实际上呢就是我们这时刻呢，按照这种方式来讲，首先呢，我们先讲加入 rest framework 内置的 api 文档生成如何来做，其次呢，我们再详细演示一下第三方的软件包 dif yisg 他的安装以及配置啊，其实配置相对比较简单，主要在两个地方，第一个呢就是我们的塞停文件中， 我们安装了这个第三方的软件包，那么我们在 citing 的这个文件里面把第三方的应用配置进去，那如果不配置进去的话， 我们就会把它当做一个酷文件来使用的，那么就会出现一些错误，当然呢也可以做一些呃其他方面的配置来解决这个问题，这里面呢我们也简单讲一下。 那么第三个方面呢，我们就需要在 url 这个文件里面进行一个路径的配置。路径的配置 how？ 好，首先呢我们讲第一个用 jungle rest friend work 自带的 ipa 文档生成器，那么呢我这一个大家看一下我这个 uil 它是一个完整的，呃，配完整的这个文件啊，那么内置的呢？首先我们从 jungle rest friend work 的 docu document 这个模块里面导入这个方法。其次呢， 只要在路径上我们做一个配置就可以了啊，原来的路径把这个方法配置进去，是吧他的这个访问的路径以及这个方法，那我们来尝试一下啊，我们在这边尝试一下， 首先呢要导入 rest friend work document 这个模块里面的 include docus uil 这个方法， rom rest framework 点 document 啊， import， 怎么呢？ include 啊，这个我们就导入了导入了呢，我们在这个 uil 的这个路径做一下配置， 走一下配置，那我们看一下这边是怎么写的。嗯，首先呢配置一下路径， 那么我们就是 darks 斜杠，把刚才倒入的 include 做一些参数的配置， 买埃比亚塔特哈 好了，那么我们就配置好了，我们保存一下来访问刀克斯这个 路径，看一下我们 apr 的一个外部的这种方式。好，大家还记得我们刚才配置的路径是 dogs。 好，那么我们内置的文档的 app 文档的这种方式呢， 就非常简单，实际上也是非常容易易读的，那么我们来看一下我们的这个呃接口啊，这个是呢请求啊请求，那我们看到这个，呃，刚才是我们设备模板的一个请求的列表，我们这里面实际上是有一个这样的一个 呃设备模板是吧？嗯，呃相对来说还是比较好用的，那我们把它的阿迪拷贝一下再来呃尝 试一下这个呃详情啊详情，那他需要我们输入阿迪号啊，那我们再又开始的一下，在这里面看到啊，实际上是非常好用的，非常好用，要配置起来也是非常简单啊。 当我们重点还是讲详细的讲一下我们第三方的这个模块的使用哈。 首先呢安装这个 difysg 的这个软件包，这里面就不详细制作介绍了啊，详细做介绍，那我们呢也可以查看一下我们有没有这个软件包，有没有安装好啊。那主要安装的话就是 prp 三啊，我们使用派出三版本的啊，因为我们这个 拍摄的环境实际上是有两个版本的环境，一个是拍摄二的，一个拍摄三的，所以呢 prp 这里面呢也做了一些区 分好，那么我安装完之后啊，我就直接配置了 uil 路径， uil 路径，那么 uil 路径呢？这个我们来配置一下哈，我们看一下会产生什么问题 啊？首先我们先看一下有没有安装好啊，我们先退出来， 退出来 pip 三，呃， list grab 查询啊，查询哪个呢？ drf 来看一下。那首先看一下实际上是我们这个第三方的软件包使用的一点一七这个版本啊，一点一七这个版本，这个是，呃，其实呢，这里面呢，我们从 从官方文档上面来看呢，这个第三方的软件包呢，他支持的是这个江古，瑞士弗兰沃克，他从三点一零到三点一二，江古呢，他是支持什么版本以拍摄支持什么版本？大家还记得我们使用的，呃， 实际上我们的将狗使用的是三点二，是吧？他这里面呢，嗯，我们使用的最新的三点二十一啊，就是我们测试过，也是没有问题的啊， 那么坚固的这个呢，我们使用的是三点九版本，实际上低于的低于的这个三点幺幺零的这个版本一拍摄呢，使用的是没问题的三点八啊，我们使用的，嗯，实际上经过我的测试是这样是没有问题的，没有问题的， 那么在这里呢，我们就按照这个文档来，刚才测试了内置的这种方式，那么我们使用这第三方的这个自动生成文档的这个方式。 首先看到我们要从第三方的这个，呃， difysg 的要导入他的一个视图，以及他的 open 的这个 ipi 啊， oppo 的 ipi。 那么其次呢，我们需要做一些初始化，就是这个仕途啊，做一些 openapi 的一个信息的一个初始化， 住土啊，这是住土啊的信息啊。然后呢，另外呢，就是我们需要配置他的远要路径，远要路径主要是，呃，这两个是吧，实际上就是这种呢，实际上大家也可以看到实际上调用的是同样的一个方法，只不过呢他渲染的页面的 展展现的方式可能有点不同啊，一个是 bug 的这种方式，一个是追 doc 的这种方式，但是具体有什么区别呢？待会我们来看啊，来看。 好，那么我们先做一下这一部分，看会出现什么情况啊，出现什么情况。那么这里面呢，我们就把这个两个， 呃需要用到的这个模块导入进来啊，导入进来，首先这样 我们就 from d r f 从这个第三方的 import 啊，相对它是有代码补全的，相对来说还是比较快的啊，比较快啊，刚才 from 还有 d r f 点 f 点 vivo， 它这个仕途里面导入 get schemer vivo 的这个实图啊，我们导入了，导入了，刚才说到第二部分，我们要做一些这个，说实话，这一段文字呢，我们就直接把它拷贝过来就行了啊，不做过多的一个讲解了。嗯， 好，那么还大家还记得还有一块地方就是 uil 的这个配置啊， uil 的配置呢？这一块呢，我们也直接拷贝过来，为了节省时间啊，大家可以自己 呃来一句一句的来体验一下，瞧一下，因为我这个是想提前写好了啊， 主要为了讲课，我就不。嗯，重复了，好保存，保存完之后呢，我们这个环境运行起来，运行起来，运行起来呢，我们用 stop 和对 dog 这种方式来访问，看一下 可以出现什么问题啊？出现什么问题？当时我遇到这个问题的时候，实际上呢是解决的方式相对麻烦了一些，但是实际上是不用那么麻烦的。那我们看一下哈，先试一下， 大家看一下，大家看一下。只有登录啊，时间整个页面没有出来的啊，然后我们再看一个 red dog， red dog 啊， red dog 也没有出来，那么看一下有没有爆什么错误 好，大家有没有看到啊？就是他的这个错误啊，指出的还是比较清楚的，意思说呢，就是我们访问 difysg 的他的一个静态的渲染的文件是四零四的， 报错是找不到这个文件，那就说明这个文件是找不到的啊，找不到的，那找不到了呢？实际上呢？ 嗯，当时我遇到这个问题的时候，我就直接想办法找到这个文件，是吧？放到 static 这个文件夹下，让我的这个整个应用这个找到啊，找到，然后， 呃，我们看一下这个解决的方式啊，简单讲一下哈，讲一下，这不这里面呢报了一些错误，意思就是说没有找到这些文件啊，没有找到这个文件，那我们解决的方式用的开始呢？是比较麻烦的这种方式是吧？这个报错呢，指的是我们 这个 difysg 下的静态资源的文件是访问不到的，那么我们就把这个 ysg 下的静态文件呢，把它拷贝到了我们可以访 我们的地方啊，我们把它烤味到了我们的 jungle rest friend work 这个文件下下，他也有个 style， 这个这个静静态文件他是可以访问到的，我们就放在这个目录下了，目录下最后测试呢是没有问题的，怎样呢？这种解决方式呢，相对来说是稍微复杂了一些啊， 因为我们在安装这个第三方软件包的时候啊，我们只做了这个 uil 的这个配置啊，我们刚才忘了，又在 cit 中配置这个应用啊，配置这个应用，实际上我们需要在 cit 里面把这个第三方的这个应用 把它配置进来啊，配置进来，我们在这边啊，在这边还记得塞天文件啊，我们在这个里面， 这个里面我们把 difysg 啊，把它配置进来。好，那我们就配置好了，保存一下，保存完之后呢，我们再来看一下 这个访问的页面的一个渲染的一个情况啊，我们来看一下。好，那么这个是蕊刀口的这种方式，我们回测一下 是不是这个瑞刀壳的这种方式的页面已经加载上来了，加载上来了，这个是刚才我们写的，我们看到是吧？他有设备模板的这个列表啊， 他的这个瑞刀可是这种方式呢，主要比较详细的定义了这个接口，是吧？这个接口的这个，嗯，要求啊，是吧？要求我们看 就是这里面有没有。这里面实际上是没办法做这个测试的啊？他的这个是响应的，他这个这个自断是什么？实际上没办法做测试。刚才我们那个 rest friend work 内内置的，我们就可以做一些数据的测试，那这里面实际上是没办法做数据测试的，那么再看一下那个 spot 的这种方式，嗯， spot 的这种方式啊，我们看到也可以了啊，也可以了，那么 spot 这个是这种方式呢？实际上他就可以做一些测试。例如我们获取设备模板的这个列表，我们 try it out 执行一下。 那有没有看到我们获取到了有一个设备模板，叫智能灯的一个设备模板。好，那我们再 回到我们的这个教程哈，教程，教程，教程呢？刚才我们已经演示了，演示了，就是做一些测试啊，做一些测试， 测试，测试，刚才讲到就是时间，还是比较简单的哈，在塞停里面把这个应用配置上去就可以访问了，那么访问呢，首先是这种第一种方式呢，我们刚才介绍的是内置的这种方式，就是原始说 fran von 内置的 api 文档 深层器啊，内置这种方式啊，他可以做接口的一个测试，另一种方式呢，就是十二个是吧？十二个使用的就是第三方的 dnfysg 这个模块啊， 这个模块，那这里面呢，实际上就是有一个方法，我们简单介绍一下，就是这两个实际上采用的是同样的一个方法，实际上有什么区别呢？无非就是他这页面旋的这个模板 不一样啊，一种采用 spot 的这种地面风格，一个使用是 redog 的这个界面风格啊，界面风格好，我们来看一下这个刚才看到的 像 spot 的这种方式，只用 stog 是一个比较好的一个文档生存器啊，他既支持我们输的拍摄的这种将构框架，这样再加哇 应用开发的框架里面呢，也是知识的啊，知识的。然后另外一个就是瑞刀壳的这种渲染这种方式，就是这种软件呃，页面的一个方式哈， 那么以上呢，我们看到相对来说代码量也不多啊，我们来回顾一下哈，回顾一下使用。第三回顾一下这堂客讲的内容哈，首先呢，我们需要配置的呢，就是在一种 rest friend work 内置的 ipad 文档生存的方式，那么内置的方式呢，相对比较简单，我们只需要在 rest friend work 的刀可有这个模块里面导入英克路的 docs uil 这个方法啊，然后呢在 ui 要拍同时里面把原来的这个路径配置上去，然后他就能自动获取这种 ipa 的这种 页面啊。那么第二种，我们详细讲到就是第三方的 dnfyisg 的这种使用方式啊，那第一步呢，首先是安装他啊，安装他，其次呢在我们的 ciatus 文件里面 啊，把这个应用吗把它配置进去。第三个呢，我们在 uil 的这个文件里面，是吧？首先把我们使用到的这个模块和方法 啊导入进来，做一些初始化的一些定义啊，最后呢，在我们的 uilpot 里面把我们的路径配置进去啊，基本上就，呃，就这几步啊，实际上是相对比较简单的啊， 然后呈现出来的这个方式呢，也就是我们看到的啊，这种接口的这种方式，嗯，好，那么今天的课呢，我们就讲到这， 那好，那么这堂课呢，实际上我们就讲到了我们开发出来的，嗯， resf for 这种标准的 ipa 接口，我们可以通过应 面的方式把它暴露出来啊，让我们很容易看到我们写了哪些接口，是吧？他的接口是 request 请求有哪些要求，以及响应有哪些这个自断。嗯， 那么我们这节课就讲到这里啊，讲到这里，那么下节课呢，我们想讲一下，就是我们这些接口啊，大家有没有看到我们没有做这个任何身份的这个认证，也就是是什么意思呢？就是说我们在访问这个 呃接口的时候，咱们这个接口的时候，直接请求的时候，我们看到他这个请求请求段时间没做任何的一个健全和认证，那么下一下一个呢？下一节课呢？我们去重点讲如何做他的一个健 认证，这样我们把呃一些 token 的值加在这个嗨的这个头部文件里面啊，做一些健全和认证，好好的，那么这节课就讲到这里，谢谢大家。

你好，我是 ipapos 的产品经理刘天宇，今天我想跟你聊聊如何利用开发工具 ipapos 的提高开发效率，早点下盘回家。 在当下互联网数字经济体系中，互联网数字化转型、微服务化、移动化背景下， api 数量爆发式增长，如何提高 api 的开发效率，保证 api 的质量成为一个迫在媒体的问题。市面上缺乏合适的技术和管理工具， 在当下的管理工具中，不 poss 慢，主要是针对于后端进行结构调试。此瓦盖主要是针对于 api 设计进行 api 文档的结构设计。 rapper 主要针对前端数据， moke、 吉米特主要是针对于测试人员进行压力测试。这些工具都是点状分散，各自为正，缺乏统一 规范，管理难度也比较大，因此需要一套系统，一份数据，解决多个系统之间的数据同步问题，结果相关工作统一、可控、可规范化管理，最终形成规范的后端。前端测试生产化、生产流程化， 达到协作高效、及时、准确。在开发过程中，不同的开发人员因为协作会产生各种各样的问题，产生了很多的痛点，我举几个例子。痛点一，后台接口没有写好，请问怎么提前进入研发？ 在产品开发工人中，常常会面临前单或者安卓 ios 开发工程师开发完页面，但是后端开发工程师接口未开发好，还需要等待的问题，这样会浪费掉等待的时间。痛点二，后端 接口写好了，怎么更便捷的分享给前端或者测试人员？后端开发好接口，可是不知道怎么呈现给前端行业，最直接的方式是复制接口相关的入餐和出餐的信息，通过微信或者飞输等方式发给前端，很不专业， 钱呢，阅阅读起来也比较痛苦。痛点是前后端测试一起写作时，怎么实时跟进接口的状态。 在面临大型的项目，特别是几百个接口时，货端人员对于接口的管理协作也会面临很大的挑战。能够接口是随开发的，找不到开发人 开发机油是什么现状了？是开发中呢？还是已完成，还是需要再改一改？前端和测试也不知道进度怎么样了，通点是不同人员不同 工具，接口数据复制来复制去太繁琐，测试人员想骗电话，自动测试后端还得一个一个接口的去复制，通过飞输或者微信叮叮的方式发给他们。测试呢，还需要复制到几名条里面，然后再进行配置，最后进行冒烟测试或者信任测试，很麻烦。 那今天呢，我教你使用一套数据员，一套完整的写作方式，把后端前端测试运转起来， 从接口设计到接口调试成功，快速生成文档分享给前端开发者。测试人员呢，直接可以拿开发完成的接口，马上可以进行自动化测试，这一套流程， 实现工作流程无缝衔接，研发效率提高。下面呢，让我用一个产品演示项目 来给你们做一个演示。首先呢，我们登录 app post 进入到我们的室友团队的演示项目下，我们新建一个接口，登录接口，输入 ur 和入川， 点击发送，再点击保存，这样我们就新建了一个接口，这是我们最基本的调试功能，很多开发人员都需要在开发接口的过程中不断去调试，因为自己的接口是否开发正确，确定没有问题后，我们把这个接口的状态呢置为也完成，这样方便我们去查找， 以方便给前端或车的人员呢去查阅和使用。现在我们需要把这个接口呢分享给前端，让他们去对接接口。点击分享复制生成的接口文档的链接，在浏览器中打开，这个时候我们可以看到一个完成的接口 文档，但文档的信息比较少，只有基本的接口信息和入餐，那我们再回到接口，点击响应区的成功响应失利从响应区导入，同时我们再点击提取之段，然后保存，我们再一次去刷新一下整个接口的文档， 我们发现这次的文档就比较全，接口的基本信息，入餐成功，响应视力我们都能够清楚的看到整个接口的数据结构，同时也能使用提取的字段。 分享文档是一个涉及到数据安全很隐私的事情，所以我们可以在分享的时候选择文档的有效期，也可以去设置密码啊，防止被外人获取的链接。在开发过程中，后端接口没有开发完，但前段页面已经开发完成，只在那干等着，这种 情况怎么办呢？这个时候的 logo 服务就出现了，在新建接口的时候，我们可以使用 moco 来模拟真实的接口，其中响应的数据结构是完全跟真实的接接口一样，只是他的数据是假数据。 路过服务中，我们是我们支持路过 gs 的所有语法，包括生成一到一百的随机数，随机省份视线、随机日期、随机一段文本等等，极大的满足业务的需要。 当我们快速生成一个完整的末后接口后，就可以分享给前端，他们就可以进行工作了。把接口对接的部分工作做完，等后端的接口开发完成后，就可以进行前后端连条 没过服务，填充了工作中的开发时间空档，合理利用工作时间，让整体的研发效率得到大大的提高，那不 加班就不再是梦。在 app pose 中有一个针对后端人员的内部协作机制，在线实时协作，就是所有的后端人员维护同一个项目数据员，一个开发者新建了一个接口，其他的协作人员可以实时获取到接口的同步数据， 这样开发者想利用其他开发人员的机构时，可以直接查看和使用，同时其他的开发人员机构有问题也可以直接参与协作， 以开发接口给了开发的共同进行接口的开发。为了更好的协作开发， ipad pose 还提供了协作日制，所有人员的改动的数据都能够在日日中追溯和查看。 在工作中我们还能看到谁在线，谁在建接口等。学到过程中有一种场景就是我不想别人改我的接口，这个时候我们 可以用锁定功能，一旦我们锁定之后，除了自己，其他人是不能够更改这个接口的，这就避免了别人篡改自己的数据，协作就会产生冲突。那怎么解决冲突机制呢？ ipapos 的还提供了冲突解决机制，可以支持保存他人的更改覆盖自己的数据， 你可以选择自己的更改覆盖远端的数据，你可以两者都可以保留，很灵活。 我们常常会遇到这样的情况，当接口改着改着，突然发现改错了，想回到之前的接口版本，这个时候悲愤就出现了。 你的每次更改都可以进行备份，他的机制像即可一样，每一次的更改都可以进行备份。当自己想回到之前的某一次更改的时候，我们可以使用备份还原，点击还原的版本，直接可以覆盖到当 前的内容并保存，省去了查找再继续更改接口的时间成本。 在开发过程中常常会遇到这样的情况，很多接口都需要传拖痕参数，因为只有拿到登录态才有权限去拿其他接口的请求数据。这个时候有一个办法使用全局参数，比如登录接口发送请求的时候，我们在后置性脚步里面通过 apt 点 global 时的赛特 去设置托肯值来获取享用，即享用即可中的托肯，并保存到环境边量中。 在全球参数中，我们可以在黑人里面设置托肯值，用两个大括号的方式来引用存在还原变量中的托肯，这样你在后面建的任何接口都可以自动带上托肯。如果你的接口带上这个参数，那其他的机 不想带上怎么办呢？你可以使用目录参数，把要带上这个参数的接口都放在一个目录下， 然后在黑的里面搜索托卡，用两个大块以用托卡的方式来引用这个参数，这样目录外的接口就不会受到影响。 在左侧测试模块下，我们能看到刚刚我进了一批接口啊，有登录接口、新闻列表接口、新闻详情接口、评论接口、删除新闻接口。 我们点击接口会自动添加到带测试的列表中，点击开始测试就会自动自上而下的至今每一个接口和接口中的断言。 根据断言，我们能判断这批接口的最后执行情况是否符合预期，比如登录是否成功，成功后才能拿到新闻列表的所有，若没有，就没法继续执行 成功后面的接口。什么叫断言？在我们的玉字型脚本和后字型脚本中，内置了很多脚本， 可以断言接口的执行是否符合预期。比如在后执行脚本中，我们通过 apt 的 ascent 来获取律师办事的 rap the status， 判断他是否等于两百， 诸如此类的内容是否为节省都支持，还可以支持自定义脚本等进行断言。在参数描述库中，对一些常见的描述，我们可以放到参数描述库中，当你写参数的时候，参数描述会自动联想，补充上去非常便捷。 那如何来补充参数描述库的内容呢？我们可以在成功响应室内里面去提取自断，也可以在包底的节省里面补充提取 补充到插座描述库中，非常的方便。首先， applepose 的数据都是完全保证用户信息隐私安全的，你也可以使用他的客户端版本，支持拖机理性使用，数据完全存放在你的电脑本地。 同时他对于团队和项目的统一管理是非常安全的，有空可以去试一试，特别是对于人员和数据的安全管理机制，这里就不在最数 以上呢。我们通过结果的设计和调试，快速生成文档，跟前任来对接，提高对接效率。 通过木火功能来填补前端等待的时间空档来收到研发时长。利用全局参数和脚本的搭档来减少后端开发者重复填减参数的频率。参数描述库的智能填充，省去了描述部 部分的工作量以及接口的批量。测试集了测试人员的时间成本。突击使用或在线使用的 api 集中管理，避免了数据安全风险。通过对于他 api 数据串联、后段、前段测试人员等不同角色的开发人员， 能够有效的提高工作效率。同时对于不同的角色的一些小的功能能够减少开发时间，提高各个角色之间的工作效率。 无论是个人还是整体工作效率都得到了提高，那么不再加班就不再是嘴上说说的事儿。 最后，希望你工作开心，希望你高高收入高高，我是刘天宇，希望今天的课程能够帮助你提高效率，也欢迎你把这节课分享给需要的朋友。

嗨，大家好，这里是能让你早点下班的 apad pose， 在两分钟教你上手 apad pose 这一期的视频里，我们提到了 apad pose 六点零版本，支持了外部版在线使用，其中呢，就有细心的小伙伴们发现了我们支持了四种代理的选择。 在这期视频呢，我们就来介绍一下，为什么要分不同的发送代理方式，以及每个代理的特点都是什么呢？为什么要分不同的发送代理方式？由于浏览器底层有跨越限制，为了突破这种限制， a 拍 pos 进行了多种尝试，比如打包成客户端等。 但对于 wifi 来说，还是需要用其他的方式来进行突破。首先是云代理，这种方式呢是通过将请求委托至 app 泡死的服务器进行请求，这里说明一下， apapos 的服务器只会发送请求，不会记录任何数据。 然后呢，将获取的请求结果再返回给前端进行呈现。这种方式的优点是无需下载安装任何插件即可使用。缺点呢是无法请求用户本地或者局域网的接口地址。第二种是 a k pos 桌面代理， a 拍 pos 桌面代理是一个应用程序，下载安装后，用户点击发送，就会通过将请求委托至该应用程序进行请求。 然后呢，将获取的请求结果在返回给前端进行呈现。这种方式的优点是可以请求任何接口，并且不存在跨域问题。 缺点是需要下载安装桌面代理应用，会增加操作成本。第三种浏览器代理，浏览器代理是直接用前端 ajx 发送请求。这种方式的优点是无需安装任何插件即可使用。缺点是存在跨越问题，并且不支持在 git 的方式的请求里携带高级参数。 第四种，浏览器插件代理 appos 浏览器插件代理是一个兼容谷歌浏览器的插件，我们很快呢也会支持火壶下载。安装后，用户点击发送就会通过将请求委托至该插件程序进行请求， 然后将获取的请求结果再返回给前端进行呈现。这种方式的优点是可以请求任何接口，并且不存在跨于问题。 缺点是无法实现在 gcd 中发送保底参数。以上呢，就是关于 apapose 四种发送代理的介绍，相关的安装包和图文下载教程已经放到评论区里啦，如果还有 什么不清楚的地方，或者有什么好的建议，也非常欢迎加入我们的官方社群，或者在评论区留下你的宝贵意见。那么我们这期视频就到这里啦，我们下期再见，拜拜！

大家好，今天推荐个接口测试工具 a p f fox 啊，官方文档 a p f fox， 点看吧。特性一，接口管理支持接口在线运行， mark 数据、动态参数接口一键分享， 我们点开 a p i fox 的客户端之后啊，左侧有一个接口管理的功能，然后在接口管理这里面，我们可以维护自己的 a p i 接口啊， 包括我们可以对 api 接口进行一个分组啊，包括我们这里可以新建一个目录啊，目录就是一个分组的一个功能。 ok， 我这里已经有建好的一个接口啊，我们看一下他提供的几个功能。首先我们的接口可以在线运行啊，我们直接点击发送啊，他就会实现我们接口的一个在线调 用啊，当然这里可以照艳我们的响应啊，我们可以把它关掉。嗯，这里的话其实已经请求成功了，你看一下我们的啊， api 接口已经收到了我们的请求啊，是没问题的。然后第二个功能的话，他就可以提供这个呃，接口的一个帽口啊，在这里啊，我们有一个帽口帽口服务啊，大家感兴趣的话可以点一下 这个帽可，之后啊，他会直接返回我们的这个帽可的一个数据啊， 这个也是比较方便的。然后第三个请求呢，他支持这个动态参数啊，怎么叫动态参数啊？比如说我们这里叫老王，对吧？我们 a p i 接口最后打印出来也是叫老王，然后给我们这个用 户，我们想把它用一个 mok 的数据，不就动态参数给他代替一下，我们这就会有这个动态参数的概念啊， 怎么去做呢？就是说我们这里的话啊，找到这里有一个动态值啊，我们点动态值之后啊，我们可以看到他提供很多的内置的动态变量 啊，包括这个 c title， 中文标题，中文单字的，然后中文去中文姓名，我们这个用这个中文姓名啊，他的语法就是这样子的，我们把它粘一下，比如他生成的一个预览，全是一个中文的名字啊，把它粘出来， 粘完之后啊，我们可以替换一下，替换一下我们接口里面的这个，呃，入餐的一个纸啊，这样的话就我们保存一下，然后再次请求一下，我们看 看一下后台接口收到的这个 uzid 是不是这一串啊？还是他已经貌合过的，哎，我们看他已经用这神秘给替代了。清一下日志，重试一下，多点几下试一下。 ok， 我们发送了好几个请求了，然后我们的调用日志也打出来了， 打印摇肩、用光明攀屏啊，这个都是动态的一个参数值啊，这就是他提供的第二点功能啊。然后再一个的话，他这个接口啊，我们可以支持一个叫在线分享啊。 怎么分享的？在线分享的话，我们可以点击左侧这个在线分享的一个菜单啊，然后我们可以新建一个分享啊，比如说我们分享的标题啊，随便起一个我的分享吧， 然后我们可以选择我们要分享哪个环境的一个接口文档，我们选开发环境。 ok， 分享完成之后，我们该填的接口啊，包括我们的一个范围啊，我们可以指分享指定的一个接口啊， ok， 完了之后我们点保存，保存完成之后啊，这里一个分享已经出来，我们可以打开分享链接啊，看一下分享出去的东西是个什么样子的。可以看到他这个接口文档已经生成了，包括我们的项目名称啊，然后我们也可以在线去调试啊， 包括我们的入餐啊，我们的入餐包括我们的返回啊。特性二，接口自动化测试，自动化测试的话，我们可以点开左侧的自动化测试的菜单，然后在根目录这里点击加号啊，添加 个测试场景，比如说我们叫叮当管理测试，然后我们 ok 确定就好了，嗯，然后他给我们建立了一个叮当管理的一个测试用力级啊，然后这个测试用力的话，我们可以添加我们的测试步骤啊，我们 在测试步骤这里面，我们从接口导入一个接口啊，去进行测试啊，我们导入我们刚才的商品下单接口，点击确定，点击确定之后，我们这个下单接口已经 ok 了，我们点保存。嗯， 然后我们点进可以看一下，他其实就是刚才的那个 api 接口啊，他把我们的这个呃参数的这个呃节省入餐啊，已经打印出来了，没有问题啊。然后我们这里在右侧这里啊，我们可以对他进行一个运行式配置啊， 我们可以选择当前接口运行在哪个环境啊？我们现在是开发环境，然后我们称数据的话，我们不使用称数据，不使用这个称数据，然后我们的循环次数啊，这其实是一个自动化次数，一个概念，我们可以循环一次啊，比如说每个县城循环一次，然后我们起几个县城，我们可以起十个县城， 我们起十个线人去跑啊，然后这里继续保存，然后他高级设置里面啊，提供了很多配置啊，我们几乎不太用到啊，我们这里 ok 完之后就可以继续去运行了， 可以看到他在自动的进行这个自动化测试啊，起十个线程啊，每个线程请求一次啊， 然后我们看一下我们的，我们的这个接口日志啊，已经在自动的去测。 是啊，可以看到日志他是自动刚才去打印出来的， 然后我们这里测试结束之后啊，他会统计出我们接口的一个测试情况啊，比如说总的耗时啊，然后接口请求的一个耗时，还有平均接口的一个请求耗时啊，然后我们还可以导导出我们的这个测试报告。嗯， 可以看到我们刚才起的十个线程啊，然后每一个线程的一个完成情况，这里都可以看到啊，很方便。嗯， 然后他还提供了许多其他的一些功能，比如说我们的这个数据模型管理啊，我们在数据模型里面可以看到他把我们的很多 dto 啊， vo 啊，可以展示出来，我们可以自己去维护他的一些属性之类的，包括我们的这个 模型，我们可以生成一些模型代码啊，是比较方便的。然后我们包括代码的类型啊，我们可以选 go 啊，或者 joa 类型啊，很方便。 ok， 其他的功能大家可以去体验一下，今天的分享就到这里。