74 lines
2.5 KiB
Go
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)
|
|
}
|