首页 文章 精选 留言 我的

精选列表

搜索[restful],共2454篇文章
优秀的个人博客,低调大师

gout v0.1.8 版本更新,go 更新的 http RESTful 客户端和 benchmark lib

地址 gitee:https://gitee.com/guonaihong github:https://github.com/guonaihong/gout 更新内容 * 新增全局设置超时函数。 全部特性 feature 支持设置 GET/PUT/DELETE/PATH/HEAD/OPTIONS 支持设置请求 http header(可传 struct,map,array,slice 等类型) 支持设置 URL query(可传 struct,map,array,slice,string 等类型) 支持设置 json 编码到请求 body 里面(可传struct, map, string, []byte 等类型) 支持设置 xml 编码到请求 body 里面(可传struct, string, []byte 等类型) 支持设置 yaml 编码到请求 body 里面(可传struct, map, string, []byte 等类型) 支持设置 form-data(可传 struct, map, array, slice 等类型) 支持设置 x-www-form-urlencoded(可传 struct,map,array,slice 等类型) 支持设置 io.Reader,uint/uint8/uint16...int/int8...string...[]byte...float32,float64 至请求 body 里面 支持解析响应body里面的json,xml,yaml至结构体里(BindJSON/BindXML/BindYAML) 支持解析响应body的内容至io.Writer, uint/uint8...int/int8...string...[]byte...float32,float64 支持解析响应header至结构体里 支持接口性能benchmark,可控制压测一定次数还是时间,可控制压测频率 支持retry-backoff,可以指定重试条件 支持发送裸http数据包 支持导出curl命令 传入自定义*http.Client 支持请求中间件(https://github.com/antlabs/gout-middleware) 等等更多

优秀的个人博客,低调大师

十分钟上线-基于函数计算开发 Restful web api & asp.net core web app

前言 这篇文章适合所有的 C# 开发新手、老鸟以及想准备学习开发 C# 的程序猿。.NET Core是一个开源通用的开发框架,支持跨平台, 阿里云函数计算推出了 dotnetcore2.1 runtime, 使用 C# 编写 serverless 函数, 详情见官方文档:C# 函数入口. 在官方文档描述中,我们获知阿里云函数计算可以很好支持 asp.net core 的 Applicaiton: ASP.NET Core Web API ASP.NET Core Web App ASP.NET Core Web App (Model-View-Controller) 在介绍 Serverless Web 开发新模式之前,我们先了解下将 C# WebApi/WebApp Serverless 化的好处: 无需采购和管理服务器等基础设施 弹性伸缩,

优秀的个人博客,低调大师

初级工程师和高级工程师对待一个Restful API的态度已经截然不同

