文章采集api( 【PostmanPostman】API接口（）)

　　文章采集api(

【PostmanPostman】API接口（）)

　　

　　本节主题：1.2 阅读API接口文档

　　课程讲师：查理

　　观看地址：点我进入

　　1 本节重点

　　2 课前准备2.1 接口测试工具

　　提前准备一个接口测试工具，选择以下工具之一：

　　POSTMAN 是最好的接口测试工具！

　　点击此链接邮递员 | 下载Postman App进入Postman官网下载页面，选择对应版本（操作系统和32位/64位）并安装；

　　

　　如果正常，浏览器会自动识别你的电脑系统。本教程用macOS电脑打开，图中圈出的地方会自动识别电脑系统；

　　

　　Windows用户需要选择32位还是64位版本，需要先检查你使用的电脑是32位还是64位处理器，如果不确定，可以在电脑里查看设置；

　　

　　点击下载，直接打开压缩包进行安装。

　　

　　安装后需要注册才能打开软件，分别填写邮箱、用户名、密码。您需要选中接下来的两个框，然后单击橙色按钮注册一个免费帐户。

　　是一款免费开源、轻量级、快速美观的 API 调试工具，用于替代 Postman。可以帮助程序员节省时间，提高工作效率；

　　无需下载，访问官网即可使用！

　　点击访问：POSTWOMAN官网

　　极客专属的界面协作管理工具；

　　点击访问：

　　ApiPost是一个API调试和管理工具，支持团队协作，可以直接生成文档。它支持模拟常见的请求，如 POST、GET 和 PUT。是后端接口开发人员或前端和接口测试人员不可多得的工具；

　　点击访问：ApiPost官网

　　2.2 接口准备

　　- 在上课前找两个API接口，可以是建道云，公司内部系统，也可以是第三方API接口（不知道在哪里找？有很多第三方接口可以测试阿里云市场免费~点击查看）

　　3 课程内容3.1 如何阅读接口文档？

　　API接口文档一般分为接口描述、接口地址、请求方法、请求参数、响应内容、错误码、实例：

　　接口描述：简要描述接口的逻辑和功能。例如，这是一个发送消息和查询天气的接口；

　　接口地址：这个地址代表网络地址，即url，我们需要调用接口url来获取响应内容；

　　请求方式：常见的请求方式有GET和POST，其他方式如下图所示；

　　请求参数：用于传递信息的变量。即需要请求的字段名称的名称和规则：哪些字段都是，字段的类型是什么，是否需要字段等；

　　响应内容：接口返回的字段名和规则；

　　错误码：对接口的错误码进行分类，以便快速查找错误原因并解决问题；

　　示例：实际调用时响应的内容。

　　

　　这里需要重点掌握GET和POST请求方法！

　　3.2 个 GET 请求

　　GET 通常用于获取服务器端数据：

　　GET请求可以传递参数，一般的传递方式是URL传递参数，例如：

　　百度知道搜索地址：

　　搜索后地址：ct=17&pn=0&tn=ikaslist&rn=10&fr=wwwt&word=%E6%B5%8B%E8%AF%95

　　拆分网址：

　　/搜索

　　lm=0

　　&rn=10

　　&pn=0

　　&fr=搜索

　　&ie=gbk

　　&word=%BC%F2%B5%C0%D4%C6

　　网址解析：

　　（有些文档需要自己的域名+路径，有些文档会提供完整的接口地址，比如剑道云/钉钉）

　　参数名称值

　　流明

　　rn

　　10

　　PN

　　FR

　　搜索

　　IE

　　gbk

　　单词

　　%BC%F2%B5%C0%D4%C6

　　在GET请求中，参数/Params/Querys是以URL参数的形式传递的！

　　

　　注意在POSTMAN中可以直接使用URL传参，也可以在Params中填写KEY和VALUE，拼接（演示）会自动进行！

　　

　　3.3 POST 请求

　　POST 请求一般由 Url、Headers 和 Body 组成。如果在POST请求的接口文档中遇到Params/Querys，需要像GET请求一样使用URL参数来传递参数，而POST请求的接口文档中的参数一般参考Body！

　　使用 URL 传递参数的接口：

　　

　　接口地址

　　使用 Body 传递参数的接口：

　　

　　POST 请求有不同的请求格式：

　　

　　{"name":"ziv","password":"123"}

　　{"data_id":"5398d19a9318483922"}

　　text/plain（理解），纯文本格式，一般使用raw-Text；

　　name:ziv,password:123

　　

ziv

123

　　application/x-www-from-urlencoded（理解），将表单中的数据转换成键值对，用&分隔。

　　3.4 文档

　　以钉钉文档为例说明接口（GET方法）：

　　以阿里云API市场为例说明接口（POST方式）：点击查看