z8018
2026-02-11 b8fb68b44c29e4667f6ea5746119413809a60a9e
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
using System.ComponentModel.DataAnnotations;
 
namespace KH.WMS.Core.Api.Responses;
 
/// <summary>
/// API 统一响应格式
/// </summary>
public class ApiResponse
{
    /// <summary>
    /// 响应码
    /// </summary>
    public string Code { get; set; } = "200";
 
    /// <summary>
    /// 响应消息
    /// </summary>
    public string Message { get; set; } = "操作成功";
 
    /// <summary>
    /// 时间戳
    /// </summary>
    public long Timestamp { get; set; } = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
 
    /// <summary>
    /// 响应数据
    /// </summary>
    public object? Data { get; set; }
 
    /// <summary>
    /// 请求跟踪ID
    /// </summary>
    public string? TraceId { get; set; }
 
    /// <summary>
    /// 创建成功响应
    /// </summary>
    public static ApiResponse Ok(object? data = null, string message = "操作成功")
    {
        return new ApiResponse
        {
            Code = "200",
            Message = message,
            Data = data
        };
    }
 
    /// <summary>
    /// 创建失败响应
    /// </summary>
    public static ApiResponse Fail(string code, string message)
    {
        return new ApiResponse
        {
            Code = code,
            Message = message
        };
    }
 
}
 
/// <summary>
/// API 泛型响应格式
/// </summary>
public class ApiResponse<T> : ApiResponse
{
    /// <summary>
    /// 响应数据
    /// </summary>
    public new T? Data { get; set; }
 
    /// <summary>
    /// 创建成功响应
    /// </summary>
    public static ApiResponse<T> Ok(T? data, string message = "操作成功")
    {
        return new ApiResponse<T>
        {
            Code = "200",
            Message = message,
            Data = data
        };
    }
 
    /// <summary>
    /// 创建失败响应
    /// </summary>
    public static new ApiResponse<T> Fail(string code, string message)
    {
        return new ApiResponse<T>
        {
            Code = code,
            Message = message
        };
    }
}