feat: 更新路由参数格式,增强路由一致性和可读性

This commit is contained in:
2025-12-24 11:02:05 +08:00
parent 469d691a75
commit 40776b78e2
5 changed files with 59 additions and 24 deletions

View File

@@ -41,7 +41,7 @@ func (*order) list(ctx fiber.Ctx, filter *dto.OrderPageFilter) (*requests.Pager,
// @Param orderID path int64 true "OrderID"
// @Success 200 {object} dto.SuperOrderDetail
//
// @Router /super/v1/orders/:orderID [get]
// @Router /super/v1/orders/:orderID<int> [get]
// @Bind orderID path
func (*order) detail(ctx fiber.Ctx, orderID int64) (*dto.SuperOrderDetail, error) {
return services.Order.SuperOrderDetail(ctx, orderID)
@@ -58,7 +58,7 @@ func (*order) detail(ctx fiber.Ctx, orderID int64) (*dto.SuperOrderDetail, error
// @Param form body dto.SuperOrderRefundForm true "Form"
// @Success 200 {object} models.Order
//
// @Router /super/v1/orders/:orderID/refund [post]
// @Router /super/v1/orders/:orderID<int>/refund [post]
// @Bind orderID path
// @Bind form body
func (*order) refund(ctx fiber.Ctx, orderID int64, form *dto.SuperOrderRefundForm) (*models.Order, error) {