网站系统开发团队简介,保险平台,代理网上注册公司,云南建网科技有限公司目录
一、web应用模式
【1】前后端混合开发
【2】前后端分离
二、API接口
三、接口测试工具#xff1a;Postman
四、RESTful API规范
【1】什么是RESTful
【2】RESTful API的规范
2.1 数据的安全保障
2.2 接口特征表现
2.3 多数据版本共存
2.4 数据即是资源#…目录
一、web应用模式
【1】前后端混合开发
【2】前后端分离
二、API接口
三、接口测试工具Postman
四、RESTful API规范
【1】什么是RESTful
【2】RESTful API的规范
2.1 数据的安全保障
2.2 接口特征表现
2.3 多数据版本共存
2.4 数据即是资源均使用名词可复数
2.5 资源操作由请求方式决定method
2.6 url中带搜索或过滤条件
2.7 响应状态码
2.8 返回中带错误信息
2.9 返回结果符合以下规范
2.10 返回数据中带url链接 一、web应用模式
【1】前后端混合开发
后端人员 既要写后端django又要写前端 【2】前后端分离
后端人员 只写后端写一个个的API接口前端人员 只写前端最后项目写完 前后端联调 二、API接口
为了在团队内部形成共识、防止个人习惯差异引起的混乱我们需要找到一种大家都觉得很好的接口实现规范而且这种规范能够让后端写的接口用途一目了然减少双方之间的合作成本。
通过网络规定了前后台信息交互规则的url链接也就是前后台信息交互的媒介。它称之为API接口。
前端
向后端发送请求获取数据127.0.0.1:8080/index ---返回数据
后端
请求某个地址返回固定的数据
Web API接口和一般的url链接还是有区别的Web API接口简单概括有下面四大特点 url长得像返回数据的url链接 https://api.map.baidu.com/place/v2/search 请求方式get、post、put、patch、delete 采用get方式请求上方接口 请求参数json或xml格式的key-value类型数据 ak6E823f587c95f0148c19993539b99295region上海query肯德基outputjson 响应结果json或xml格式的数据 上方请求参数的output参数值决定了响应数据的格式 三、接口测试工具Postman
Postman是一款接口调试工具是一款免费的可视化软件同时支持各种操作系统平台是测试接口的首选工具。
Postman可以直接从官网https://www.getpostman.com/downloads/下载获得然后进行傻瓜式安装。注需要注册一下使用或者一个Google账号也可
工作面板 简易的get请求 简易的post请求 案例请求百度地图接口 四、RESTful API规范
【1】什么是RESTful
REST全称是Representational State Transfer中文意思是表征性状态转移。 它首次出现在2000年Roy Fielding的博士论文中。
RESTful是一种定义Web API接口的设计风格尤其适用于前后端分离的应用模式中。
【2】RESTful API的规范
2.1 数据的安全保障 url链接一般都采用https协议进行传输 https是httpssl --- 安全的超文本传输协议 注采用https协议可以提高数据交互过程中的安全性 2.2 接口特征表现 在API地址中带接口标识我们一般放在地址栏中(放在域名中) https://api.baidu.comhttps://www.baidu.com/api注看到api字眼就代表该请求url链接是完成前后台数据交互的
2.3 多数据版本共存 在url链接中标识数据版本 https://api.baidu.com/v1https://api.baidu.com/v2注url链接中的v1、v2就是不同数据版本的体现只有在一种数据资源有多版本情况下
2.4 数据即是资源均使用名词可复数 接口一般都是完成前后台数据的交互交互的数据我们称之为资源 https://api.baidu.com/usershttps://api.baidu.com/bookshttps://api.baidu.com/book注资源名都是名词,尽量避免使用动词错误示范https://api.baidu.com/delete-user 特殊的接口可以出现动词因为这些接口一般没有一个明确的资源或是动词就是接口的核心含义 https://api.baidu.com/place/searchhttps://api.baidu.com/login
2.5 资源操作由请求方式决定method
操作资源一般都会涉及到增删改查我们提供请求方式来标识增删改查动作 获取资源用get新增资源用post修改资源使用put删除资源使用delete
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 - patch请求局部修改主键为1的书https://api.baidu.com/books/1 - delete请求删除主键为1的书
2.6 url中带搜索或过滤条件
https://api.example.com/v1/zoos?name猴子 get请求
2.7 响应状态码
2.7.1 正常响应 响应状态码2xx 200常规请求201创建成功2.7.2 重定向响应 响应状态码3xx 301永久重定向302暂时重定向2.7.3 客户端异常 响应状态码4xx 403请求无权限404请求路径不存在405请求方法不存在2.7.4 服务器异常 响应状态码5xx 500服务器异常
2.8 返回中带错误信息
{code:100,msg:成功}
Message: send success,
2.9 返回结果符合以下规范
GET /collection 返回资源对象的列表数组
GET /collection/resource 返回单个资源对象
POST /collection 返回新生成的资源对象
PUT /collection/resource 返回完整的资源对象
PATCH /collection/resource 返回完整的资源对象
DELETE /collection/resource返回一个空文档2.10 返回数据中带url链接
url: http://blog.sina.com.cn/zaku,
