restful API设计

最新推荐文章于 2024-07-20 20:24:10 发布
最新推荐文章于 2024-07-20 20:24:10 发布
阅读量343 收藏
点赞数
分类专栏： 基础 文章标签： restful api
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/wenxueliu/article/details/83962182
版权

RESTful API 已经非常成熟，也得到了大家的认可。本文主要讲的是在工作中遇到的一个比较被认同的“规范”，总结下自己的经验。

按照 Richardson Maturity Mode 对 REST 评价的模型，规范基于level2来设计。

考虑的问题

  1. 认证
  2. 安全
  3. 缓存：ETag，IF-NO-MATCH
  4. 同步或者异步
  5. 一致性
  6. 扩展

URL

/version/{catalogy}/{entities}/{entity_id}/action

其中

  • version : API 版本, 如 v1, v2, v3, v1beta, latest, v2alpha 等
  • category : 某种分类, 如 configuration, manage 等高层资源
  • entities : 实体资源, 如 images, services, networks 等, 为复数
  • entity_id : 实体资源的 id
  • action : 表示对资源的某种行为, 具体的行为在 body 中指定.
  1. 以复数（名词）进行命名资源，不管返回单个或者多个资源。
  2. URL 中单词统一小写, 如果由多个单词组成以 “-” 分割

操作

用HTTP动词（方法）表示对资源的具体操作。常用的HTTP动词有：

  • GET：从服务器取出资源（一项或多项）。
  • POST：在服务器新建一个资源。
  • PUT：在服务器更新资源（客户端提供改变后的完整资源，全部更新）。
  • PATCH：在服务器更新资源（客户端提供改变的属性，部分更新）。
  • DELETE：从服务器删除资源。
  • HEAD：获取资源的元数据。
  • OPTIONS：获取信息，关于资源的哪些属性是客户端可以改变的。

例子

/v1/images/{image_id}/members/{member_id}
/v1/images/{image_id}/members

/v3/{project_id}/groups/{group_id}/action : 对资源进行状态修改

{
    "reset_status": {
        "status": "available"
    }
}

URL 查询参数

请求参数在 ? 之后以 key=value&key=value 形式存在

排序

  • sort_key=[key1,key2] : 根据某个属性进行排序, 排序根据自然属性排序
  • sort_dir=[inc|desc] : 排序方向, 顺序(inc)或倒序(desc), 默认 desc， 如/cars?sort=-manufactorer,+model

分页

  • limit=NUM: 限制每页的数量
  • offset=NUM: 列表的偏移值. 从列表开始, 与 limit 一起可以对长列表进行翻页
  • marker=ID : 上一页的最后一个元素的 id.
  • page_reverse : 上一页(true), 下一页(false)

例如 /cars?offset=10&limit=5

可选提供：1）可以在 HTTP 消息头中增加 X-Total-Count 表示总数。2）对前一页和后一页，首页、最后一页的链接。

过滤

  • fields=field : 只显示指定的 field, 如 fields=id&fields=name 或 time < 1000234, 显示 id 与 name

选择

  • fields=field1,field2：只显示特定的字段。 如 /cars?fields=manufacturer,model,id,color

范围

  • field=[begin, end]：指定 field 的范围为 beign 和 end 之间。比如 /cars?createAt=[2000-10-11, 2010-10-12]

基于以上参数提供 AND 的语义, 对于 OR 语义, 可选支持(客户端可以将多个操作合并, 间接实现 OR 语义)

limit=2&marker=1234&page_reverse=false

/v2.0/networks.json?limit=2&page_reverse=false HTTP/1.1

