Roteamento
O Kori registra rotas em qualquer chi.Router. Toda função de registro segue o mesmo formato:
kori.METHOD(router, pattern, handler, ...options)O router é sempre explícito — o Kori nunca guarda uma referência global a ele.
Métodos HTTP
Seção intitulada “Métodos HTTP”kori.GET(r, "/users", listUsers)kori.POST(r, "/users", createUser)kori.PUT(r, "/users/{id}", replaceUser)kori.PATCH(r, "/users/{id}", updateUser)kori.DELETE(r, "/users/{id}", deleteUser)kori.HEAD(r, "/users/{id}", headUser)kori.OPTIONS(r, "/users", optionsUsers)Parâmetros de rota
Seção intitulada “Parâmetros de rota”A sintaxe {param} do Chi é usada nos padrões. Leia-os com chi.URLParam:
func getUser(w http.ResponseWriter, r *http.Request) error { id := chi.URLParam(r, "id") // use id... return kori.JSON(w, http.StatusOK, user)}Quando há múltiplos parâmetros ou você precisa de validação, use kori.BindPath:
type PostParams struct { UserID string `path:"user_id" validate:"required,uuid4"` PostID string `path:"post_id" validate:"required,uuid4"`}
func getPost(w http.ResponseWriter, r *http.Request) error { var p PostParams if err := kori.BindPath(r, &p); err != nil { return err } // p.UserID, p.PostID return kori.JSON(w, http.StatusOK, post)}Grupos de rotas
Seção intitulada “Grupos de rotas”kori.Group cria um sub-router com um prefixo compartilhado. Middlewares passados ao Group se aplicam a todas as rotas do grupo.
// Apenas prefixoapi := kori.Group(r, "/api/v1")kori.GET(api, "/users", listUsers)kori.POST(api, "/users", createUser)
// Prefixo + middlewareadmin := kori.Group(r, "/admin", authMiddleware, auditMiddleware)kori.GET(admin, "/stats", statsHandler)kori.DELETE(admin, "/users/{id}", deleteUser)Grupos aninhados:
api := kori.Group(r, "/api")v2 := kori.Group(api, "/v2") // prefixo: /api/v2kori.GET(v2, "/users", listUsersV2)Middleware por rota
Seção intitulada “Middleware por rota”Use kori.Use(...) para anexar middleware a uma única rota sem criar um sub-router:
kori.DELETE(r, "/admin/users/{id}", deleteUser, kori.Use(authMiddleware, auditMiddleware),)Múltiplas options se compõem naturalmente:
kori.POST(r, "/payments", createPayment, kori.Use(authMiddleware), kori.Use(idempotencyMiddleware),)Coexistência com Chi puro
Seção intitulada “Coexistência com Chi puro”Handlers Chi padrão e handlers Kori coexistem no mesmo router:
r := chi.NewRouter()r.Use(middleware.Logger)
// Chi puro — sem retorno de error.Get("/health", func(w http.ResponseWriter, r *http.Request) { w.Write([]byte("ok"))})
// handlers Korikori.GET(r, "/users", listUsers)kori.POST(r, "/users", createUser)