Ratelimit
Enable ratelimit middleware.
Install#
go get github.com/rookie-ninja/rk-boot/v2
go get github.com/rookie-ninja/rk-gf
Option#
options | description | type | default |
---|---|---|---|
gf.middleware.rateLimit.enabled | Enable ratelimit middleware | boolean | false |
gf.middleware.rateLimit.ignore | Ignore by path | []string | [] |
gf.middleware.rateLimit.algorithm | leakyBucket is supported only | string | leakyBucket |
gf.middleware.rateLimit.reqPerSec | global limit | int | 1000000 |
gf.middleware.rateLimit.paths.path | API path | string | "" |
gf.middleware.rateLimit.paths.reqPerSec | limit value of path | int | 1000000 |
Quick start#
1.Create boot.yaml#
---
gf:
- name: greeter
port: 8080
enabled: true
middleware:
rateLimit:
enabled: true
paths:
- path: "/v1/greeter"
reqPerSec: 0
# algorithm: "leakyBucket"
# reqPerSec: 100
2.Create main.go#
package main
import (
"context"
"fmt"
"github.com/gogf/gf/v2/net/ghttp"
"github.com/rookie-ninja/rk-boot/v2"
"github.com/rookie-ninja/rk-gf/boot"
"net/http"
)
func main() {
// Create a new boot instance.
boot := rkboot.NewBoot()
// Register handler
entry := rkgf.GetGfEntry("greeter")
entry.Server.BindHandler("/v1/greeter", Greeter)
// Bootstrap
boot.Bootstrap(context.TODO())
boot.WaitForShutdownSig(context.TODO())
}
func Greeter(ctx *ghttp.Request) {
ctx.Response.WriteHeader(http.StatusOK)
ctx.Response.WriteJson(&GreeterResponse{
Message: fmt.Sprintf("Hello %s!", ctx.GetQuery("name").String()),
})
}
type GreeterResponse struct {
Message string
}
3.Validate#
Send request
$ curl "localhost:8080/v1/greeter?name=rk-dev"
{
"error":{
"code":429,
"status":"Too Many Requests",
"message":"",
"details":[
"slow down your request"
]
}
}