{
    "networks": [
        {
            "admin_state_up": true,
            "id": "396f12f8-521e-4b91-8e21-2e003500433a",
            "name": "net3",
            "provider:network_type": "vlan",
            "provider:physical_network": "physnet1",
            "provider:segmentation_id": 1002,
            "router:external": false,
            "shared": false,
            "status": "ACTIVE",
            "subnets": [],
            "tenant_id": "20bd52ff3e1b40039c312395b04683cf"
            "project_id": "20bd52ff3e1b40039c312395b04683cf"
        },
        {
            "admin_state_up": true,
            "id": "71c1e68c-171a-4aa2-aca5-50ea153a3718",
            "name": "net2",
            "provider:network_type": "vlan",
            "provider:physical_network": "physnet1",
            "provider:segmentation_id": 1001,
            "router:external": false,
            "shared": false,
            "status": "ACTIVE",
            "subnets": [],
            "tenant_id": "20bd52ff3e1b40039c312395b04683cf"
            "project_id": "20bd52ff3e1b40039c312395b04683cf"
        }
    ],
    "networks_links": [
        {
            "href": "http://127.0.0.1:9696/v2.0/networks.json?limit=2&marker=71c1e68c-171a-4aa2-aca5-50ea153a3718",
            "rel": "next"
        },
        {
            "href": "http://127.0.0.1:9696/v2.0/networks.json?limit=2&marker=396f12f8-521e-4b91-8e21-2e003500433a&page_reverse=True",
            "rel": "previous"
        }
    ]
}

其中 networks_links 中指明下一页的链接, 上一页的链接. 最后一页没有 next 链接,
第一页没有 previous 链接

URL 范例

GET / : 列出所有版本

{
    "versions": [
        {
            "status": "CURRENT",
            "updated": "2012-01-04T11:33:21Z",
            "id": "v1.0",
            "links": [
                {
                    "href": "http://23.253.228.211:8776/v1/",
                    "rel": "self"
                }
            ]
        },
        {
            "status": "CURRENT",
            "updated": "2012-11-21T11:33:21Z",
            "id": "v2.0",
            "links": [
                {
                    "href": "http://23.253.228.211:8776/v2/",
                    "rel": "self"
                }
            ]
        }
    ]
}

其中 updated 是可选的

GET /v3 : 列出 v3 信息

{
    "version": {
        "id": "v3.4",
        "links": [
            {
                "href": "http://localhost:35357/v3/",
                "rel": "self"
            }
        ],
        "media-types": [
            {
                "base": "application/json",
                "type": "application/vnd.openstack.identity-v3+json"
            }
        ],
        "status": "stable",
        "updated": "2015-03-30T00:00:00Z"
    }
}

应答

应答体中应该但不仅限于如下字段

  • id string : UUID
  • self string : 当前资源的 url 路径
  • name string : 名称
  • description string : 对该资源的描述
  • status string : 资源的状态
  • created_at string : 资源上次更新时间, 格式参考如下
  • updated_at string : 资源创建时间, 格式 IOS8601 即 CCYY-MM-DDThh:mm:ss±hh:mm
  • schema string : 建议该 json 文档的 schema
  • fail_reason string : 失败原因
  • links array :

时间格式

格式为 IOS8601
即 CCYY-MM-DDThh:mm:ss±hh:mm, 例如 2015-08-27T09:49:58-05:00.
如果包含 ±hh:mm 表示相对 UTC 的偏移

注:

应答体 key 中单词统一为小写, 如果是多个单词组成, 以 “_” 分割. 如 created_at, updated_at 等
应答体 value 中单词统一为小写, 如果是多个单词组成, 以 “-” 分割.

对应 POST 创建资源, 返回体中必须包含资源的 id

例子

GET /v2/images

{
    "images": [
        {
            "status": "active",
            "name": "cirros-0.3.2-x86_64-disk",
            "created_at": "2014-11-07T17:07:06Z",
            "updated_at": "2014-11-07T17:19:09Z",
            "visibility": "public",
            "self": "/v2/images/1bea47ed-f6a9-463b-b423-14b9cca9ad27",
            "id": "1bea47ed-f6a9-463b-b423-14b9cca9ad27",
            "schema": "/v2/schemas/image"
        },
        {
            "status": "active",
            "name": "F17-x86_64-cfntools",
            "created_at": "2014-10-30T08:23:39Z",
            "updated_at": "2014-11-03T16:40:10Z",
            "visibility": "public",
            "self": "/v2/images/781b3762-9469-4cec-b58d-3349e5de4e9c",
            "id": "781b3762-9469-4cec-b58d-3349e5de4e9c",
            "schema": "/v2/schemas/image"
        }
    ],
    "schema": "/v2/schemas/images",
    "first": "/v2/images"
}

GET /v2/images/{image_id}

