Pular para o conteúdo
Documentação DiscordKit

Router

Entenda como o DiscordKit resolve comandos, componentes, modais, autocomplete, middleware, grupos e parâmetros de rota.

Abrir texto

O Router é o componente central de roteamento de interações do DiscordKit.

Ele conecta interações recebidas do Discord aos handlers da aplicação.

Um único Router pode tratar Application Commands, componentes, submissões de modais e autocomplete.

router := discordkit.NewRouter()

Com middleware global:

router := discordkit.NewRouter(
discordkit.Logging(nil),
discordkit.RequireGuild(),
)
session.AddHandler(router.Handle)
router.Command("ping", pingHandler)
router.Command("admin ban", banHandler)
router.Command("config channel set", setChannelHandler)

Caminhos de comandos usam espaços.

Literal:

router.Component("settings:save", saveSettings)

Parametrizada:

router.Component(
"/jobs/:jobID/save",
saveJob,
)

Para /jobs/42/save:

jobID := c.MustParam("jobID")
router.Modal(
"/jobs/:jobID/edit",
updateJob,
)
router.Autocomplete(
"jobs search",
"query",
autocompleteJobs,
)
router.Command(
"admin ban",
banUser,
discordkit.RequireGuild(),
discordkit.RequirePermissions(
discordgo.PermissionBanMembers,
),
)
router.Use(
discordkit.Logging(nil),
)

Middleware adicionado com Use se aplica às rotas registradas antes e depois dele.

admin := router.Group(
"admin",
discordkit.RequireGuild(),
)
admin.Command(
"ban",
banHandler,
)

Groups compartilham prefixos e middleware, mas registram suas rotas no Router original.

/jobs/:jobID/save

Acesse com:

jobID, ok := c.Param("jobID")
jobID, err := c.RequireParam("jobID")
jobID := c.MustParam("jobID")

DiscordKit retorna ErrRouteConflict quando rotas entram em conflito.

Estes padrões são estruturalmente equivalentes:

/jobs/:jobID/save
/jobs/:id/save

Sempre trate os erros de registro durante o startup.

Interações válidas sem rota correspondente retornam ErrRouteNotFound.

router.OnError(func(
c *discordkit.Context,
err error,
) {
slog.Error("interaction failed", "error", err)
})

Sem hook configurado, DiscordKit utiliza slog.

O dispatch do Router aplica Recovery() automaticamente.

Um panic vira *discordkit.PanicError.

Para testes ou integrações em baixo nível:

err := router.Dispatch(ctx)

Dispatch não executa OnError; ele retorna o erro diretamente.

Continue com Context para aprender como handlers acessam dados das interações e parâmetros de rota.