FineDataLink 支持在数据开发中从 API 接口中取数,并解析 JSON 或者 XML 格式的返回结果为二维表结构,然后使用其他数据转换中封装好的可视化算子对数据进行进一步处理和计算。
本文为你介绍API 接口相关入门知识,便于您后续使用 FDL 进行数据开发。
Resource(资源)是指代表某种东西的对象,它具有一些与之相关的数据,并且可以有一组方法对其进行操作。 例如。 学校,班级和学生是资源,删除、添加、更新是要对这些资源执行的操作。
Collections(集合)是一组资源,例如,211大学是全国多所优质大学的集合。
URL(统一资源定位符)是可以通过其定位资源的路径,并且可以对其执行某些操作。
URL应仅包含资源(名词)而不包含动作或者动词。但是对于例子:增加学生的API路径:/addNewStudent,包含操作addNew以及资源名称Student,因此这个路径并不标准。
正确的方法是/schools ,这是一个很好的例子,不包含任何动作。
但是我们怎么告诉服务器,有关学校资源的操作呢,例如增加,删除或者更新学校?
这就需要使用 HTTP 方法 (GET,POST,DELETE,PUT) 。
例如:
如果资源和资源之间可能有父子关系,那又应该如何设计呢?例如学校的学生,下面是一些示例:
请求服务器在数据库中创建资源,主要是在提交Web表单时。
POST是非幂等的,这意味着多个请求将具有不同的效果。
请求服务器更新资源或创建资源(如果不存在)
PUT是幂等的,这意味着多个请求将具有相同的效果。
请求从数据库中删除资源或其实例。
API接口文档一般分为接口描述、接口地址、请求方法、请求参数、响应内容、错误代码、实例几个部分:
这个地址表示的是网络地址,即url,我们需要调用接口url,获取响应内容
常见的请求方法为 GET 和 POST,注:FDL 支持GET和POST两种请求方式,若您需要使用PUT或者 DELETE 请求方法,POST 方法也能满足需求。
用来传递信息的变量。即需要请求的字段名的名称和规则:都是哪些字段,字段的类型是什么,是否必填字段等等
URL传参
Headers 请求头
Body 请求内容
详情参见本文3.1、3.2 节。
GET通常用于获取服务端数据:
GET方式在url后面拼接参数,只能以文本的形式传递参数;
传递的数据量小,4kb左右(不同浏览器会有差异);
安全性低,会将信息显示在地址栏;
速度快,通常用于对安全性要求不高的请求;
GET请求也可以有Headers参数
GET请求可以传递参数,一般的传递方式为 URL传参,例如:
在GET请求中,遇到参数 / Params / Querys 均是以 URL传参的形式进行传递。
在POSTMAN中,可以直接用 URL传参形式,也可以在Params处填写KEY和VALUE,会自动进行拼接(演示)。
在 FDL 中也可以通过直接URL传参或者请求参数写值自动拼接使用接口,如下图所示:
post提交数据相对于get的安全性高一些。
传递数据量大,请求对数据长度没有要求;
用于密码等安全性要求高的场合,提交数据量较大的场合,如上传文件,发布文章等。
POST请求一般由Url 、 Headers 、 Body组成,如果在POST请求的接口文档里遇到 Params / Querys 则需以像GET请求一样使用URL参数传递参数,而POST请求的接口文档里面的参数一般指Body。
POST请求不同的请求格式:
{"name":"Roxy","password":"123"}
此时的请求头为:
例如:name:ziv,password:123
<?xml version="1.0" encoding="UTF-8" ?>
<password>123</password>
在 FDL 中输入请求头和请求参数使用接口,如下图所示:
滑鼠選中內容,快速回饋問題
滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。
不再提示
10s後關閉
Submitted successfully
Network busy