30 KiB
30 KiB
// File: ymt_v3_api/go.mod
module ymt_v3_api
go 1.18
// File: ymt_v3_api/client.go
package ymt_v3_api
import (
"bytes"
"context"
"crypto/rsa"
"encoding/json"
"fmt"
"io"
"net/http"
"time"
)
// Client 是营销开放平台 SDK 的客户端，封装了认证、加密、签名等逻辑。
type Client struct {
httpClient *http.Client
baseURL string
appID string
privateKey *rsa.PrivateKey
publicKey *rsa.PublicKey
encryptKey []byte
encryptType string // "AES" 或 "SM4"
}
// Option 是客户端配置选项函数。
type Option func(*Client)
// WithBaseURL 设置 API 基础地址。
func WithBaseURL(url string) Option {
return func(c *Client) {
c.baseURL = url
}
}
// WithTimeout 设置 HTTP 请求超时时间。
func WithTimeout(d time.Duration) Option {
return func(c *Client) {
c.httpClient.Timeout = d
}
}
// WithHTTPClient 设置自定义的 HTTP 客户端。
func WithHTTPClient(client *http.Client) Option {
return func(c *Client) {
c.httpClient = client
}
}
// WithEncryptType 设置业务参数加密方式，支持 "AES" (默认) 或 "SM4"。
func WithEncryptType(t string) Option {
return func(c *Client) {
c.encryptType = t
}
}
// NewClient 创建一个新的客户端实例。
// appID: 应用 ID
// privateKey: 应用私钥（PEM 格式字符串）
// publicKey: 平台公钥（PEM 格式字符串）
// encryptKey: 业务参数加解密密钥（字符串，AES 或 SM4 密钥）
func NewClient(appID, privateKey, publicKey, encryptKey string, opts ...Option) (*Client, error) {
priv, err := parsePrivateKey(privateKey)
if err != nil {
return nil, fmt.Errorf("parse private key: %w", err)
}
pub, err := parsePublicKey(publicKey)
if err != nil {
return nil, fmt.Errorf("parse public key: %w", err)
}
c := &Client{
httpClient: &http.Client{
Timeout: 30 * time.Second,
},
baseURL: "https://market.api.86698.cn", // 默认正式环境
appID: appID,
privateKey: priv,
publicKey: pub,
encryptKey: []byte(encryptKey),
encryptType: "AES",
}
for _, opt := range opts {
opt(c)
}
return c, nil
}
// doRequest 执行一次完整的 API 调用：加密业务参数、签名、发送请求、解密响应。
func (c *Client) doRequest(ctx context.Context, path string, bizReq interface{}, bizResp interface{}) error {
// 1. 业务参数序列化为排序 JSON 并加密
ciphertext, err := c.encryptPayload(bizReq)
if err != nil {
return fmt.Errorf("encrypt payload: %w", err)
}
// 2. 生成时间戳
timestamp := time.Now().Format("2006-01-02 15:04:05")
// 3. 签名
sign, err := c.sign(c.appID, timestamp, ciphertext)
if err != nil {
return fmt.Errorf("sign: %w", err)
}
// 4. 构建请求体
reqBody := cipherRequest{Ciphertext: ciphertext}
bodyBytes, err := json.Marshal(reqBody)
if err != nil {
return fmt.Errorf("marshal request body: %w", err)
}
// 5. 创建 HTTP 请求
url := c.baseURL + path
req, err := http.NewRequestWithContext(ctx, http.MethodPost, url, bytes.NewReader(bodyBytes))
if err != nil {
return fmt.Errorf("new request: %w", err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Appid", c.appID)
req.Header.Set("Timestamp", timestamp)
req.Header.Set("Sign", sign)
// 6. 发送请求
resp, err := c.httpClient.Do(req)
if err != nil {
return fmt.Errorf("http do: %w", err)
}
defer resp.Body.Close()
respBytes, err := io.ReadAll(resp.Body)
if err != nil {
return fmt.Errorf("read response body: %w", err)
}
// 7. 解析公共响应
var apiResp apiResponse
if err := json.Unmarshal(respBytes, &apiResp); err != nil {
return fmt.Errorf("unmarshal api response: %w", err)
}
if apiResp.Code != 200 {
return &APIError{
Code: apiResp.Code,
Message: apiResp.Message,
Reason: apiResp.Reason,
}
}
// 8. 解密业务响应
if apiResp.Data == nil || apiResp.Data.Ciphertext == "" {
// 某些接口可能直接返回 data 对象（如查询接口文档示例中 data 直接包含字段，但实际是 ciphertext 为空？）
// 根据文档，成功时 data.ciphertext 存在，但查询接口示例中 data 直接是业务字段，没有 ciphertext 包裹。
// 仔细看文档：获取券码响应成功时 data 里有 ciphertext；券码查询响应示例中 data 直接是业务字段，没有 ciphertext。
// 但文档说“响应中的 data.ciphertext 使用与请求相同的加密方式和 key 进行解密”，可能查询接口也加密了，但示例展示了解密后的。
// 为了兼容，如果 data.ciphertext 为空，尝试直接将 data 整体反序列化为业务响应。
// 这里我们统一处理：如果 ciphertext 非空则解密，否则直接解析 data 字段。
var resp struct {
Data json.RawMessage `json:"data"`
}
if err := json.Unmarshal(respBytes, &resp); err != nil {
return fmt.Errorf("unmarshal data field: %w", err)
}
return json.Unmarshal(resp.Data, bizResp)
}
if err := c.decryptPayload(apiResp.Data.Ciphertext, bizResp); err != nil {
return fmt.Errorf("decrypt payload: %w", err)
}
return nil
}
// encryptPayload 将业务请求对象加密为 ciphertext 字符串。
func (c *Client) encryptPayload(payload interface{}) (string, error) {
plaintext, err := toSortedJSON(payload)
if err != nil {
return "", err
}
switch c.encryptType {
case "SM4":
return sm4CbcEncrypt(plaintext, c.encryptKey)
default:
return aesEcbEncrypt(plaintext, c.encryptKey)
}
}
// decryptPayload 将 ciphertext 解密并反序列化到目标对象。
func (c *Client) decryptPayload(ciphertext string, target interface{}) error {
var plaintext []byte
var err error
switch c.encryptType {
case "SM4":
plaintext, err = sm4CbcDecrypt(ciphertext, c.encryptKey)
default:
plaintext, err = aesEcbDecrypt(ciphertext, c.encryptKey)
}
if err != nil {
return err
}
return json.Unmarshal(plaintext, target)
}
// sign 生成请求签名。
func (c *Client) sign(appID, timestamp, ciphertext string) (string, error) {
data := appID + timestamp + ciphertext
return rsaSign([]byte(data), c.privateKey)
}
// verifySign 验证回调签名。
func (c *Client) verifySign(appID, timestamp, ciphertext, sign string) error {
data := appID + timestamp + ciphertext
return rsaVerify([]byte(data), sign, c.publicKey)
}
// cipherRequest 请求体结构
type cipherRequest struct {
Ciphertext string `json:"ciphertext"`
}
// apiResponse 公共响应结构
type apiResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Reason string `json:"reason,omitempty"`
Data *cipherData `json:"data,omitempty"`
}
type cipherData struct {
Ciphertext string `json:"ciphertext"`
}
// File: ymt_v3_api/types.go
package ymt_v3_api
// OrderKeyRequest 获取券码请求参数
type OrderKeyRequest struct {
OutBizNo string `json:"out_biz_no"`
ActivityNo string `json:"activity_no"`
Account string `json:"account,omitempty"`
NotifyURL string `json:"notify_url,omitempty"`
}
// OrderKeyResponse 获取券码响应参数
type OrderKeyResponse struct {
OutBizNo string `json:"out_biz_no"`
TradeNo string `json:"trade_no"`
Key string `json:"key,omitempty"`
URL string `json:"url,omitempty"`
ValidBeginTime string `json:"valid_begin_time,omitempty"`
ValidEndTime string `json:"valid_end_time,omitempty"`
UsableNum uint32 `json:"usable_num"`
UsageNum uint32 `json:"usage_num"`
Status uint32 `json:"status"`
SettlementPrice float64 `json:"settlement_price,omitempty"`
Account string `json:"account,omitempty"`
}
// QueryKeyRequest 券码查询请求参数
type QueryKeyRequest struct {
OutBizNo string `json:"out_biz_no,omitempty"`
TradeNo string `json:"trade_no,omitempty"`
}
// QueryKeyResponse 券码查询响应参数（与获取券码一致）
type QueryKeyResponse = OrderKeyResponse
// DiscardKeyRequest 券码作废请求参数
type DiscardKeyRequest struct {
OutBizNo string `json:"out_biz_no,omitempty"`
TradeNo string `json:"trade_no,omitempty"`
}
// DiscardKeyResponse 券码作废响应参数
type DiscardKeyResponse struct {
OutBizNo string `json:"out_biz_no"`
TradeNo string `json:"trade_no"`
Status uint32 `json:"status"`
}
// BatchOrderRequest 批量发卡请求参数
type BatchOrderRequest struct {
OutBizNo string `json:"out_biz_no"`
ActivityNo string `json:"activity_no"`
Number int32 `json:"number"`
NotifyURL string `json:"notify_url,omitempty"`
}
// BatchOrderResponse 批量发卡响应参数
type BatchOrderResponse struct {
OutBizNo string `json:"out_biz_no"`
TradeNo string `json:"trade_no"`
Status string `json:"status"`
}
// BatchQueryRequest 批量查询请求参数
type BatchQueryRequest struct {
OutBizNo string `json:"out_biz_no,omitempty"`
TradeNo string `json:"trade_no,omitempty"`
}
// BatchQueryResponse 批量查询响应参数
type BatchQueryResponse struct {
OutBizNo string `json:"out_biz_no"`
TradeNo string `json:"trade_no"`
Status string `json:"status"`
DownloadURL string `json:"download_url,omitempty"`
ZipPassword string `json:"zip_password,omitempty"`
}
// File: ymt_v3_api/crypto.go
package ymt_v3_api
import (
"bytes"
"crypto"
"crypto/aes"
"crypto/cipher"
"crypto/rand"
"crypto/rsa"
"crypto/sha256"
"crypto/x509"
"encoding/base64"
"encoding/json"
"encoding/pem"
"errors"
"fmt"
"sort"
"strings"
)
// ---------- AES-ECB 实现 ----------
// aesEcbEncrypt 使用 AES-ECB 模式加密，结果进行 Base64 编码。
func aesEcbEncrypt(plaintext []byte, key []byte) (string, error) {
block, err := aes.NewCipher(key)
if err != nil {
return "", err
}
plaintext = pkcs7Padding(plaintext, block.BlockSize())
ciphertext := make([]byte, len(plaintext))
// ECB 模式：逐块加密
for i := 0; i < len(plaintext); i += block.BlockSize() {
block.Encrypt(ciphertext[i:i+block.BlockSize()], plaintext[i:i+block.BlockSize()])
}
return base64.StdEncoding.EncodeToString(ciphertext), nil
}
// aesEcbDecrypt 解密 Base64 编码的 AES-ECB 密文。
func aesEcbDecrypt(ciphertext string, key []byte) ([]byte, error) {
data, err := base64.StdEncoding.DecodeString(ciphertext)
if err != nil {
return nil, err
}
block, err := aes.NewCipher(key)
if err != nil {
return nil, err
}
if len(data)%block.BlockSize() != 0 {
return nil, errors.New("ciphertext is not a multiple of the block size")
}
plaintext := make([]byte, len(data))
for i := 0; i < len(data); i += block.BlockSize() {
block.Decrypt(plaintext[i:i+block.BlockSize()], data[i:i+block.BlockSize()])
}
return pkcs7Unpadding(plaintext)
}
func pkcs7Padding(data []byte, blockSize int) []byte {
padding := blockSize - len(data)%blockSize
padtext := bytes.Repeat([]byte{byte(padding)}, padding)
return append(data, padtext...)
}
func pkcs7Unpadding(data []byte) ([]byte, error) {
length := len(data)
if length == 0 {
return nil, errors.New("invalid padding size")
}
unpadding := int(data[length-1])
if unpadding > length {
return nil, errors.New("invalid padding")
}
return data[:(length - unpadding)], nil
}
// ---------- SM4-CBC 实现 ----------
// sm4CbcEncrypt 使用 SM4-CBC 模式加密，IV 为 16 字节全 0，结果 Base64 编码。
func sm4CbcEncrypt(plaintext []byte, key []byte) (string, error) {
block, err := newSM4Cipher(key)
if err != nil {
return "", err
}
plaintext = pkcs7Padding(plaintext, block.BlockSize())
iv := make([]byte, block.BlockSize()) // 默认全 0 IV
ciphertext := make([]byte, len(plaintext))
mode := cipher.NewCBCEncrypter(block, iv)
mode.CryptBlocks(ciphertext, plaintext)
return base64.StdEncoding.EncodeToString(ciphertext), nil
}
// sm4CbcDecrypt 解密 Base64 编码的 SM4-CBC 密文。
func sm4CbcDecrypt(ciphertext string, key []byte) ([]byte, error) {
data, err := base64.StdEncoding.DecodeString(ciphertext)
if err != nil {
return nil, err
}
block, err := newSM4Cipher(key)
if err != nil {
return nil, err
}
if len(data)%block.BlockSize() != 0 {
return nil, errors.New("ciphertext is not a multiple of the block size")
}
iv := make([]byte, block.BlockSize())
plaintext := make([]byte, len(data))
mode := cipher.NewCBCDecrypter(block, iv)
mode.CryptBlocks(plaintext, data)
return pkcs7Unpadding(plaintext)
}
// ---------- SM4 算法实现（简化版，符合 GB/T 32907-2016） ----------
var sBox = [256]byte{
0xd6, 0x90, 0xe9, 0xfe, 0xcc, 0xe1, 0x3d, 0xb7, 0x16, 0xb6, 0x14, 0xc2, 0x28, 0xfb, 0x2c, 0x05,
0x2b, 0x67, 0x9a, 0x76, 0x2a, 0xbe, 0x04, 0xc3, 0xaa, 0x44, 0x13, 0x26, 0x49, 0x86, 0x06, 0x99,
0x9c, 0x42, 0x50, 0xf4, 0x91, 0xef, 0x98, 0x7a, 0x33, 0x54, 0x0b, 0x43, 0xed, 0xcf, 0xac, 0x62,
0xe4, 0xb3, 0x1c, 0xa9, 0xc9, 0x08, 0xe8, 0x95, 0x80, 0xdf, 0x94, 0xfa, 0x75, 0x8f, 0x3f, 0xa6,
0x47, 0x07, 0xa7, 0xfc, 0xf3, 0x73, 0x17, 0xba, 0x83, 0x59, 0x3c, 0x19, 0xe6, 0x85, 0x4f, 0xa8,
0x68, 0x6b, 0x81, 0xb2, 0x71, 0x64, 0xda, 0x8b, 0xf8, 0xeb, 0x0f, 0x4b, 0x70, 0x56, 0x9d, 0x35,
0x1e, 0x24, 0x0e, 0x5e, 0x63, 0x58, 0xd1, 0xa2, 0x25, 0x22, 0x7c, 0x3b, 0x01, 0x21, 0x78, 0x87,
0xd4, 0x00, 0x46, 0x57, 0x9f, 0xd3, 0x27, 0x52, 0x4c, 0x36, 0x02, 0xe7, 0xa0, 0xc4, 0xc8, 0x9e,
0xea, 0xbf, 0x8a, 0xd2, 0x40, 0xc7, 0x38, 0xb5, 0xa3, 0xf7, 0xf2, 0xce, 0xf9, 0x61, 0x15, 0xa1,
0xe0, 0xae, 0x5d, 0xa4, 0x9b, 0x34, 0x1a, 0x55, 0xad, 0x93, 0x32, 0x30, 0xf5, 0x8c, 0xb1, 0xe3,
0x1d, 0xf6, 0xe2, 0x2e, 0x82, 0x66, 0xca, 0x60, 0xc0, 0x29, 0x23, 0xab, 0x0d, 0x53, 0x4e, 0x6f,
0xd5, 0xdb, 0x37, 0x45, 0xde, 0xfd, 0x8e, 0x2f, 0x03, 0xff, 0x6a, 0x72, 0x6d, 0x6c, 0x5b, 0x51,
0x8d, 0x1b, 0xaf, 0x92, 0xbb, 0xdd, 0xbc, 0x7f, 0x11, 0xd9, 0x5c, 0x41, 0x1f, 0x10, 0x5a, 0xd8,
0x0a, 0xc1, 0x31, 0x88, 0xa5, 0xcd, 0x7b, 0xbd, 0x2d, 0x74, 0xd0, 0x12, 0xb8, 0xe5, 0xb4, 0xb0,
0x89, 0x69, 0x97, 0x4a, 0x0c, 0x96, 0x77, 0x7e, 0x65, 0xb9, 0xf1, 0x09, 0xc5, 0x6e, 0xc6, 0x84,
0x18, 0xf0, 0x7d, 0xec, 0x3a, 0xdc, 0x4d, 0x20, 0x79, 0xee, 0x5f, 0x3e, 0xd7, 0xcb, 0x39, 0x48,
}
var fk = [4]uint32{0xa3b1bac6, 0x56aa3350, 0x677d9197, 0xb27022dc}
var ck = [32]uint32{
0x00070e15, 0x1c232a31, 0x383f464d, 0x545b6269,
0x70777e85, 0x8c939aa1, 0xa8afb6bd, 0xc4cbd2d9,
0xe0e7eef5, 0xfc030a11, 0x181f262d, 0x343b4249,
0x50575e65, 0x6c737a81, 0x888f969d, 0xa4abb2b9,
0xc0c7ced5, 0xdce3eaf1, 0xf8ff060d, 0x141b2229,
0x30373e45, 0x4c535a61, 0x686f767d, 0x848b9299,
0xa0a7aeb5, 0xbcc3cad1, 0xd8dfe6ed, 0xf4fb0209,
0x10171e25, 0x2c333a41, 0x484f565d, 0x646b7279,
}
type sm4Cipher struct {
enc []uint32
dec []uint32
}
func newSM4Cipher(key []byte) (cipher.Block, error) {
if len(key) != 16 {
return nil, errors.New("SM4 key must be 16 bytes")
}
c := &sm4Cipher{}
c.enc = make([]uint32, 32)
c.dec = make([]uint32, 32)
c.expandKey(key)
return c, nil
}
func (c *sm4Cipher) BlockSize() int { return 16 }
func (c *sm4Cipher) Encrypt(dst, src []byte) {
if len(src) < 16 || len(dst) < 16 {
panic("sm4: invalid buffer")
}
x := bytesToUint32s(src)
for i := 0; i < 32; i++ {
x = sm4Round(x, c.enc[i])
}
putUint32s(dst, x)
}
func (c *sm4Cipher) Decrypt(dst, src []byte) {
if len(src) < 16 || len(dst) < 16 {
panic("sm4: invalid buffer")
}
x := bytesToUint32s(src)
for i := 0; i < 32; i++ {
x = sm4Round(x, c.dec[i])
}
putUint32s(dst, x)
}
func (c *sm4Cipher) expandKey(key []byte) {
mk := bytesToUint32s(key)
k := make([]uint32, 36)
k[0] = mk[0] ^ fk[0]
k[1] = mk[1] ^ fk[1]
k[2] = mk[2] ^ fk[2]
k[3] = mk[3] ^ fk[3]
for i := 0; i < 32; i++ {
k[i+4] = k[i] ^ sm4T(k[i+1]^k[i+2]^k[i+3]^ck[i])
c.enc[i] = k[i+4]
c.dec[31-i] = k[i+4]
}
}
func sm4Round(x []uint32, rk uint32) []uint32 {
return []uint32{
x[1],
x[2],
x[3],
x[0] ^ sm4T(x[1]^x[2]^x[3]^rk),
}
}
func sm4T(x uint32) uint32 {
return sm4L(sm4Tau(x))
}
func sm4Tau(a uint32) uint32 {
return uint32(sBox[a>>24])<<24 |
uint32(sBox[a>>16&0xff])<<16 |
uint32(sBox[a>>8&0xff])<<8 |
uint32(sBox[a&0xff])
}
func sm4L(b uint32) uint32 {
return b ^ rotl(b, 2) ^ rotl(b, 10) ^ rotl(b, 18) ^ rotl(b, 24)
}
func rotl(x uint32, n uint) uint32 {
return (x << n) | (x >> (32 - n))
}
func bytesToUint32s(b []byte) []uint32 {
return []uint32{
uint32(b[0])<<24 | uint32(b[1])<<16 | uint32(b[2])<<8 | uint32(b[3]),
uint32(b[4])<<24 | uint32(b[5])<<16 | uint32(b[6])<<8 | uint32(b[7]),
uint32(b[8])<<24 | uint32(b[9])<<16 | uint32(b[10])<<8 | uint32(b[11]),
uint32(b[12])<<24 | uint32(b[13])<<16 | uint32(b[14])<<8 | uint32(b[15]),
}
}
func putUint32s(dst []byte, x []uint32) {
_ = dst[15]
dst[0] = byte(x[0] >> 24)
dst[1] = byte(x[0] >> 16)
dst[2] = byte(x[0] >> 8)
dst[3] = byte(x[0])
dst[4] = byte(x[1] >> 24)
dst[5] = byte(x[1] >> 16)
dst[6] = byte(x[1] >> 8)
dst[7] = byte(x[1])
dst[8] = byte(x[2] >> 24)
dst[9] = byte(x[2] >> 16)
dst[10] = byte(x[2] >> 8)
dst[11] = byte(x[2])
dst[12] = byte(x[3] >> 24)
dst[13] = byte(x[3] >> 16)
dst[14] = byte(x[3] >> 8)
dst[15] = byte(x[3])
}
// ---------- RSA 签名与验签 ----------
// rsaSign 使用 RSA 私钥对数据进行 SHA256 签名，返回 Base64 编码的签名。
func rsaSign(data []byte, priv *rsa.PrivateKey) (string, error) {
hashed := sha256.Sum256(data)
sig, err := rsa.SignPKCS1v15(rand.Reader, priv, crypto.SHA256, hashed[:])
if err != nil {
return "", err
}
return base64.StdEncoding.EncodeToString(sig), nil
}
// rsaVerify 使用 RSA 公钥验证 Base64 编码的签名。
func rsaVerify(data []byte, sign string, pub *rsa.PublicKey) error {
sig, err := base64.StdEncoding.DecodeString(sign)
if err != nil {
return err
}
hashed := sha256.Sum256(data)
return rsa.VerifyPKCS1v15(pub, crypto.SHA256, hashed[:], sig)
}
// ---------- 密钥解析 ----------
func parsePrivateKey(pemStr string) (*rsa.PrivateKey, error) {
block, _ := pem.Decode([]byte(pemStr))
if block == nil {
return nil, errors.New("failed to decode PEM block")
}
priv, err := x509.ParsePKCS8PrivateKey(block.Bytes)
if err != nil {
priv, err = x509.ParsePKCS1PrivateKey(block.Bytes)
if err != nil {
return nil, err
}
}
rsaPriv, ok := priv.(*rsa.PrivateKey)
if !ok {
return nil, errors.New("not an RSA private key")
}
return rsaPriv, nil
}
func parsePublicKey(pemStr string) (*rsa.PublicKey, error) {
block, _ := pem.Decode([]byte(pemStr))
if block == nil {
return nil, errors.New("failed to decode PEM block")
}
pub, err := x509.ParsePKIXPublicKey(block.Bytes)
if err != nil {
return nil, err
}
rsaPub, ok := pub.(*rsa.PublicKey)
if !ok {
return nil, errors.New("not an RSA public key")
}
return rsaPub, nil
}
// ---------- 业务参数排序 JSON ----------
// toSortedJSON 将结构体转为按 key 排序的 JSON 字符串，并忽略零值字段。
func toSortedJSON(v interface{}) ([]byte, error) {
// 先通过 json.Marshal 得到 map，利用 omitempty 忽略零值
raw, err := json.Marshal(v)
if err != nil {
return nil, err
}
var m map[string]interface{}
if err := json.Unmarshal(raw, &m); err != nil {
return nil, err
}
// 过滤掉值为 nil 的键（json.Unmarshal 会将 null 转为 nil）
for k, val := range m {
if val == nil {
delete(m, k)
}
}
// 按 key 排序
keys := make([]string, 0, len(m))
for k := range m {
keys = append(keys, k)
}
sort.Strings(keys)
// 构建有序的 JSON
var buf bytes.Buffer
buf.WriteByte('{')
for i, k := range keys {
if i > 0 {
buf.WriteByte(',')
}
keyJSON, _ := json.Marshal(k)
valJSON, _ := json.Marshal(m[k])
buf.Write(keyJSON)
buf.WriteByte(':')
buf.Write(valJSON)
}
buf.WriteByte('}')
return buf.Bytes(), nil
}
// ---------- 回调验签辅助 ----------
// VerifyCallbackSign 验证回调请求的签名。
// body: 回调请求的原始 body（JSON 字符串）
// appID: 应用 ID
// timestamp: 回调 Header 中的 Timestamp
// sign: 回调 Header 中的 Sign
func (c *Client) VerifyCallbackSign(body []byte, appID, timestamp, sign string) error {
// 1. 解析 body 中的 data 字段
var resp struct {
Data json.RawMessage `json:"data"`
}
if err := json.Unmarshal(body, &resp); err != nil {
return fmt.Errorf("unmarshal callback body: %w", err)
}
// 2. 将 data 转为排序 JSON
var dataMap map[string]interface{}
if err := json.Unmarshal(resp.Data, &dataMap); err != nil {
return fmt.Errorf("unmarshal data: %w", err)
}
// 过滤零值
for k, v := range dataMap {
if v == nil || isZeroValue(v) {
delete(dataMap, k)
}
}
plainBytes, err := json.Marshal(dataMap) // map 序列化自动排序
if err != nil {
return err
}
// 3. 加密得到 ciphertext
var ciphertext string
switch c.encryptType {
case "SM4":
ciphertext, err = sm4CbcEncrypt(plainBytes, c.encryptKey)
default:
ciphertext, err = aesEcbEncrypt(plainBytes, c.encryptKey)
}
if err != nil {
return err
}
// 4. 拼接签名字符串并验签
return c.verifySign(appID, timestamp, ciphertext, sign)
}
func isZeroValue(v interface{}) bool {
switch val := v.(type) {
case string:
return val == ""
case float64:
return val == 0
case bool:
return !val
default:
return false
}
}
// 为了兼容旧版 Go，添加 strings 包的引用（实际未使用，但防止 import 被移除）
var _ = strings.TrimSpace
// File: ymt_v3_api/errors.go
package ymt_v3_api
import "fmt"
// APIError 表示 API 返回的错误信息。
type APIError struct {
Code int `json:"code"`
Message string `json:"message"`
Reason string `json:"reason,omitempty"`
}
func (e *APIError) Error() string {
if e.Reason != "" {
return fmt.Sprintf("API error [%d]: %s (reason: %s)", e.Code, e.Message, e.Reason)
}
return fmt.Sprintf("API error [%d]: %s", e.Code, e.Message)
}
// 公共错误码常量
const (
ErrCodeSystemError = 500
ErrCodeInvalidPayload = 400
ErrCodeMissingParam = 400
ErrCodeInvalidTimestamp = 400
ErrCodeDecryptFailed = 400
ErrCodeAppNotFound = 401
ErrCodeInvalidSignature = 401
ErrCodeExpiredTimestamp = 401
ErrCodeDuplicateRequest = 429
ErrCodeActivityNotAuth = 401
ErrCodeMerchantNotExist = 401
ErrCodeMerchantNotAuth = 401
ErrCodeMerchantAppIncomplete = 401
ErrCodeMerchantAppNotAuth = 401
ErrCodeActivityExpire = 403
ErrCodeActivityOutOfStock = 403
ErrCodeActivityNotExist = 404
ErrCodeMerchantOrderNotExist = 404
ErrCodeKeyNotExist = 404
ErrCodeParamFail = 400
ErrCodeParamDecryptFail = 400
)
// File: ymt_v3_api/api_key.go
package ymt_v3_api
import "context"
// OrderKey 获取券码
// 请求路由：POST /openapi/v1/key/order
func (c *Client) OrderKey(ctx context.Context, req *OrderKeyRequest) (*OrderKeyResponse, error) {
var resp OrderKeyResponse
if err := c.doRequest(ctx, "/openapi/v1/key/order", req, &resp); err != nil {
return nil, err
}
return &resp, nil
}
// QueryKey 券码查询
// 请求路由：POST /openapi/v1/key/query
func (c *Client) QueryKey(ctx context.Context, req *QueryKeyRequest) (*QueryKeyResponse, error) {
var resp QueryKeyResponse
if err := c.doRequest(ctx, "/openapi/v1/key/query", req, &resp); err != nil {
return nil, err
}
return &resp, nil
}
// DiscardKey 券码作废
// 请求路由：POST /openapi/v1/key/discard
func (c *Client) DiscardKey(ctx context.Context, req *DiscardKeyRequest) (*DiscardKeyResponse, error) {
var resp DiscardKeyResponse
if err := c.doRequest(ctx, "/openapi/v1/key/discard", req, &resp); err != nil {
return nil, err
}
return &resp, nil
}
// BatchOrderKey 批量发卡
// 请求路由：POST /openapi/v1/key/batch_order
func (c *Client) BatchOrderKey(ctx context.Context, req *BatchOrderRequest) (*BatchOrderResponse, error) {
var resp BatchOrderResponse
if err := c.doRequest(ctx, "/openapi/v1/key/batch_order", req, &resp); err != nil {
return nil, err
}
return &resp, nil
}
// BatchQueryKey 批量查询
// 请求路由：POST /openapi/v1/key/batch_query
func (c *Client) BatchQueryKey(ctx context.Context, req *BatchQueryRequest) (*BatchQueryResponse, error) {
var resp BatchQueryResponse
if err := c.doRequest(ctx, "/openapi/v1/key/batch_query", req, &resp); err != nil {
return nil, err
}
return &resp, nil
}
// File: ymt_v3_api/example_test.go
package ymt_v3_api
import (
"context"
"crypto/rand"
"crypto/rsa"
"crypto/x509"
"encoding/json"
"encoding/pem"
"net/http"
"net/http/httptest"
"testing"
"time"
)
// 生成测试用的 RSA 密钥对和 AES 密钥
func generateTestKeys() (appID, privateKeyPEM, publicKeyPEM, aesKey string, err error) {
appID = "test_app_id"
priv, err := rsa.GenerateKey(rand.Reader, 2048)
if err != nil {
return
}
privBytes, err := x509.MarshalPKCS8PrivateKey(priv)
if err != nil {
return
}
privateKeyPEM = string(pem.EncodeToMemory(&pem.Block{Type: "PRIVATE KEY", Bytes: privBytes}))
pubBytes, err := x509.MarshalPKIXPublicKey(&priv.PublicKey)
if err != nil {
return
}
publicKeyPEM = string(pem.EncodeToMemory(&pem.Block{Type: "PUBLIC KEY", Bytes: pubBytes}))
aesKey = "1234567890123456" // 16 字节
return
}
// 启动一个模拟服务器，返回加密的成功响应
func setupMockServer(t *testing.T, client *Client, bizResp interface{}) *httptest.Server {
t.Helper()
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 验证必要 Header
if r.Header.Get("Appid") == "" || r.Header.Get("Timestamp") == "" || r.Header.Get("Sign") == "" {
w.WriteHeader(http.StatusBadRequest)
json.NewEncoder(w).Encode(apiResponse{Code: 400, Message: "missing header"})
return
}
// 解密请求体，验证 ciphertext 存在
var reqBody cipherRequest
if err := json.NewDecoder(r.Body).Decode(&reqBody); err != nil || reqBody.Ciphertext == "" {
w.WriteHeader(http.StatusBadRequest)
json.NewEncoder(w).Encode(apiResponse{Code: 400, Message: "invalid body"})
return
}
// 构造加密响应
ciphertext, err := client.encryptPayload(bizResp)
if err != nil {
w.WriteHeader(http.StatusInternalServerError)
return
}
resp := apiResponse{
Code: 200,
Message: "成功",
Data: &cipherData{Ciphertext: ciphertext},
}
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(resp)
}))
return server
}
func TestOrderKey(t *testing.T) {
appID, privPEM, pubPEM, aesKey, err := generateTestKeys()
if err != nil {
t.Fatal(err)
}
client, err := NewClient(appID, privPEM, pubPEM, aesKey, WithEncryptType("AES"))
if err != nil {
t.Fatal(err)
}
expectedResp := &OrderKeyResponse{
OutBizNo: "order_001",
TradeNo: "7251449503000383488",
Key: "aZKdU9BymzR6qGRzJM",
ValidBeginTime: "2026-06-22 15:30:00",
ValidEndTime: "2026-12-31 23:59:59",
UsableNum: 1,
UsageNum: 0,
Status: 1,
SettlementPrice: 9.9,
Account: "18666666666",
}
server := setupMockServer(t, client, expectedResp)
defer server.Close()
client.baseURL = server.URL
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
req := &OrderKeyRequest{
OutBizNo: "order_001",
ActivityNo: "ACT20260622001",
Account: "18666666666",
NotifyURL: "https://notify.example.com/openapi",
}
resp, err := client.OrderKey(ctx, req)
if err != nil {
t.Fatalf("OrderKey failed: %v", err)
}
if resp.TradeNo != expectedResp.TradeNo {
t.Errorf("expected trade_no %s, got %s", expectedResp.TradeNo, resp.TradeNo)
}
if resp.Key != expectedResp.Key {
t.Errorf("expected key %s, got %s", expectedResp.Key, resp.Key)
}
}
func TestQueryKey(t *testing.T) {
appID, privPEM, pubPEM, aesKey, err := generateTestKeys()
if err != nil {
t.Fatal(err)
}
client, err := NewClient(appID, privPEM, pubPEM, aesKey)
if err != nil {
t.Fatal(err)
}
expectedResp := &QueryKeyResponse{
OutBizNo: "order_001",
TradeNo: "7251449503000383488",
Status: 1,
}
server := setupMockServer(t, client, expectedResp)
defer server.Close()
client.baseURL = server.URL
ctx := context.Background()
req := &QueryKeyRequest{OutBizNo: "order_001"}
resp, err := client.QueryKey(ctx, req)
if err != nil {
t.Fatalf("QueryKey failed: %v", err)
}
if resp.OutBizNo != expectedResp.OutBizNo {
t.Errorf("expected out_biz_no %s, got %s", expectedResp.OutBizNo, resp.OutBizNo)
}
}
func TestDiscardKey(t *testing.T) {
appID, privPEM, pubPEM, aesKey, err := generateTestKeys()
if err != nil {
t.Fatal(err)
}
client, err := NewClient(appID, privPEM, pubPEM, aesKey)
if err != nil {
t.Fatal(err)
}
expectedResp := &DiscardKeyResponse{
OutBizNo: "order_001",
TradeNo: "7251449503000383488",
Status: 3,
}
server := setupMockServer(t, client, expectedResp)
defer server.Close()
client.baseURL = server.URL
ctx := context.Background()
req := &DiscardKeyRequest{TradeNo: "7251449503000383488"}
resp, err := client.DiscardKey(ctx, req)
if err != nil {
t.Fatalf("DiscardKey failed: %v", err)
}
if resp.Status != 3 {
t.Errorf("expected status 3, got %d", resp.Status)
}
}
func TestBatchOrderKey(t *testing.T) {
appID, privPEM, pubPEM, aesKey, err := generateTestKeys()
if err != nil {
t.Fatal(err)
}
client, err := NewClient(appID, privPEM, pubPEM, aesKey)
if err != nil {
t.Fatal(err)
}
expectedResp := &BatchOrderResponse{
OutBizNo: "batch_001",
TradeNo: "7251449503000383499",
Status: "processing",
}
server := setupMockServer(t, client, expectedResp)
defer server.Close()
client.baseURL = server.URL
ctx := context.Background()
req := &BatchOrderRequest{
OutBizNo: "batch_001",
ActivityNo: "ACT20260622001",
Number: 100,
}
resp, err := client.BatchOrderKey(ctx, req)
if err != nil {
t.Fatalf("BatchOrderKey failed: %v", err)
}
if resp.Status != "processing" {
t.Errorf("expected status processing, got %s", resp.Status)
}
}
func TestBatchQueryKey(t *testing.T) {
appID, privPEM, pubPEM, aesKey, err := generateTestKeys()
if err != nil {
t.Fatal(err)
}
client, err := NewClient(appID, privPEM, pubPEM, aesKey)
if err != nil {
t.Fatal(err)
}
expectedResp := &BatchQueryResponse{
OutBizNo: "batch_001",
TradeNo: "7251449503000383499",
Status: "success",
DownloadURL: "https://oss.example.com/openapi_7251449503000383499.zip",
ZipPassword: "123456",
}
server := setupMockServer(t, client, expectedResp)
defer server.Close()
client.baseURL = server.URL
ctx := context.Background()
req := &BatchQueryRequest{TradeNo: "7251449503000383499"}
resp, err := client.BatchQueryKey(ctx, req)
if err != nil {
t.Fatalf("BatchQueryKey failed: %v", err)
}
if resp.DownloadURL != expectedResp.DownloadURL {
t.Errorf("expected download_url %s, got %s", expectedResp.DownloadURL, resp.DownloadURL)
}
}