你费了很大劲写了一个漂亮的 REST API,文档写得像诗一样。上线那天还挺有成就感的。然后你打开日志看了一眼: - 有个客户端每秒在刷 `/api/products` 五百次,整页整页地刮你的商品数据 - 另一个客户的 retry 机制写炸了——没有退避、没有抖动,超时就无限循环重试,把你的数据库负载翻了一倍,凌晨三点准时报警 你的账单肉眼可见地上涨,其他正常客户的响应时间跟着遭殃,然后一个竞争对手花了一个周末用 for 循环把你的产品目录克隆了一遍。 **初级工程师觉得 API 只要“能跑”就行。资深工程师深知能跑只是第一步:API 是给外界的共享资源,需要明确的规则——谁能访问、频率多高、超了怎么办。** --- ## 第一招:API Key 在网关层校验,不要在业务层 如果有人忘了在某个新接口里加鉴权,检查被遗漏了,那这个接口就敞开了。没人发现,直到某天出现在滥用报告里。 初级做法:在每个接口里自己检查 Key: ```go func GetProducts(c *gin.Context) { key := c.GetHeader("X-API-Key") if !validateKey(key) { c.JSON(401, gin.H{"error": "invalid key"}) return } // 业务逻辑... } ``` 资深做法:在一个中间件里校验一次,所有请求进来先过这道坎: ```go func APIAuth() gin.HandlerFunc { return func(c *gin.Context) { key := c.GetHeader("X-API-Key") if key == "" || !isValidKey(key) { c.AbortWithStatusJSON(401, gin.H{"error": "missing or invalid API key"}) return } c.Set("clientID", getClientID(key)) c.Next() } } // 路由注册的时候加上 r.Use(APIAuth()) ``` 这样做的好处: - 新加的接口天然受保护,不用依赖谁记得加 - 无效 Key 永远不会进入业务逻辑 - `clientID` 只查一次,后面直接用 --- ## 第二招:限流要基于共享存储,不能靠内存 在本地用 `sync.Map` 或 `ConcurrentHashMap` 做计数,本地跑没问题。一上生产,负载均衡后面三个实例,同一个客户的请求分散到三台机器上,每台都独立计数。你设的“每分钟 100 次”实际上变成了“300 次”,你还查不出为什么。 初级做法: ```go var counters = sync.Map{} func allow(clientID string) bool { val, _ := counters.LoadOrStore(clientID, 0) count := val.(int) if count >= 100 { return false } counters.Store(clientID, count+1) return true } ``` 资深做法:用 Redis,所有实例共享同一个计数器: ```go func tryConsume(clientID string) bool { key := "ratelimit:" + clientID count := redis.Incr(ctx, key).Val() if count == 1 { redis.Expire(ctx, key, 60*time.Second) } return count <= 100 } ``` 为什么有效: - Redis 的 `INCR` 是原子的,同一个毫秒内两个请求不会同时超限 - 所有实例看到的是同一个计数 - 只在第一个请求时设置过期时间,不会一直往后推 --- ## 第三招:把剩余额度告诉客户端,别让人瞎猜 限流最糟糕的体验是:客户端发着发着忽然收到 429,完全不知道还剩多少、什么时候重置。 初级做法:只返回一个“Rate limit exceeded”: ```go c.JSON(429, gin.H{"error": "too many requests"}) ``` 资深做法:每次响应都带上三个头: ```go func checkRateLimit(clientID string) (allowed bool, limit, remaining int64, resetSeconds int64) { key := "ratelimit:" + clientID count := redis.Incr(ctx, key).Val() if count == 1 { redis.Expire(ctx, key, 60*time.Second) } ttl := redis.TTL(ctx, key).Val() limit := 100 remaining := limit - count if remaining < 0 { remaining = 0 } return count <= limit, limit, remaining, int64(ttl.Seconds()) } // 在响应头里带上 c.Header("X-RateLimit-Limit", "100") c.Header("X-RateLimit-Remaining", fmt.Sprintf("%d", remaining)) c.Header("X-RateLimit-Reset", fmt.Sprintf("%d", resetSeconds)) ``` GitHub、Stripe、Twitter 都在用这套。客户端能看到自己还剩多少,会提前慢下来,而不是直接撞墙。 --- ## 第四招:API Key 不要明文存 用了 `uuid.New().String()` 生成 Key,然后明文存在数据库里。如果哪天数据库被拖了,所有客户的 Key 全暴露了,直接用。 初级做法:存明文: ```go type APIKey struct { ID string Key string // 明文! } ``` 资深做法:存哈希,只在生成时给客户端看一次: ```go import "crypto/sha256" func generateAPIKey() (raw string, hashed string) { raw = "sk_live_" + uuid.New().String() h := sha256.Sum256([]byte(raw)) return raw, hex.EncodeToString(h[:]) } func isValidKey(raw string) bool { h := sha256.Sum256([]byte(raw)) hashed := hex.EncodeToString(h[:]) // 查库里有没有这个哈希 return keyExists(hashed) } ``` 这样数据库泄露的话,攻击者拿到的是无用的哈希值,不是能用的 Key。 --- ## 拼在一起:一个完整的请求流程 ``` 请求进来 ↓ API Key 校验(缺 Key 或无 Key → 401) ↓ Scope 校验(Key 权限不够 → 403) ↓ 限流检查(超了 → 429,并带回剩余额度) ↓ 业务逻辑(正常返回) ``` 每一层返回的错误格式一致,客户端只需要处理一种错误结构。 --- **初级工程师觉得 API 就是一些接口,上线再说。资深工程师知道:API 一暴露到公网,就自动成为“攻击目标”——不是只有恶意攻击,还有自己写砸的 retry 逻辑也会造成伤害。** 现在加好防护,不是“过度设计”,是让自己不用半夜被叫醒。 下次你要暴露一个接口到公网时,先别急着写业务逻辑,把过滤层、限流层、可观测的头都装上。你的值班同事会感谢你的。

资源下载

更多资源
优质分享App

优质分享App

近一个月的开发和优化,本站点的第一个app全新上线。该app采用极致压缩,本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长,特征是大鼻子、头戴帽子、身穿背带裤,还留着胡子。与他的双胞胎兄弟路易基一起,长年担任任天堂的招牌角色。

Nacos

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Rocky Linux

Rocky Linux

Rocky Linux(中文名:洛基)是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版,作为CentOS稳定版停止维护后与RHEL(Red Hat Enterprise Linux)完全兼容的开源替代方案,由社区拥有并管理,支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性,采用模块化包装和SELinux安全架构,默认包含GNOME桌面环境及XFS文件系统,支持十年生命周期更新。

用户登录
用户注册