00:00
好,同学们,这一节呢,我们给大家演示一个简单的接口,叫做health,是之前我们提过的,可以看这个啊in DB的节点呢啊,实例它是否是一个健康的状态啊,如果是200呢,我们可以点一下啊,它会返回这个啊,一个Jason啊Jason里面呢,有name,有message,有checks。呃,那么我们呢,现在就给大家演示一下如何用我们的API post。去请求啊,去去对这个接口发起请求啊,去调试这个接口啊,在右边呢啊在这个浏览器的右边,我们可以看到有一个下拉,有一个下拉菜单啊,你点呢,它会直接把这个地址复制出来,然后你CTRLC我们把它复制复制下来啊,到我们的这个目录底下呢。点击右键新建,新建一个接口,把这个地址粘进来。啊,我们可以看到呢,这里呢,它要求是一个get请求,我们在这里呢,把这个请求方式改成get。好,我们现在发送请求。
01:00
哎,可以看到呢,我现在收到了一个一条消息,他说什么呢,没有权限啊,Message没有权限。那么我们现在呢,回到我们的web UI,哎,点击这个load data,再点击API talkingken,那么这里呢,是我们web UI的一个API talkingken管理界面,可以看到我们这里呢有三条talkingken,第一个tonys token呢是我们呃,初始化的时候,就是第一次安装完1PLUS DB进行初始化的时候创建的token,我们可以点开看一下。啊,那么这一个呢,我现在选中的这一部分啊,紫色文本,那么它呢,其实是我们的talk的内容啊,就talking的值啊,点一下呢,可以直接复制到粘贴板,另外呢,底下有一个就是它的啊权限的汇总,可以看到它有这个,对这个权限可以,对这个我们啊存储桶可以啊创建存储桶,也就是创建存储桶和读取存储桶啊,包括对这个仪表盘,对这个or GS就是组织,然后sources就是数据源task啊管理任务,包括telegraphs。
02:05
啊,说白了,其实他呢,有全部的这个啊,我们的管理权限。好,那么接下来呢,我们再看底下这两个重名的啊,这两个重名的呢,实际上是我们当时在操作telegraph创建这个EXAMPLE02K的时候呢,自动帮我们生成的API talking,我们在现在再点击一个啊,可以看到现在呢有两个啊,有两个talking,我们去telegraph这里呢,点击这个setup。再点击generate new API token就创建一个新的API token,然后呢,关掉,我啥也不干,关掉,回到API tokens。哎,可以看到呢,现在就变成三个了,那么这个名字什么意思呢?这个名字其实就是它的这个权限范围,我们点击一下看它的详情。呃,可以看到这个名字呢,叫做right example02bucket,也就是向EXAMPLE02这个存储桶里写数据。还有一个就是readid example02com telegraph config,就是它可以读取名称为EXAMPLE02COM telegraph的这一个配置文件啊,那么它呢啊,可以看到底下的这个权限的面板呢,只有两条权限。
03:10
也就是说呢,Talkingn ton什么意思呢?就是我们的密钥啊,这个密钥呢,同时也进行了一个权限的限定啊,我们拿着什么样的钥匙可以干什么样的活,那么这样呢,之前我们自己封装过一个脚本,在我们的呃,用户的B目录下,我们就知道这个为什么要export一下这个呃,Fla的。哎,为什么要export这个in fast talking呢?那么这个呢,其实就是对我现在的这个在环境变量里面呢,做一个这样的变量,然后telegraph呢,会去你的这个环境里面读取这个变量,拿着这个token啊,去执行那个写in Fla DB的操作,所以如果呢,你这里给他一个in plus,你比如说啊,没有这个啊写存储桶的这个权限的token,那么这个时候呢,操作就会失败。呃,那么我们看一下在HTTPAPI里面是怎么样去进行这个talking的指定的。
04:04
那么这里为了方便大家观看呢,我把这个字体的大小调大一点,在右下角有一个缩放。我现在把它调到125。啊,一百二吧,好字大一些了,呃,那么接下来呢,我们现在这里有一个接口,我给这个接口呢,起个名字就叫test吧,啊叫health。啊,那么接下来呢,我们去看一下,我现在这个地方呢,是没有权限,怎么样,怎么样让他有权限呢,现在这个请求部分啊,这一部分。这一部分是我们的请求相关的信息。啊,这里呢是请求头,然后这里是查询的参数啊,这里是我的请求题啊最后呢,这里有些认证啊,包括这个这两个,这两个内容呢,是我们这个,呃,Post API这个软件提供的功能。呃,下面呢,是我们的响应的内容,那么刚才给大家看的呢,这个是响应体,哎,就是说这个in Fla DB呢,告诉我们没有权限。
05:08
好,那么接下来呢,我给大家加上这个token。那么加token的方式呢,是在这个地方啊,在这个请求头上,我们去加一个,哎,特别的这个建筑,对,那么这个键的名字呢,叫做authorization a or这个单词啊,那么参数值呢,需要注意,我们需要talking开头打一空格,然后去我们的web UI上。呃,把这个talking呢,给他粘过来,我们就用这个tonys talking,就是我们初始化用户的这个talking,然后点一下复制到粘贴板。哎,回到我们的postman上来,然后呢,注意啊,这里要有一个空格,要有一个空格,空格完之后呢,把它粘上好。现在呢,我再去发送的话呢,我们这个,呃,发出去的这个请求。就会带上我们的这个talking,现在呢,底下这一个留下来的还是我们之前发的请求啊,那么为了方便比较呢,我们看一下刚才这一次请求的请求头啊,看他什么内容。
06:13
啊,点一下我们过来。那么可以看到呢,现在是这个状态,我们现在把它F1截图。好,我留一份啊,先把它最小化,那么接下来呢,我再发起一个请求。那么可以看到呢,我这里请求体就变了,说啊什么意思呢,就是啊,我这个路径不存在啊,这个地方呢,我们要去看一下是为什么。呃。这个实际上是因为。我怀疑是这个路径,我们这个刚才用的这个自己带的啊,就是我们本地部署的这个API文档呢,给我们生成的路径有问题,应该不是API-V2。
07:02
我把这个抹掉试一下。啊,应该是直接杠health。啊,那么可以看到呢,现在请求体上已经有内容了啊,我怀疑这个也不用认证也可以,不用掏费也可以试一下。啊,那么这说明什么呢?说明我们本地的这个API文档有误。啊,你可以看到这个本地的A呢,他说这个地方啊,需要token的权限认证啊需要token认证,但是我们发现呢,经过我们刚才自己的操作呢,啊,首先是APIV2-health这个路径根本就不存在,另外就是啊直跟目录跟路径底下的这个health呢,啊不需要这个权限也能直接访问。但是总的来说呢,啊,我这里操作失误也不丢人啊,因为我们这个开发过程中呢,啊,其实就是这样找坑的这个过程,你现在就发现这个health呢,其实呃,如果说文档要是它的最终产品形态的话,那么这个功能其实已经是啊属于一个没有开发好或者异常的情况,呃,那么接下来呢,我们去换一个这个,呃,换一个接口继续测试。
08:05
我们新建一个接口。新接个接口,我看去文档里找什么呢。啊,要不就这个吧,这个叫authorization,那么这个呢,你可以看到这个API的描述,它其实是去列出我们现在in Fla DB实例里面所有的talking,然后把它这个权限呢也全部列出来。嗯,我觉得这个100%需要要需要复权,那么现在呢,我们就去测一下这个接口啊,还是一样点下右边的,然后把它这个URL呢给拿下来,然后到我们的API post里面,我们去新建一个接口。点击新建接口,我刚才是右键啊,然后新建接口,新建接口呢,这里先起个名字。啊,我就不信了,那么这个地方呢,先把这个URL打上去之后呢,我们可以看到这个默认是post请求,但是文档里面呢,要求你用get请求的方式来对他发起请求,那么接下来呢,把这个请求方式改成get。
09:04
啊,在这个header里面。我们先现在先发送一次。哎,可以看到呢,这里说我们现在没有权限啊,没有权限,那么接下来呢,我们还是要去设这个请求头,我们直接去health之前写的那个里面复制。来拿下这个。请求头authorization,然后再把这个拿下来,我这里就直接复制了。好啊,这个大家操作的时候呢,一定要注意啊,你现在要把这个这个键值对放在请求头上啊,千万不要放在请求体上,放在请求头上,那么接下来呢,我们再次发起请求。可以看到啊,我们现在这个数据呢,就真正的出来了,说明这个接口呢,是真的需要权限的,真的需要权限的。啊,我们可以看一下这个啊,我这个请求题里面都带点什么啊,其中这里呢,大家可以看到一个列表,那么这个列表里面我们看一下啊,可以看到这里呢,他列了一个talking,然后这有这个talking的ID。
10:03
啊,包括这个他的组织啊,对应的用户ID啊,就是创建这个talking的用户ID啊,对应的那个用户的用户ID,那么用户的名字呢,就是Tony啊,这里还有一个描述啊,这个应该是它的名称叫tonys talking。啊,Tony,那应该跟我现在用的这个是一样的,我们可以看一下这个请求头。啊,可以看到呢,他现在跟我的这个啊,是B9B是吧,然后最后是W2W。看看是不是还真是是吧,这就是我我们自己talking啊,那把这个折叠一下,我们应该可以看到第二个啊,可以看到这个是我们刚才啊telegraph创建telegraph配置的时候呢啊,自动帮我们生成的talking。好,那么这就是这个接口的功能,另外呢,大家我不知道大家记不记得,就是我们之前说这个telegraph talking呢,它只有呃,像EXAMPLE02这个存储同写数据和读取EXAMPLE02COM telegraph配置的这个权限,它只有这两个权限,那么我如果用这个talking来访问这个organization接个端口啊,接口能不能访问呢?我们可以拿来复制试一下,把这个talking呢再换掉。
11:12
换掉CTRLV啊可以看到呢,我现在用了一个啊,之前创建telegraph生成的talking,我们现在发送请求。啊,我们看一下这个响应,哎,可以看到呢,这里说,哎这里呢,直接就什么都没列出来。那么这是为什么呢?我们回到web UI来给大家一个解释。呃,回到我们外部UI呢,我们可以看一下这个tonys talking。哎,大家可以看到这里面。我们对这个权限呢,呃,对authorization呢,它是有读权限的,但是我们这个telegraph生成的。Ton。啊,他没有这个权限,呃,他没有对这个authorization进行读取的这个权限,所以呢,我们这里使用呃,这个telegraph生成的talking呢,啊,去访问这个接口呢,就什么都不可见。
12:04
那么现在呢,我们可以去创建一个啊,可以看这个authorization的talking啊点击右侧有一个generate API talking啊生成API talkingken,呃,然后呢,这里面有读写API talkingken和all access API talkingke,呃,Web UI呢,可以帮你快捷的生成两类talkingken,一种是读写数据的talkingken啊,你点这里之后呢,我们可以看到就是你可以去呃生成一个talkingn呢,让他对某几个存储桶有读取或者写的权限啊左边是读啊,左边是读,右边是写,大家注意。呃,那么这样呢,就是我们。现在呢,要去弄一个具有。啊,权限的读取,权限的这个talking呢,就得生成一个all access API talking。不过这里需要注意,并不是说我们啊在in Fla DB里面只能创建这两类talking啊,实际上这个里面的权限呢,比如说你访问哪一个组织啊,你访问哪一些这个telegraph配置呢,我们整个这个一发DB的talking呢,权限的分配可以做的非常细致啊,只不过是因为web UI呢,这边它只提供了两个快捷选项,如果你后面呢,想弄更精细的talking管理的话,你可以使用inlux命令行工具,我们后面呢会讲到,或者呢,你就是直接用HTTPAPI,然后自己这个写请求去操作啊,总的来说呢,还是建议你用inlux命令行工具。
13:30
呃,那么现在呢?我们去做一个all access if you are talking。呃,这个呢,他给了一个警告啊,然后完了之后我们直接点save。那么这个呢,就是我们刚才创建的API talking啊,点一下把这个东西呢拿过来。接着呢,我们用这个新创建的to。哎,把它粘过来。修改它。好,那么接下来我们还是用点击发送可以看到呢,我们这个有这个对authortraization,呃,读写权限的talking呢,他就能把所有的talkingn给列出来啊,之前的那个就不行,所以说这就是啊,不同的talkingn它有不同的权限,然后影响我们程序不同的行为。
14:17
好,那么现在呢,把我们这个请求给保存一下,你要注意呢,我们现在有一个呃接口名称叫我就不信了,但是呢,你会发现左侧诶这个演示目录底下并没有出现我们这个呃API啊那么为什么呢?是因为我们没有保存,现在呢,你CTRLS诶把它一保存,它呢才会出现在左边,诶那么是是这个软件的用法啊,这里面还有一个问题,就是我每一次呢,如果说哎我想去测一个接口,我都要去新建一个接口,完了之后还得再啊大费周章的去加这个,加这个talking啊,那么一个两个还好,如果说我header里面呢,请求头每次啊要要弄很多东西,那我这岂不是很麻烦嘛,是吧?啊那么这里呢,交给大家啊,我们先把这个都删掉啊,点击右边这个垃圾桶,把它删掉,把这个请求桶呢,都是清空啊,我们现在怎么弄呢,我们现在呢,在这个目录上点击右键。
15:14
有一个编辑目录。好,那么这里呢,可以看到有一个目录公用header,那就是在这个目录里面的所有接口呢,都会同时使用这些header来进行请求,那么我们这里面写authorization。AUTHOR。IZ。然后这个参数值呢,就是talking to啊空格,我们去用这个tonys talking。呃,把它复制过来copy。然后这边呢,一粘贴啊,点击保存。好,那么可以看到呢,我现在这个。呃,里面呢,没有这个放talking。
16:02
好,那么现在呢,我发送请求,看能不能列出这个啊,我们所有的token来点击发送。那么可以看到呢,我们这里面呢,还是把所有的talking都列出来了,可以看到我这里面啊,这个接口单个里面我没有写这个talking,那么现在呢,看下我们的请求头。啊,那么可以看到呢,我们的请求头里面啊,是有我们刚才在目录里面添加的这个talking的啊,是有这个header的啊所以说呢,啊,这就是我们啊做一个快捷的就是共享请求投的方式。好,那么这一节呢,就给大家讲了一下,呃,关于talking跟权限的,还有这个啊,接口测试的问题。
我来说两句