web应用模式 api接口 接口测试工具postman restful规范
web应用模式
# 前后端混合开发
-bbs项目,页面渲染是在后台完成--->render(request,'index.html')
-后端人员---》写前端css,js,html
# 前后端分离开发---》主流---》前端发展出一些框架(vue,react)
-js的dom操作---》html页面--》通过js在页面中插入内容
-bom和dom
-不用模板语法渲染页面了----》在前 端使用js渲染页面
-页面渲染在前端完成
-以后前端人员只负责写前端
-后端人员只负责写后端
-前端的展现形式---》不一定只是网页,可能是app,小程序
前后端混合开发
传统的开发模式:
页面的渲染通过模板语法(dtl) 渲染是在后端完成:
render(request,'index.html')
-后端人员 ---> 写前端css,js,html
放在django template下的这些html页面 不能称之为纯粹的html 而是称之为模板。后端将数据填充到这些模板中,将模板进行渲染,渲染后的模板也就是纯的html。
选择模板语法:
补充:flask使用的是jinja2模板语法。
流程说明(重要)
!
# 浏览器向服务器发送http请求
1. 浏览器向某个地址(例如:127.0.0.1:8080)发送http请求
2. 发送到这个地址的某个服务器
3. 发送到服务器上的某个端口(例如:8080)
# django后端接受数据
1. django监听本地的8080(发送的数据被django服务端处理)
2. 经过uwsgi、django中间件
3. 前端提交数据,后端拿到数据
4. 通过数据,查询数据库
5. 取出模板,把数据渲染到模板上(渲染前模板上有模板语法)
6. 将模板语法替换成数据,将模板变成纯粹的html(只包含html、js、css)
# 返回http响应
1. 通过http响应,将纯粹的html返回给前端
2. 浏览器获取到的是一个数据包,这个数据包里是纯粹的html
3. 浏览器可以识别html、css、js(浏览器内部内嵌js解释器)
'''
总结:模板渲染是在后端完成的
缺点:后端的压力比较大。每次有请求来到后端都得渲染页面。(静态页面)
'''
前后端分离开发
一开始流行的是前后端结合的开发方式。
后来因为前端的发展,催生了前端框架,前端变得越来越复杂。
导致前后端分离开发变成主流。
流程说明(重要)
# 浏览器向服务器发送请求(8080端口)
1. 浏览器向某个地址发送请求(8080端口)
2. 静态文件服务器把index.html交给浏览器
(此页面没有数据库中的数据,相当于是个空页面,写了js代码、html、css)
3. 当index.html在浏览器加载完成
4. 立马发送ajax请求给django后端(8888端口)
# django后端(8888端口)
1. django后端监听8888端口
2. 通过orm获取queryset对象
3. 将queryset对象转换成json格式字符串(序列化)
4. 将json字符串返回给浏览器
# 浏览器
1. 浏览器将json字符串转换成js能识别的变量
2. 进行dom操作(dom操作可以在页面的某个地方进行插入数据、删除数据)
'''
总结:页面渲染在前端完成。在前端使用Javascript代码渲染页面。
注意:静态文件服务器和django后端的端口是不同的。
'''
前后端分离的好处:
前端的展现形式,不一定只是网页了。
前端可能是写app、小程序, 后端只需要提供接口就行了。
前后端混合开发时,前端只能是浏览器。
更多阅读:
https://www.cnblogs.com/liuqingzheng/p/10900502.html
api接口
# api接口规范
为了在团队内部形成共识、防止个人习惯差异引起的混乱,我们需要找到一种大家都觉得很好的接口实现规范。
而且这种规范能够让后端写的接口,用途一目了然,减少【前后端】之间的合作成本
# 定义
api接口就是前后端交互的媒介。
通过网络,规定了前后台信息交互规则的url链接,也就是前后台信息交互的媒介。
http://127.0.0.1/books/
# 接口有的东西
-url地址:https://api.map.baidu.com/place/v2/search
-请求方式:get,post,delete,put...
-请求参数:json格式的key-value类型数据
-ak:6E823f587c95f0148c19993539b99295
-region:上海
-query:肯德基
-output:json
get请求--->127.0.0.1/books?name='西游记' 参数:name='西游记'
-早些年 前后端交互使用xml格式 ----> ajax:异步JavaScript和XML
-后来,随着json格式的出现,成了主流,直到现在
-以后:一定会出现,比json更高效的交互格式,更安全
-响应结果:json格式的数据
-上方请求参数的output参数值决定了响应数据的格式
-数据
http响应-->响应状态码-->响应头--->响应体(json)
# api接口案例
-https://api.map.baidu.com/place/v2/search?ak=6E823f587c95f0148c19993539b99295®ion=上海&query=肯德基&output=xml
-https://api.map.baidu.com/place/v2/search?ak=6E823f587c95f0148c19993539b99295®ion=上海&query=肯德基&output=json
'''总结:其实就是一个http地址'''
前端和后端数据交互 需要遵循一些规范。
前端向后端拿数据的地方:api接口
api接口长什么样?
这个url地址就称之为api接口。
接口测试工具postman
-浏览器只能 发送get请求,不能自动发送post,delete请求
# 接口测试工具
-postman---》开源软件,只是谷歌浏览器的插件,越做好好,后来可以按装到操作系统上,再后来,收费
-postwoman
-很多很多其他的,不同公司用的也可能不一样,你只需要明白一个点,这个工具只是用来发送http请求
# postman的使用
-1 官方下载:https://www.postman.com/downloads/?utm_source=postman-home----》Postman-win64-Setup.exe
-2 按照,双击即可
基本介绍
选择不同的编码格式:
fromdata编码格式既可以发送数据、也可以发送文件:
查看响应:
postman和浏览器的区别:
把请求归类到项目中:
编码格式
前后端交互的编码格式有哪几种?
-urlencoded:正常的post请求提交数据:在请求体中的格式:name=lqz&age=19
-formdata:post请求上传文件:带文件二进制形式
-json:body体(请求体)中的数据格式为:{"name":"lqz","age":19}--》用的多
相关阅读:
https://blog.csdn.net/qq_52385631/article/details/122821865#comments_24932322
restful规范(重要)
简介
# 什么是restful规范?
1. 前后端交互使用api接口
2. api接口符合某种规范
3. 这种规范称之为restful规范
4. 这种规范是写前后端分离项目的标准
# REST的含义
REST全称是:Representational State Transfer
中文意思是表述(编者注:通常译为表征性状态转移)。
它首次出现在2000年Roy Fielding的博士论文中。
# restful规范的定义
RESTful是一种定义Web API接口的设计风格(方案),
尤其适用于前后端分离的应用模式中
主要内容
使用https协议
数据的安全保障,通常使用https(http+ssl/tsl)协议- url链接一般都采用https协议进行传输
- 采用https协议,可以提高数据交互过程中的安全性
用api关键字标识接口
在接口中带api字眼 --> 让别人一看就知道这是个api接口 # 示例:
https://api.baidu.com/books
https://127.0.0.1:8080/api/books
接口多版本共存
# 示例
老版本的登录需要提供三个数据:用户名 密码 验证码
新版本的登录只需要两个数据:手机号 短信验证码 -有的人用了老版本app--》老接口v1 三个参数
-有的人用了新版本app--》新接口v2 两个参数 # 登录接口是都留着还是只留下一个?
肯定是都留,保证支持老版本的app。
通过在接口地址中加版本号区分接口。 -https://api.baidu.com/v1/login 老版本的登录接口
-https://api.baidu.com/v2/login 新版本的登录接口微博api示例:
https://api.weibo.com/2/account/get_uid.json
这里的2就是接口的版本。数据即是资源
接口一般都是完成前后台数据的交互,交互的数据我们称之为资源 # 注意事项
1. 数据即是资源,均使用名词(可复数)。
2. 请求地址中尽量不出现动词。 # 一个用户数据接口的例子:
https://api.baidu.com/v1/users # 特殊的接口可以出现动词:
因为这些接口一般没有一个明确的资源,或是动词就是接口的核心含义。
https://api.baidu.com/login
操作资源由请求方式决定
操作资源一般都会涉及到增删改查,我们提供请求方式来标识增删改查动作 -get请求是获取数据
-post请求是新增数据
-delete请求是删除数据
-put请求是修改数据
-patch请求是局部修改数据 # 实例
https://api.baidu.com/books - get请求:获取所有书
https://api.baidu.com/books/1 - get请求:获取主键为1的书
https://api.baidu.com/books - post请求:新增一本书书
https://api.baidu.com/books/1 - put请求:修改主键为1的书
https://api.baidu.com/books/1 - delete请求:删除主键为1的书 '''
想要获取用户 就往用户接口 发送get请求
想要删除用户 就往用户接口 发送delete请求 不同的请求有不同的含义。
'''
请求地址中带过滤条件
-https://api.example.com/v1/zoos?limit=10 # 返回10条数据
-https://api.example.com/v1/books?name=西游记 # 查询名字是西游记的这本书
响应状态码
后端返回给前端的json数据中应该携带响应状态码。# 1.http的响应状态码
-1xx:请求正在处理
-2xx:请求成功(200,201)
-3xx:重定向 (301和302有什么区别)
-4xx:客户端错误(404:地址不存在,403:禁止了)
-5xx:服务端错误 200和201有什么区别?
201 ( created )状态代码指示请求已完成,并导致创建了一个或多个新资源。
由请求创建的主资源由响应中的Location标头字段标识。
或者,如果没有接收到Location字段,则由有效的请求URI标识。 301和302有什么区别?
301:永久移动。
请求的资源已被永久的移动到新URL,返回信息会包括新的URL,浏览器会自动定向到新URL。
今后任何新的请求都应使用新的URL代替。
302:临时移动。
与301类似。但资源只是临时被移动,客户端应继续使用原有URL # 2.自定义状态码
响应体中返回json格式数据:code,status 自定义状态码是程序员自己定义的,也会通过json数据,放在响应体中,返回给前端。
{code:0} 一般使用100 101 102这种
自定义状态码在接口文档会列出来:
-1001 :用户名错误
-1002 :没有权限
错误提示信息
-返回数据是json格式--》带状态码---》错误信息
{
error: "无权限操作"
}
每个状态码应该写一段提示信息,一起返回给前端。
请求失败,应返回错误提示信息;
请求成功,也要返回成功的信息。返回的数据格式规范
返回的数据格式符合如下规范:(大部分公司不按照这个规范,而是自定义)
# 对于不同的请求,返回的数据格式不同: -多条数据返回列表
GET /collection:返回资源对象的列表
[{name:lqz,age:19},{name:pyy,age:33}] -单条数据返回字典
GET /collection/resource:返回单个资源对象
{name:lqz,age:19} -新增,返回新增的对象
POST /collection:返回新生成的资源对象
{name:lqz,age:19} -修改,返回修改后的对象
PUT /collection/resource:返回完整的资源对象
{name:lqz,age:19} -修改,返回修改后的对象
PATCH /collection/resource:返回完整的资源对象
{name:lqz,age:19} -删除,返回空文档
DELETE /collection/resource:返回一个空文档 '''
一般公司不会返回空文档,而会这么写:
{code:100,msg:删除成功}
'''
返回资源中带有链接地址
返回结果中提供链接,连向其他api方法。# 示例:
{
"id": 1404376560,
"description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。",
"url": "http://blog.sina.com.cn/zaku",
"profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1",
"domain": "zaku",
}
状态码201:
更多阅读:https://cloud.tencent.com/developer/ask/sof/81710
练习
1 postman安装使用,整理resful规范
2 把drf安装上,写出5个接口
3 面试题: http协议版本,你聊聊?
0.9 1.1 2.0
4 http状态码
web应用模式 api接口 接口测试工具postman restful规范的更多相关文章
- API接口管理工具postman等
国外 postman Swagger:国外比较流行的一款管理工具,英文配置,需要一定的英文基础和服务器搭建基础,学习成本较高. 国内 Apizza: 风格类似postman,熟悉postman的会比较 ...
- web应用开发模式、API接口、接口测试工具postman
web应用开发模式.API接口.接口测试工具postman web开发模式 前后端混合开发模式 前后端混合开发模式是指前后端代码混合,所有的HTML代码和数据在服务器端拼接好,一次性将内容发送到客户端 ...
- drf-day1——web应用模式、API接口、接口测试工具postman
目录 学习资料 一.web 应用模式 二.API接口 API概念 三.接口测试工具postman postman介绍 postman下载与使用 四.如何在浏览器中测试 学习资料 # 个人博客:http ...
- 数据接口测试工具 Postman 介绍
此文介绍好用的数据接口测试工具 Postman,能帮助您方便.快速.统一地管理项目中使用以及测试的数据接口. 1. Postman 简介 Postman 一款非常流行的 API 调试工具.其实,开发人 ...
- 接口测试工具postman/jmeter基本使用
一.接口的分类: 最常用的两种接口webservice接口和http api接口:1.webservice接口走soap协议通过http传输,请求报文和返回报文都是XML格式,现在测试的时候都通过工具 ...
- 接口测试工具POSTMAN的使用
接口测试工具postman python ------------------------------------ 作为后端,写好了接口,我们自己要测试通过,再给别人用 --------------- ...
- 接口测试工具---postman下载地址
接口测试工具---postman下载地址: https://app.getpostman.com/app/download/win64?_ga=2.3555895.622696496.15081214 ...
- 接口测试工具(Postman)
给大家介绍一款HTTP接口测试工具 -- Postman ! 优点: 1. 支持参数名与参数值自定义,无论head还是body 2. 支持多种方法调用,包含get与post 3. 支持鉴权加密,包含b ...
- 使用YApi搭建API接口管理工具(docker安装)
使用YApi搭建API接口管理工具(docker安装) 工具描述 YApi 是高效.易用.功能强大的 api 管理平台,旨在为开发.产品.测试人员提供更优雅的接口管理服务.可以帮助开发者轻松创建.发布 ...
- 后端API接口的错误信息返回规范
前言 最近我司要制定开发规范.在讨论接口返回的时候,后端的同事询问我们前端,错误信息的返回,前端有什么意见? 所以做了一些调研给到后端的同事做参考. 错误信息返回 在使用API时无可避免地会因为各种情 ...
随机推荐
- 深入理解JMeter中的JSON Extractor
Apache JMeter是一款出色的开源性能和功能测试工具,这款工具提供了丰富的功能和强大的扩展性,可以应对各种复杂的测试需求.当我们在进行接口测试时,经常会遇到需要从接口响应中提取信息并在后续请求 ...
- CVE-2017-7921 海康威视(Hikvision)摄像头漏洞复现
今天看到了海康威视又出了新漏洞--CVE-2021-36260,突然心血来潮想要复现一下,结果搜到了一个旧的漏洞--CVE-2017-7921,而且发现仍然有不少海康威视摄像头后台没有修补这个漏洞,于 ...
- jmeter-json断言
1.JSON 断言所在位置:断言->JSON 断言 2.JSON断言中的字段解析 Assert JSON Path exists:json 表达式,判断所字段是否存在,存在则为True, 否则为 ...
- Gson和fastJson应用场景
如果有性能上面的要求可以使用Gson将bean转换json确保数据的正确,使用FastJson将Json转换Bean 二.Google的Gson包的使用简介. Gson类:解析json的最基础的工 ...
- 用pycharm创建一个django框架
用pycharm创建一个django框架 注意解释器的选择和文件路径 创建完django项目 1.自动创建了一个templates目录(先删除) 2.把settings里的 TEMPLATES = [ ...
- [CF1599A] Weights
题目描述 You are given an array $ A $ of length $ N $ weights of masses $ A_1 $ , $ A_2 $ ... $ A_N $ . ...
- 【Buildroot】工具包使用
一.测试环境 开发板:rv1126 buildroot版本:2018.02-rc3 二..mk规则 PKG_NAME:定义软件包的名称.通常与软件包源代码的目录名相同. PKG_VERSION:定义软 ...
- 10、goto语句
1.goto语句的概念 goto语句:可以无条件的转移到运行中指定的行 这个用的比较少,了解一下即可 2.语法结构和用法 /** * @author ly (个人博客:https://www.cnbl ...
- Educational Codeforces Round 26 Problem A
A. Text Volume time limit per test 1 second memory limit per test 256 megabytes input standard input ...
- Qt+FFmpeg仿VLC接收RTSP流并播放
关键词:Qt FFmpeg C++ RTSP RTP VLC 内存泄漏 摘要认证 花屏 源码 UDP 本系列原文地址. 下载直接可运行的源码,在原文顶部. 效果 产生RTSP流 比播放文件复杂一点是, ...