api

func GetRawBytes ¶

func GetRawBytes(c *client.Client, method, url string, params url.Values) (respBytes []byte, err error)

GetRawBytes executes an API request and returns the serialized byte array 执行API请求并返回序列化后的字节数组

参数说明 (Parameters):

c - 客户端实例, 用于发起HTTP请求 (Client instance for initiating HTTP requests)
method - HTTP请求方法（如GET/POST/PUT等） (HTTP request method (e.g. GET/POST/PUT))
url - 请求的目标URL地址 (Target URL address for the request)
params - URL查询参数 (URL query parameters)

返回值 (Returns):

respBytes - API响应序列化后的字节数组 (Serialized byte array of API response)
err - 执行过程中的错误，包含：
      1. 客户端请求错误(如网络错误、超时)
      2. 响应数据序列化错误(包装ue.ErrAPIResponse)
err - Error during execution, including:
      1. Client request errors (e.g. network error, timeout)
      2. Response data serialization error (wrapped with ue.ErrAPIResponse)

func GetRawModel ¶

func GetRawModel[T any](c *client.Client, method, reqUrl string, params url.Values) (T, error)

GetRawModel is a generic API request method that deserializes response data into a struct of the specified type 通用API请求方法, 将响应数据反序列化为指定类型的结构体

泛型参数 (Generic Parameters):

T - 目标反序列化的结构体类型，需满足：
    1. 字段首字母大写(可导出)
    2. 字段需匹配API响应的JSON结构(可通过json tag映射)
T - Target struct type for deserialization, which must satisfy:
    1. Field names are uppercase (exportable)
    2. Fields match the JSON structure of API response (mappable via json tag)

参数说明 (Parameters):

c - 客户端实例，用于发起HTTP请求 (Client instance for initiating HTTP requests)
method - HTTP请求方法（如GET/POST/PUT等） (HTTP request method (e.g. GET/POST/PUT))
reqUrl - 请求的目标URL地址 (Target URL address for the request)
params - URL查询参数 (URL query parameters)

返回值 (Returns):

T - 反序列化后的目标类型实例，错误时返回该类型的零值
err - 执行过程中的错误，包含：
      1. GetRawBytes返回的所有错误类型
      2. 响应数据反序列化错误(包装ue.ErrAPIResponse)
T - Instance of the target type after deserialization, returns zero value of the type on error
err - Error during execution, including:
      1. All error types returned by GetRawBytes
      2. Response data deserialization error (wrapped with ue.ErrAPIResponse)