Roteamento
As rotas do Kori são registradas em qualquer chi.Router. O motor de roteamento é o Chi — o Kori não possui um router próprio.
Registrando rotas
Seção intitulada “Registrando rotas”Todo registro de rota segue a mesma assinatura:
kori.MÉTODO(router, padrão, handler, ...opções)O router é sempre passado explicitamente. O Kori não mantém estado global de router.
r := chi.NewRouter()
kori.GET(r, "/users", listUsers)kori.POST(r, "/users", createUser)Métodos HTTP
Seção intitulada “Métodos HTTP”O Kori exporta uma função para cada método 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 é utilizada nos padrões. Leia um único parâmetro 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 conversão de tipo e 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 e p.PostID estão decodificados e validados return kori.JSON(w, http.StatusOK, post)}Rotas aninhadas
Seção intitulada “Rotas aninhadas”Os padrões podem ser aninhados com kori.Group. Veja Grupos para mais detalhes.
api := kori.Group(r, "/api/v1")kori.GET(api, "/users", listUsers) // GET /api/v1/userskori.GET(api, "/users/{id}", getUser) // GET /api/v1/users/{id}Trabalhando com Chi
Seção intitulada “Trabalhando com Chi”Como o Kori registra rotas em chi.Router, tudo que o Chi suporta está disponível: parâmetros nomeados, wildcards e sub-routers.
Handlers Chi padrão coexistem com handlers Kori no mesmo router:
r := chi.NewRouter()r.Use(middleware.Logger)r.Use(middleware.Recoverer)
// Handler Chi padrãor.Get("/health", func(w http.ResponseWriter, r *http.Request) { w.Write([]byte("ok"))})
// Handlers Korikori.GET(r, "/users", listUsers)kori.POST(r, "/users", createUser)Middlewares Chi aplicados via r.Use(...) envolvem todos os handlers — tanto Chi quanto Kori.