break
e8ab1f471e
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 12m54s
公开扫码注册原先在审批准备前就消费短信验证码，落库前的任何失败都会烧掉验证码， 客户重试只能得到统一的“分销码不可用”，掩盖了真实失败原因。 - 验证码校验与消费拆分为 CheckCode 与 ConsumeCode，注册记录与审批实例落库成功后才原子消费； 校验不消费、消费一次性，落库前失败时同一验证码可直接重试 - 分销码无效、所属店铺已停用、上级店铺缺少启用的主账号、验证码错误分别返回各自错误码与提示 - 注册必填字段缺失与请求参数校验失败提示定位到具体字段 - 同步公开接口描述与 agent-distribution-withdrawal 主 Spec 行为契约
26 lines
1.5 KiB
Go
26 lines
1.5 KiB
Go
package routes
|
|
|
|
import (
|
|
"github.com/gofiber/fiber/v2"
|
|
|
|
"github.com/break/junhong_cmp_fiber/internal/handler/app"
|
|
"github.com/break/junhong_cmp_fiber/internal/model/dto"
|
|
"github.com/break/junhong_cmp_fiber/pkg/openapi"
|
|
)
|
|
|
|
// registerAgentDistributionPublicRoutes 注册代理分销公开路由。
|
|
// Fiber 的 Group.Use() 会匹配该前缀下所有请求，因此公开路由必须在个人客户路由的 Use() 之前注册。
|
|
func registerAgentDistributionPublicRoutes(router fiber.Router, handler *app.AgentDistributionHandler, doc *openapi.Generator, basePath string) {
|
|
if handler == nil {
|
|
return
|
|
}
|
|
Register(router, doc, basePath, "POST", "/agent-distribution-registrations", handler.RegisterAgentDistribution, RouteSpec{
|
|
Summary: "代理扫码注册",
|
|
Description: "公开接口，无需认证。请求必须携带有效分销码、短信已验证手机号与密码；分销码无效、分销码所属店铺已停用、上级店铺缺少启用的主账号、短信验证码无效或已被消费分别返回各自提示，且不创建注册记录、店铺或账号。短信验证码只在注册记录落库成功后消费，落库前的失败不消耗验证码，可用同一验证码直接重试。通过后仍需企业微信终审才会创建店铺与代理账号。",
|
|
Tags: []string{"个人客户 - 代理分销注册"},
|
|
Auth: false,
|
|
Input: new(dto.CreateAgentDistributionRegistrationReq),
|
|
Output: new(dto.CreateAgentDistributionRegistrationResp),
|
|
})
|
|
}
|