fn_registry/functions/infra/rate_limiter_by_key.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
rate_limiter_by_key	function	go	infra	1.0.0	impure	func RateLimiterByKey(rl *RateLimiter, keyFunc func(r *http.Request) string) Middleware	Middleware HTTP configurable que aplica rate limiting con un extractor de clave custom. Permite limitar por API key, user ID, header arbitrario, etc. Si keyFunc devuelve cadena vacia el request pasa sin limit.	rate_limit http middleware custom key server infra	rate_limiter_check_go_infra rate_limit_headers_go_infra http_error_response_go_infra	RateLimiter_go_infra Middleware_go_infra HTTPError_go_infra	Middleware_go_infra	false	error_go_core	net/http	name desc rl puntero al RateLimiter compartido entre todos los requests name desc keyFunc funcion que extrae la clave del request (API key, user ID, etc.). Cadena vacia salta el limit	Middleware que aplica rate limit segun keyFunc, responde 429 con HTTPError JSON al exceder	true	aplica limit por la clave devuelta por keyFunc key vacia salta el limit responde 429 con body JSON al exceder headers X-RateLimit-* siempre presentes en respuesta	functions/infra/rate_limiter_by_key_test.go	functions/infra/rate_limiter_by_key.go

Ejemplo

// Limit por API key
rl := RateLimiterNew(100, 200)
mw := RateLimiterByKey(rl, func(r *http.Request) string {
    return r.Header.Get("X-API-Key")
})

// Limit por user ID extraido del JWT (suponiendo middleware previo que lo setea)
mwUser := RateLimiterByKey(rl, func(r *http.Request) string {
    return r.Context().Value("user_id").(string)
})

Notas

Funcion impura — el middleware muta el estado del limiter. Reutiliza RateLimiterCheck, RateLimitHeaders y HTTPErrorResponse del registry. Si el keyFunc devuelve "" se interpreta como "sin clave identificable" y se deja pasar el request: util para endpoints publicos donde solo se quiere limitar requests autenticados. La respuesta 429 sigue el formato JSON estandar {"status":429,"code":"rate_limited","message":"too many requests"}.