mirror of
https://github.com/silenceper/wechat.git
synced 2026-02-04 21:02:25 +08:00
* 添加微信客服SDK * polish:优化签名函数 * polish:优化注释内容 * polish:复用已有的Token以及CommonError,移除无用的输出 * polish:复用已有的消息加解密 * fix:修复错误信息被覆盖的问题 * polish:go fmt 文件 * polish:客服链接支持自定义参数并更新注释文档内容 * feat:支持微信客服回调请求的校验和消息的解析,复用原有的Signature和DecryptMsg方法 * feat:对外暴露SDKApiForbidden等错误 可以通过调用升级服务相关接口然后根据该错误判断微信客服配置来源 * feat:添加无效的open_kfid错误信息 * fix: 添加SDKApiNotOpen 错误信息 目前主要用于判断客户是否关闭了API授权,如果客户关闭了API功能导致服务异常,则可以引导用户执行相应的操作重新开启改功能 * feat:暴露接待人员ID到消息列表 无需对消息进行序列化即可直接获取接待人员ID,便于处理接待人员的相关业务,例如:统计接待人员当天应答次数 * feat: 添加SDKNotUseInWeCom错误信息 如果SDK输出当前错误,则说明用户在企业微信后台关闭了微信客服功能,需引导用户重新开启该功能 Co-authored-by: Afeyer <afeyer@h5base.cn>
96 lines
2.6 KiB
Go
96 lines
2.6 KiB
Go
package kf
|
||
|
||
import (
|
||
"reflect"
|
||
"strings"
|
||
)
|
||
|
||
// Error 错误
|
||
type Error string
|
||
|
||
const (
|
||
// SDKInitFailed 错误码:50001
|
||
SDKInitFailed Error = "SDK初始化失败"
|
||
// SDKCacheUnavailable 错误码:50002
|
||
SDKCacheUnavailable Error = "缓存无效"
|
||
// SDKUnknownError 错误码:50003
|
||
SDKUnknownError Error = "未知错误"
|
||
// SDKInvalidCredential 错误码:40001
|
||
SDKInvalidCredential Error = "不合法的secret参数"
|
||
// SDKInvalidCorpID 错误码:40013
|
||
SDKInvalidCorpID Error = "无效的 CorpID"
|
||
// SDKAccessTokenInvalid 错误码:40014
|
||
SDKAccessTokenInvalid Error = "AccessToken 无效"
|
||
// SDKValidateSignatureFailed 错误码:40015
|
||
SDKValidateSignatureFailed Error = "校验签名错误"
|
||
// SDKDecryptMSGFailed 错误码:40016
|
||
SDKDecryptMSGFailed Error = "消息解密失败"
|
||
// SDKAccessTokenMissing 错误码:41001
|
||
SDKAccessTokenMissing Error = "缺少AccessToken参数"
|
||
// SDKAccessTokenExpired 错误码:42001
|
||
SDKAccessTokenExpired Error = "AccessToken 已过期"
|
||
// SDKApiFreqOutOfLimit 错误码:45009
|
||
SDKApiFreqOutOfLimit Error = "接口请求次数超频"
|
||
// SDKApiForbidden 错误码:48002
|
||
SDKApiForbidden Error = "API 禁止调用"
|
||
// SDKInvalidOpenKFID 错误码:95000
|
||
SDKInvalidOpenKFID Error = "无效的 open_kfid"
|
||
// SDKOpenKFIDNotExist 错误码:95004
|
||
SDKOpenKFIDNotExist Error = "open_kfid 不存在"
|
||
// SDKWeWorkAlready 错误码:95011
|
||
SDKWeWorkAlready Error = "已在企业微信使用微信客服"
|
||
// SDKNotUseInWeCom 错误码:95012
|
||
SDKNotUseInWeCom Error = "未在企业微信使用微信客服"
|
||
// SDKApiNotOpen 错误码:95017
|
||
SDKApiNotOpen Error = "API 功能没有被开启"
|
||
)
|
||
|
||
//Error 输出错误信息
|
||
func (r Error) Error() string {
|
||
return reflect.ValueOf(r).String()
|
||
}
|
||
|
||
// NewSDKErr 初始化SDK实例错误信息
|
||
func NewSDKErr(code int64, msgList ...string) Error {
|
||
switch code {
|
||
case 50001:
|
||
return SDKInitFailed
|
||
case 50002:
|
||
return SDKCacheUnavailable
|
||
case 40001:
|
||
return SDKInvalidCredential
|
||
case 41001:
|
||
return SDKAccessTokenMissing
|
||
case 42001:
|
||
return SDKAccessTokenExpired
|
||
case 40013:
|
||
return SDKInvalidCorpID
|
||
case 40014:
|
||
return SDKAccessTokenInvalid
|
||
case 40015:
|
||
return SDKValidateSignatureFailed
|
||
case 40016:
|
||
return SDKDecryptMSGFailed
|
||
case 45009:
|
||
return SDKApiFreqOutOfLimit
|
||
case 48002:
|
||
return SDKApiForbidden
|
||
case 95000:
|
||
return SDKInvalidOpenKFID
|
||
case 95004:
|
||
return SDKOpenKFIDNotExist
|
||
case 95011:
|
||
return SDKWeWorkAlready
|
||
case 95012:
|
||
return SDKNotUseInWeCom
|
||
case 95017:
|
||
return SDKApiNotOpen
|
||
default:
|
||
//返回未知的自定义错误
|
||
if len(msgList) > 0 {
|
||
return Error(strings.Join(msgList, ","))
|
||
}
|
||
return SDKUnknownError
|
||
}
|
||
}
|