f

internal/infrastructure/external/yuyuecha/yuyuecha_errors.go

@@ -0,0 +1,27 @@
+package yuyuecha
+
+import "errors"
+
+// 内部哨兵错误（供处理器 errors.Is 判断）
+var (
+	ErrDatasource = errors.New("数据源异常")
+	ErrSystem     = errors.New("系统异常")
+	ErrNotFound   = errors.New("查询为空")
+)
+
+// HTTP 状态码与文档 9.3 对齐
+const (
+	HTTPBadRequest           = 400 // BAD_REQUEST / INVALID_NONCE
+	HTTPUnauthorized         = 401 // 签名、时间戳或 clientId 错误
+	HTTPPaymentRequired      = 402 // INSUFFICIENT_BALANCE
+	HTTPForbidden            = 403 // CLIENT_DISABLED / TRIAL_EXPIRED
+	HTTPConflict             = 409 // NONCE_CONFLICT / REQUEST_PROCESSING
+	HTTPTooManyRequests      = 429 // QUOTA_EXCEEDED
+	HTTPBadGateway           = 502 // UPSTREAM_UNAVAILABLE
+)
+
+// ResultCode 业务结果码（data[].resultCode）
+const (
+	ResultCodeNoData = 0 // 完成查询但暂无数据（正式环境计费）
+	ResultCodeHasData = 1 // 查询有数据（正式环境计费）
+)