Go与PHP HTTP请求差异解析：签名与POST数据处理最佳实践

<?php
// ... 省略部分代码 ...
$parameters= array();
$parameters['nonce']    = usecTime();
$data = http_build_query($parameters); // 构建POST数据字符串

$httpHeaders = array(
    'Api-Key: '   . $apiKey,
    'Api-Sign:'   . base64_encode(hash_hmac('sha512', $endpoint . chr(0) . $data, $apiSecret)), // 签名使用 $data
);
// ... 省略部分cURL设置 ...
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data); // POST数据通过 CURLOPT_POSTFIELDS 设置
// ...
?>

func Call(c appengine.Context) map[string]interface{} {
    // ... 省略部分代码 ...
    values := url.Values{}
    values.Set("nonce", strconv.FormatInt(time.Now().UnixNano()/1000, 10))
    signature:=GenerateSignatureFromValues(apiSecret, endpoint, values) // 签名基于 values
    req, _:=http.NewRequest("POST", serverURL+endpoint, nil) // 请求体设置为 nil
    req.Form=values // 尝试通过 req.Form 设置 POST 数据
    req.Header.Set("Api-Key", apiKey)
    req.Header.Set("Api-Sign", signature)
    // ...
}

// Form contains the parsed form data, including both the URL
// field's query parameters and the POST or PUT form data.
// This field is only available after ParseForm is called.
// The HTTP client ignores Form and uses Body instead.
Form url.Values

package main

import (
    "bytes"
    "crypto/hmac"
    "crypto/sha512"
    "encoding/base64"
    "encoding/hex"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
    "strconv"
    "strings"
    "time"

    "google.golang.org/appengine" // 假设仍在GAE环境
    "google.golang.org/appengine/urlfetch"
)

// GenerateSignatureFromValues 生成API签名
func GenerateSignatureFromValues(secretKey string, endpoint string, values url.Values) string {
    // 确保这里的 query 变量与请求体中的数据完全一致
    query := []byte(values.Encode())
    toEncode := []byte(endpoint)
    toEncode = append(toEncode, 0x00)
    toEncode = append(toEncode, query...)
    key := []byte(secretKey)
    hmacHash := hmac.New(sha512.New, key)
    hmacHash.Write(toEncode)
    answer := hmacHash.Sum(nil)
    // 注意：原始PHP代码中没有 strings.ToLower(hex.EncodeToString(answer))，
    // 如果服务器期望的是原始的hex编码，则应移除 ToLower。
    // 这里保留原始Go代码的逻辑，但需要根据实际API文档确认。
    return base64.StdEncoding.EncodeToString(([]byte(strings.ToLower(hex.EncodeToString(answer)))))
}

// Call 函数用于发起API请求
func Call(c appengine.Context) (map[string]interface{}, error) {
    serverURL := "https://api.vaultofsatoshi.com" // 替换为实际API地址
    apiKey := "ENTER_YOUR_API_KEY_HERE"          // 替换为你的API Key
    apiSecret := "ENTER_YOUR_API_SECRET_HERE"    // 替换为你的API Secret
    endpoint := "/info/order_detail"             // 替换为实际API端点

    // 1. 构建 url.Values
    values := url.Values{}
    values.Set("nonce", strconv.FormatInt(time.Now().UnixNano()/1000, 10))

    // 2. 将 url.Values 编码为字符串，并用于签名和请求体
    encodedData := values.Encode() // 编码一次，确保签名和请求体数据一致

    // 3. 生成签名
    signature := GenerateSignatureFromValues(apiSecret, endpoint, values) // 注意：这里传递的是 values，GenerateSignatureFromValues 内部会再次 Encode。
                                                                       // 更好的做法是 GenerateSignatureFromValues 直接接收 encodedData 字符串，
                                                                       // 以避免潜在的二次编码顺序问题。
                                                                       // 见下文“重要注意事项”。

    // 4. 创建请求体
    reqBody := bytes.NewBufferString(encodedData)

    // 5. 创建 http.Request，并传入请求体
    req, err := http.NewRequest("POST", serverURL+endpoint, reqBody)
    if err != nil {
        c.Errorf("Error creating request: %s", err)
        return nil, err
    }

    // 6. 设置请求头
    req.Header.Set("Api-Key", apiKey)
    req.Header.Set("Api-Sign", signature)
    // POST表单数据通常需要设置 Content-Type
    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("User-Agent", "something specific to me") // 模拟PHP的User-Agent设置

    // 7. 发送请求
    tr := urlfetch.Transport{Context: c} // 适用于Google App Engine
    resp, err := tr.RoundTrip(req)
    if err != nil {
        c.Errorf("API post error: %s", err)
        return nil, err
    }
    defer resp.Body.Close()

    // 8. 读取响应
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        c.Errorf("Error reading response body: %s", err)
        return nil, err
    }

    // 9. 解析JSON响应
    result := make(map[string]interface{})
    if err := json.Unmarshal(body, &result); err != nil {
        c.Errorf("Error unmarshaling JSON: %s", err)
        return nil, err
    }
    return result, nil
}

// 示例调用 (在 main 函数或测试中)
func main() {
    // 假设在 App Engine 环境中运行，这里只是一个占位符
    // context.Background() 或 mock context 用于本地测试
    // ctx := context.Background()
    // result, err := Call(appengine.NewContext(ctx))
    // if err != nil {
    //     fmt.Println("API Call failed:", err)
    //     return
    // }
    // fmt.Printf("API Response: %+v\n", result)
}