{
    "image": {
        "checksum": "eb9139e4942121f22bbc2afc0400b2a4",
        "container_format": "bare",
        "created_at": "2016-03-15T15:09:07.000000",
        "deleted": false,
        "deleted_at": null,
        "disk_format": "vmdk",
        "id": "1086fa65-8c63-4081-9a0a-ddf7e88e485b",
        "is_public": false,
        "min_disk": 22,
        "min_ram": 11,
        "name": "Silas Marner",
        "owner": "c60b1d57c5034e0d86902aedf8c49be0",
        "properties": {
            "foo": "bar",
            "qe_status": "approved"
        },
        "protected": false,
        "size": 25165824,
        "status": "active",
        "updated_at": "2016-05-10T21:14:04.000000",
        "virtual_size": null
    }
}

注: images 的 value 为数组, 而不是直接数组

同步或异步

同步接口

  1. 返回 201 Created
  2. 返回 Location 头指向创建的资源位置
  3. 返回创建的资源

异步接口

  1. 返回 202 Accepted
  2. 如果能确定资源位置，Location 头指向创建资源 ；如果不能确定资源位置，提供一个可用查看异步资源的操作

批量操作

与单个接口不同之处 1. 仅仅指定多个对象; 2. 要不全部成功, 要不全部失败

HTTP 状态码

GET 获取资源 正常返回 200
DELETE 删除资源 正常返回 204
POST 创建资源 正常返回 202 （异步接口）201（同步接口）

401 Unauthorized : 没有认证
403 Forbidden : 没有权限进行操作
404 Not Found : 没有找到对应的 URL 或资源
405 : 不支持该操作
409 Conflict : 冲突

500 Internal server error
503 Service unavailable

API 文档要求

  1. URL
  2. 可能的 URL 参数
  3. 请求 body
  4. 应答 body
  5. 正常返回状态, 错误返回状态
  6. 例子, 包括正常, 异常

多对象之间关联

通过 id 相互关联

GET /v2.0/fw/firewall_rules/{firewall_rule_id}

{
    "firewall_rule": {
        "action": "allow",
        "description": "",
        "destination_ip_address": null,
        "destination_port": "80",
        "enabled": true,
        "firewall_policy_id": null,
        "id": "8722e0e0-9cc9-4490-9660-8c9a5732fbb0",
        "ip_version": 4,
        "name": "ALLOW_HTTP",
        "position": null,
        "protocol": "tcp",
        "shared": false,
        "source_ip_address": null,
        "source_port": null,
        "project_id": "45977fa2dbd7482098dd68d0d8970117",
        "tenant_id": "45977fa2dbd7482098dd68d0d8970117"
    }
}

参考

https://developer.openstack.org/api-ref/block-storage/v3/index.html?expanded=list-backups-with-detail-detail
https://docs.atlassian.com/jira/REST/cloud/#api/2/worklog-getWorklogsForIds
http://json-schema.org/latest/json-schema-hypermedia.html

附录

命名参考

请求体或应答体常用字段

size : 表示大小
count : 表示数量
status : 表示状态, 状态变化 creating, available, in-use, deleting, error(error when create), error_deleting
type : 表示类型
xx_type : 表示某个资源的类型
is_xxx: 对二义性资源的描述, 比如 is_public, is_active
percentage : 百分比
xx_items : 列表资源
xx_ips : 多个资源时, 名字加 “s”
xxx_bytes : 表示某个对象或资源大小, 建议增加单位
metadata : 元数据
xxx_format : 格式
visibility : public, private, shared, or community
expires_at : 过期时间, 参考 created_at
xxx_properties : 属性列表
admin_state_up : 管理状态 true, false
enabled : 某条规则生效 true, false
min_xxxx : 最小
max_xxxx : 最大

对应二义性的一定要用 true, false 而不是 1, 0

status :

active, deactived;
pending, accepted, rejected;
pending, processing, success, failure
active, down, build, error

Neturon 元素

network
subnet
port
segment
trunk : subport -> segment
floatingip : subnet, port
route : 1. 多个 subnet 之间通过路由打通; 2. 通过 NAT 访问外边网络;
subnets
subnetpools
fw : 防火墙

例子

认证

接口应该至少提供基本认知.

GET /v3/auth/tokens

X-Auth-Token : TOKEN_ID

或

GET /v3/auth/token=TOKEN_ID

