开发者学堂课程【阿里云 API 网关使用教程:这些地方容易出错】学习笔记,与课程紧密联系,让用户快速学习知识。
课程地址:https://developer.aliyun.com/learning/course/406/detail/5239
这些地方容易出错
内容简介
一、关于 API 的类型
二、API 定义是什么
三、对 API 草稿的定义
一、关于 API 的类型
关于公有和私有的界限:基本上可以这样理解,私有的API除非你主动授权给某一个 app,否则是不会有任何人能够看到的。
即使说你把某一个 API 分组上架到云市场了,那么这个分组中一些私有类型的 API 是不会暴露出来的,他只会把这个分组中的公开类型放到云市场上。
二、API 定义是什么
草稿是什么?那我现在线上运行的是哪一个定义?
经常出现,有用户改了 API 的定义,但是线上还是旧的。出现这个的原因可能是没有发布,那这个可能是有歧义的,我们创建一个 API ,
看一下运行环境的这一列,因为没有操作发布,所以他这个时候就是纯粹的是一个草稿,它的定义根本就没有在任何环境里生效。
那么我们需要操作把他发布上去,比如说我们把它发布到线上。然后这个时候会发现这个线上这个环境后面多了运行中三个字,那么有这个这样的才是表示已经发布到这个环境了,点击这个运行中。
随后出现的就是目前在这个环境中运行的定义,对于定义到底和我们本地的这个草稿是否移位置,这个要看你后来有没有再改过,如果说后来在这个 API 定义这里又编辑过。
然后又没有发布的话,那么他们两个就是不一致的,所以一定要切记,就是有修改,一定要发布。他才会生效。
三、对 API 草稿的定义
这个页面其实我们是对 API 草稿的调试,也并不是某一个环境中运行定义的调试,他调试的就是你最后更改了这一版的 API 草稿定义。
而且因为他调试的是草稿,直接是在开放 API 的这个用户,这里直接赋予了调试的这个权利,所以他并没有 app 相关的东西,也就是说他没有认证,那么我们这个调试也只是针对草稿,然后没有签名方面的调试的。