Skip to main content
Version: v2.x

RequestID

RequestID middleware for Fiber that adds an identifier to the response.

Signatures​

func New(config ...Config) fiber.Handler

Examples​

Import the middleware package that is part of the Fiber web framework

import (
"github.com/gofiber/fiber/v2"
"github.com/gofiber/fiber/v2/middleware/requestid"
)

After you initiate your Fiber app, you can use the following possibilities:

// Initialize default config
app.Use(requestid.New())

// Or extend your config for customization
app.Use(requestid.New(requestid.Config{
Header: "X-Custom-Header",
Generator: func() string {
return "static-id"
},
}))

Config​

PropertyTypeDescriptionDefault
Nextfunc(*fiber.Ctx) boolNext defines a function to skip this middleware when returned true.nil
HeaderstringHeader is the header key where to get/set the unique request ID."X-Request-ID"
Generatorfunc() stringGenerator defines a function to generate the unique identifier.utils.UUID
ContextKeyinterface{}ContextKey defines the key used when storing the request ID in the locals for a specific request."requestid"

Default Config​

The default config uses a fast UUID generator which will expose the number of requests made to the server. To conceal this value for better privacy, use the utils.UUIDv4 generator.

var ConfigDefault = Config{
Next: nil,
Header: fiber.HeaderXRequestID,
Generator: utils.UUID,
ContextKey: "requestid",
}