Files

74 lines
2.5 KiB
Go

// 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)
}