// Package openapi Day 46:外部 HTTP API 提交服务(SMS_HTTP_1.6 协议)。 // 鉴权=MD5(userName+timestamp+MD5(secret)) ±5min 窗口;响应=文档码表(code/message/msgId/smsCount)。 package openapi import ( "errors" errs "go-sms/internal/pkg/errors" ) // 协议状态码(SMS_HTTP_1.6.docx 响应码表)。 const ( CodeOK = 0 // 成功 CodeNoUser = 1 // 用户名为空 CodeAuthFail = 2 // 鉴权失败(密码错/签名不符/密钥未发) CodeDisabled = 3 // 账号禁用 CodeNoBiz = 4 // 业务未开通 CodeMissingArg = 5 // 缺少必要参数 CodeEmptyPhones = 6 // 号码列表为空 CodeTooMany = 7 // 号码数量超限 CodeEmptyBody = 8 // 短信内容为空 CodeExtTooLong = 9 // 扩展码超长 CodeCallLong = 10 // callData 超长 CodeNoPushURL = 11 // 推送地址未注册 CodeBadSchedule = 12 // 定时时间不合法 CodeNoTask = 13 // 任务ID不存在 CodeCountDiff = 14 // 数量不匹配(个性列表) CodeOneTooMany = 15 // 个性内容条数超限 CodeStaleTS = 16 // 时间戳失效(±5min 窗口外) CodeOther = 99 // 其他错误 ) // docMsgs 协议码默认文案(与 docx 状态码表对齐)。 var docMsgs = map[int]string{ CodeOK: "成功", CodeNoUser: "用户名为空", CodeAuthFail: "鉴权失败", CodeDisabled: "账号禁用", CodeNoBiz: "业务未开通", CodeMissingArg: "缺少必要参数", CodeEmptyPhones: "号码列表为空", CodeTooMany: "号码数量超限", CodeEmptyBody: "短信内容为空", CodeExtTooLong: "扩展码超长", CodeCallLong: "callData 超长", CodeNoPushURL: "推送地址未注册", CodeBadSchedule: "定时时间不合法", CodeNoTask: "任务ID不存在", CodeCountDiff: "数量不匹配", CodeOneTooMany: "个性内容条数超限", CodeStaleTS: "时间戳失效", CodeOther: "其他错误", } // DocMsg 协议码默认文案。 func DocMsg(code int) string { return docMsgs[code] } // MapErr 内部错误 → 协议码(余额不足等业务拒绝带原始中文说明,便于客户端定位)。 func MapErr(err error) (int, string) { if err == nil { return CodeOK, DocMsg(CodeOK) } var e *errs.Error if errors.As(err, &e) { switch e.Code { case errs.Arrears.Code: // ISC:007 余额不足 return CodeOther, "余额不足:" + e.Msg case errs.InvalidParam.Code: // ISC:400 参数类(提交校验细节) return CodeMissingArg, e.Msg } } return CodeOther, DocMsg(CodeOther) }