{
    "token": {
        "expires_at": "2013-02-27T18:30:59.999999Z",
        "issued_at": "2013-02-27T16:30:59.999999Z",
        "methods": [
            "password"
        ],
        "user": {
            "domain": {
                "id": "1789d1",
                "links": {
                    "self": "http://identity:35357/v3/domains/1789d1"
                },
                "name": "example.com"
            },
            "id": "0ca8f6",
            "links": {
                "self": "http://identity:35357/v3/users/0ca8f6"
            },
            "name": "Joe"
        }
    }
}

POST 请求

POST /v3/services

{
    "service": {
        "type": "volume"
    }
}

{
    "service": {
        "enabled": true,
        "id": "686766",
        "links": {
            "self": "http://identity:5000/v3/services/686766"
        },
        "type": "volume"
    }
}

POST /v3/endpoints

{
    "endpoint": {
        "interface": "public",
        "name": "name",
        "region_id": "north",
        "url": "http://identity:35357/v3/endpoints/828384",
        "service_id": "686766"
    }
}

{
    "endpoint": {
        "id": "828384",
        "interface": "internal",
        "links": {
            "self": "http://identity:35357/v3/endpoints/828384"
        },
        "name": "the internal volume endpoint",
        "region_id": "north",
        "service_id": "686766",
        "url": "http://identity:35357/v3/endpoints/828384"
    }
}

返回的资源在 links 中

POST /v2.1/{tenant_id}/servers

{
    "server": {
        "name": "new-server-test",
        "imageRef": "http://openstack.example.com/openstack/images/70a599e0-31e7-49b7-b260-868f441e862b",
        "flavorRef": "http://openstack.example.com/openstack/flavors/1",
        "metadata": {
            "My Server Name": "Apache1"
        },
        "min_count": "2",
        "max_count": "3"
    }
}

{
    "server": {
        "adminPass": "wfksH3GTTseP",
        "id": "440cf918-3ee0-4143-b289-f63e1d2000e6",
        "links": [
            {
                "href": "http://openstack.example.com/v2.1/servers/440cf918-3ee0-4143-b289-f63e1d2000e6",
                "rel": "self"
            },
            {
                "href": "http://openstack.example.com/servers/440cf918-3ee0-4143-b289-f63e1d2000e6",
                "rel": "bookmark"
            }
        ]
    }
}

返回的资源在 links 中的另外一种形式

附录

错误消息
{
  "errors": [
    {
      "request_id": "1dc92f06-8ede-4fb4-8921-b507601fb59d",
      "code": "orchestration.create-failed",
      "status": 418,
      "title": "The Stack could not be created",
      "detail": "The Stack could not be created because of error(s) in other parts of the system.",
      "links": [
        {
          "rel": "help",
          "href": "TODO(sdague): example href"
        }
      ]
    },
    {
      "request_id": "d413ea12-dfcd-4009-8fad-229b475709f2",
      "code": "compute.scheduler.no-valid-host-found",
      "status": 403,
      "title": "No valid host found",
      "detail": "No valid host found for flavor m1.xlarge.",
      "links": [
        {
          "rel": "help",
          "href": "TODO(sdague): example href"
        }
      ]
    }
  ]
}
  1. code：用来表示某类错误，比如缺少参数等。是对HTTP Header Code的补充，开发团队可以根据自己的需要自己定义。
  2. message：错误信息的摘要，应该是对用户处理错误有用的信息。
  3. request_id：请求的id，方便开发定位发生错误的请求（可选）。
  4. host_id：服务器实例的ID，方便开发定位是哪台服务器实例发生了错误（可选）。
  5. server_time：发生错误时候的服务器时间（可选）。
  6. document：错误解决的文档（方便前端展示，可选）。
  7. 格式错误返回 400 Bad Request
  8. 请求 body 中包含请求的资源，如果不存在返回 400 Bad Request
  9. 请求 body 中包含了不期望的属性，返回 400 Bad Request
  10. 请求 query 中包含了不存在属性，返回 400 Bad Request
  11. 请求不支持的方法，在返回的 405 Method Not Allowed，增加消息头 Allow 指出支持的 HTTP 方法
HATEOAS

以超链接作为应用状态的引擎（Hypermedia as the Engine of Application State ）为原则，用超链接作为 API 的导航

{
  "id": 711,
  "manufacturer": "bmw",
  "model": "X5",
  "seats": 5,
  "drivers": [
   {
    "id": "23",
    "name": "Stefan Jauker",
    "links": [
     {
     "rel": "self",
     "href": "/api/v1/drivers/23"
    }
   ]
  }
 ]
什么时候需要新的 API 版本
  1. 新增接口
  2. 数据类型改变
  3. 存在接口增加新的 HTTP方法
  4. 数据类型增加新的字段
坏习惯的叛逆者
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Restful API 设计
Mongoose House
06-07 806
REST（Representational State Transfer） 是 Roy Fielding 博士在2000年他的博士论文「Architectural Styles and the Design of Network-based Software Architectures(PDF)」中提出来的一种软件架构风格。REST 服务与早前 Web Service 的 SOAP 和 XML-RPC 协议对比来讲更加简洁，现在越来越多的 Web 服务开始采用 REST 风格设计和实现。 Restful
如何设计出优秀的Restful API？
架构师小秘圈
08-29 839
1 你一直在错误的使用http协议现在微服务真是火的一塌糊涂！大街小巷，逢人必谈微服务，各路大神纷纷忙着把自家的单体服务拆解成多个Web微小服务！而作为微服务之间通信的桥...
RESTful API设计之道-RESTful API介绍及使用方法
hpx666的博客
06-01 117
RESTful API设计之道
RESTful API设计
Just Do It
07-02 736
一、RESTful API简介 1.1 RESTfulAPI是什么 RESTful API全称是Resource Representational State Transfer(资源表述性状态转移)。 R：Resource 资源。例如：user、role、gist、issue、service、route E：Representational 表述性。数据的表现形式，例如：JSON、XML、CSV、IMG等 S：State 状态。资源的状态，例如：创建、更新等状态 T：Transfer 转移.
RESTful API 设计
silence_xiao的博客
08-02 511
今天，我将介绍RESTful API的设计细节，探讨如何设计一套合理、好用的API。我的主要参考了两篇文章（1，2）。 一、协议 API与用户的通信协议，总是使用HTTPs协议。 二、域名 应该尽量将API部署在专用域名之下。     https://api.example.com   如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下。  ...
restful api 设计
iteye_19879的博客
08-11 143
API应该对程序员友好，并且在浏览器地址栏容易输入。 API应该简单，直观，容易使用的同时优雅。 API应该具有足够的灵活性来支持上层ui。 一旦定义好了要暴露的资源，你可以定义资源上允许的操作，以及这些操作和你的API的对应关系： GET /tickets # 获取ticket列表 GET /tickets/12 # 查看某个具体的ticket POST /tickets #...
restful api设计
03-10
RESTful API 设计 RESTful API 设计是一种架构风格，而不是严格的标准，它有很大的灵活性。它描述了一个架构样式的网络系统，RESTful 架构将服务器成前端服务器和后端服务器两部分，前端服务器为用户提供无模型的...
RESTful API设计规范
03-15
### RESTful API设计规范详解 #### 一、RESTful简介 RESTful是一种广泛应用于Web服务的设计风格，全称为Representational State Transfer（表述性状态转移）。它并非一项具体的技术标准，而是一系列设计原则和约束...
RESTful API 设计最佳实践
03-20
以下是对RESTful API设计核心概念的详细解释： 1. **资源**：在RESTful API中，资源是系统中的核心实体，例如“tickets”或“messages”。资源通过唯一的URI（统一资源标识符）进行定位，使得客户端可以通过HTTP...
理解 RESTful 风格的 API(转鲁斯菲尔)
qq_43510643的博客
11-19 617
# 理解 RESTful 风格的 API # 概述 2000 年，Roy Thomas Fielding 博士在他那篇著名的博士论文《Architectural Styles and the Design of Network-based Software Architectures》中提出了几种软件应用的架构风格，REST 作为其中的一种架构风格在这篇论文的第5章中进行了概括性的介绍。 REST 是“REpresentational State Transfer”的缩写，可以翻译成“表现状态转换”，但是
RESTful 风格 api 设计
panzina的博客
03-30 255
一、什么是RESTful? 是目前流行的api设计规范，用于web数据接口的设计 REST全称为：Representational state transfer 表述性状态转移。表述性就是指客户端请求一个资源，服务器拿到这个资源，就是表述。 二、为什么会出现RESTful呢？ 在RESTful之前的操作： http://127.0.0.1/user/query/1 GET 根据...
restful api接口设计
zhouzuoluo的博客
01-26 807
技术由来： 互联网早期，页面请求和并发量不高，且移动端未盛行时对接口要求不高，使用动态页面(jsp)就能满足绝大多数的使用需求。但是随着互联网和移动设备的发展，人们对Web应用的使用需求也增加，传统的动态页面由于低效率而渐渐被HTML+JavaScript(Ajax)的前后端分离所取代，并且安卓、IOS、小程序等形式客户端层出不穷，客户端的种类出现多元化，而客户端和服务端就需要接口进行通信，但接口的规范性就又成了一个问题： 所以一套结构清晰、符合标准、易于理解、扩展方便让大部分人都能够理解接受的接口
什么是RESTful API？
田兴的博客
10-10 1348
面试官：了解RESTful吗？ 我：听说过。 面试官：那什么是RESTful？ 我：就是用起来很规范，挺好的 面试官：是RESTful挺好的，还是自我感觉挺好的 我：都挺好的。 面试官：… 把门关上。 我：… 要干嘛？先关上再说。 面试官：我说出去把门关上。 我：what ？，夺门而去.... 前言 网络应用程序，分为前端和后端两个部分。当前的发展趋势，就是前端设备层出不穷（手机、平板、桌面电脑、其他专用设备…）。 因此，必须有一种统一的机制，方便不同的前端设备与后端进行通信。这导
API接口的RESTful设计
何哥的博客
03-26 2707
前言：在移动互联网、分布式和微服务盛行的今天，现在好多大点的项目都会采用的微服务框架，前后端分离方式。前后端的工作职责越来越明确，现在的前端都称之为大前端，技术栈以及生态圈都已经非常成熟，可以进行移动端跨平台开发，也可以通过node.js写服务端的Controller。 一般系统的大致整体架构图如下： 需要说明的是，这个架构也太简单了吧，什么网关、Redis缓存、MQ消息中间件都没有。因为这篇主要介绍的是API接口，所以我们聚焦点，其他的模块小伙伴们自行去补充。 1、前后端接口交互 前端和后端进
RESTful API设计指南：构建高效、可扩展和易用的API
最新发布
weixin_73588491的博客
07-20 3523
RESTful API（Representational State Transfer API），中文翻译过来可以表述为表述性状态转移，是一种基于HTTP协议的网络应用程序接口风格。它遵循REST架构风格的约束条件和原则，以资源为中心，使用标准的HTTP方法（如GET、POST、PUT、DELETE等）来执行操作。RESTful API强调简单性、可扩展性和可读性，使得不同系统之间的通信变得更加直观和高效。设计高质量的 RESTful API 是一个持续的过程。
RESTful API 接口设计指南
流华追梦的专栏
11-30 1612
网络应用程序，分为前端和后端两个部分。当前的发展趋势，就是前端设备层出不穷（手机、平板、桌面电脑、其他终端设备等）。因此，必须有一种统一的机制，方便不同的前端设备与后端进行通信。这导致API构架的流行，甚至出现“API First”的设计思想。RESTful API 是目前比较成熟的一套互联网应用程序的 API 设计理论。
RESTful API及其设计思想
Null的博客
11-02 1918
要弄清楚什么是RESTful API,首先要弄清楚什么是REST。REST -- REpresentational State Transfer，英语的直译就是“表现层状态转移”。如果看这个概念，估计没几个人能明白是什么意思。那下面就让我来用一句人话解释一下什么是RESTful:URL定位资源，用HTTP动词（GET,POST,PUT,DELETE)描述操作。      Resource：资源，...
RESTful API 设计最佳实践：打造高性能接口
LiamHong_的博客
06-04 897
根据 REST 的说法，DELETE 应该是幂等的——如果你一次删除一个资源，然后再次调用 DELETE 该资源，它不应改变任何东西。当你过度抓取时，你的调用导致的数据传输比必要的更大，这是带宽浪费。你应该始终寻找简化实现的方法。有时，用一个特殊的 HTTP 头来控制你的 API 的响应格式可能是一个比构建另一个 API 并称之为 v2 更简洁的解决方案。此外，由于缓存是 HTTP 规范的一部分，很多参与 HTTP 的东西都会知道如何缓存东西：浏览器，它们天生支持缓存，以及你和客户端之间的其他中间服务器。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值