feat(api): 添加京东订单历史查询接口

- 新增获取京东订单历史记录的请求和响应模型 - 在API客户端中实现订单历史查询功能 - 更新API文档以包含新的订单历史接口说明 - 添加订单历史信息的数据结构定义 - 实现与京东订单历史相关的类型定义和接口调用方法
2025-10-09 20:06:34 +08:00
parent c430cc796c
commit 88cefd7042
11 changed files with 409 additions and 1 deletions
--- a/src/api/generated/.openapi-generator/FILES
+++ b/src/api/generated/.openapi-generator/FILES
@@ -240,6 +240,8 @@ docs/KamiApiJdCookieV1CreateOrderRes.md
 docs/KamiApiJdCookieV1DeleteAccountReq.md
 docs/KamiApiJdCookieV1GetAccountReq.md
 docs/KamiApiJdCookieV1GetAccountRes.md
+docs/KamiApiJdCookieV1GetJdOrderHistoryReq.md
+docs/KamiApiJdCookieV1GetJdOrderHistoryRes.md
 docs/KamiApiJdCookieV1GetJdOrderReq.md
 docs/KamiApiJdCookieV1GetJdOrderRes.md
 docs/KamiApiJdCookieV1GetOrderReq.md
@@ -248,6 +250,7 @@ docs/KamiApiJdCookieV1GetOrderStatusReq.md
 docs/KamiApiJdCookieV1GetOrderStatusRes.md
 docs/KamiApiJdCookieV1GetPaymentUrlReq.md
 docs/KamiApiJdCookieV1GetPaymentUrlRes.md
+docs/KamiApiJdCookieV1JdOrderHistoryInfo.md
 docs/KamiApiJdCookieV1JdOrderInfo.md
 docs/KamiApiJdCookieV1ListAccountReq.md
 docs/KamiApiJdCookieV1ListAccountRes.md
@@ -613,6 +616,8 @@ models/kami-api-jd-cookie-v1-create-order-res.ts
 models/kami-api-jd-cookie-v1-delete-account-req.ts
 models/kami-api-jd-cookie-v1-get-account-req.ts
 models/kami-api-jd-cookie-v1-get-account-res.ts
+models/kami-api-jd-cookie-v1-get-jd-order-history-req.ts
+models/kami-api-jd-cookie-v1-get-jd-order-history-res.ts
 models/kami-api-jd-cookie-v1-get-jd-order-req.ts
 models/kami-api-jd-cookie-v1-get-jd-order-res.ts
 models/kami-api-jd-cookie-v1-get-order-req.ts
@@ -621,6 +626,7 @@ models/kami-api-jd-cookie-v1-get-order-status-req.ts
 models/kami-api-jd-cookie-v1-get-order-status-res.ts
 models/kami-api-jd-cookie-v1-get-payment-url-req.ts
 models/kami-api-jd-cookie-v1-get-payment-url-res.ts
+models/kami-api-jd-cookie-v1-jd-order-history-info.ts
 models/kami-api-jd-cookie-v1-jd-order-info.ts
 models/kami-api-jd-cookie-v1-list-account-req.ts
 models/kami-api-jd-cookie-v1-list-account-res.ts
--- a/src/api/generated/apis/jdorder-management-api.ts
+++ b/src/api/generated/apis/jdorder-management-api.ts
@@ -47,6 +47,8 @@ import type { KamiApiJdCookieV1CreateOrderReq } from '../models';
 // @ts-ignore
 import type { KamiApiJdCookieV1CreateOrderRes } from '../models';
 // @ts-ignore
+import type { KamiApiJdCookieV1GetJdOrderHistoryRes } from '../models';
+// @ts-ignore
 import type { KamiApiJdCookieV1GetJdOrderRes } from '../models';
 // @ts-ignore
 import type { KamiApiJdCookieV1GetOrderRes } from '../models';
@@ -207,6 +209,69 @@ export const JDOrderManagementApiAxiosParamCreator = function (
        options: localVarRequestOptions
      };
    },
+    /**
+     *
+     * @summary Get JD Order History
+     * @param {string} orderId 订单号
+     * @param {number} [page] 页码
+     * @param {number} [size] 每页大小
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    apiJdCookieOrderJdOrderHistoryGet: async (
+      orderId: string,
+      page?: number,
+      size?: number,
+      options: RawAxiosRequestConfig = {}
+    ): Promise<RequestArgs> => {
+      // verify required parameter 'orderId' is not null or undefined
+      assertParamExists(
+        'apiJdCookieOrderJdOrderHistoryGet',
+        'orderId',
+        orderId
+      );
+      const localVarPath = `/api/jd-cookie/order/jd-order-history`;
+      // use dummy base URL string because the URL constructor only accepts absolute URLs.
+      const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+      let baseOptions;
+      if (configuration) {
+        baseOptions = configuration.baseOptions;
+      }
+
+      const localVarRequestOptions = {
+        method: 'GET',
+        ...baseOptions,
+        ...options
+      };
+      const localVarHeaderParameter = {} as any;
+      const localVarQueryParameter = {} as any;
+
+      if (orderId !== undefined) {
+        localVarQueryParameter['orderId'] = orderId;
+      }
+
+      if (page !== undefined) {
+        localVarQueryParameter['page'] = page;
+      }
+
+      if (size !== undefined) {
+        localVarQueryParameter['size'] = size;
+      }
+
+      setSearchParams(localVarUrlObj, localVarQueryParameter);
+      let headersFromBaseOptions =
+        baseOptions && baseOptions.headers ? baseOptions.headers : {};
+      localVarRequestOptions.headers = {
+        ...localVarHeaderParameter,
+        ...headersFromBaseOptions,
+        ...options.headers
+      };
+
+      return {
+        url: toPathString(localVarUrlObj),
+        options: localVarRequestOptions
+      };
+    },
    /**
     *
     * @summary Check JD Order Payment Status
@@ -531,6 +596,46 @@ export const JDOrderManagementApiFp = function (configuration?: Configuration) {
          configuration
        )(axios, localVarOperationServerBasePath || basePath);
    },
+    /**
+     *
+     * @summary Get JD Order History
+     * @param {string} orderId 订单号
+     * @param {number} [page] 页码
+     * @param {number} [size] 每页大小
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    async apiJdCookieOrderJdOrderHistoryGet(
+      orderId: string,
+      page?: number,
+      size?: number,
+      options?: RawAxiosRequestConfig
+    ): Promise<
+      (
+        axios?: AxiosInstance,
+        basePath?: string
+      ) => AxiosPromise<KamiApiJdCookieV1GetJdOrderHistoryRes>
+    > {
+      const localVarAxiosArgs =
+        await localVarAxiosParamCreator.apiJdCookieOrderJdOrderHistoryGet(
+          orderId,
+          page,
+          size,
+          options
+        );
+      const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+      const localVarOperationServerBasePath =
+        operationServerMap[
+          'JDOrderManagementApi.apiJdCookieOrderJdOrderHistoryGet'
+        ]?.[localVarOperationServerIndex]?.url;
+      return (axios, basePath) =>
+        createRequestFunction(
+          localVarAxiosArgs,
+          globalAxios,
+          BASE_PATH,
+          configuration
+        )(axios, localVarOperationServerBasePath || basePath);
+    },
    /**
     *
     * @summary Check JD Order Payment Status
@@ -740,6 +845,26 @@ export const JDOrderManagementApiFactory = function (
        .apiJdCookieOrderJdOrderGet(requestParameters.jdOrderId, options)
        .then(request => request(axios, basePath));
    },
+    /**
+     *
+     * @summary Get JD Order History
+     * @param {JDOrderManagementApiApiJdCookieOrderJdOrderHistoryGetRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    apiJdCookieOrderJdOrderHistoryGet(
+      requestParameters: JDOrderManagementApiApiJdCookieOrderJdOrderHistoryGetRequest,
+      options?: RawAxiosRequestConfig
+    ): AxiosPromise<KamiApiJdCookieV1GetJdOrderHistoryRes> {
+      return localVarFp
+        .apiJdCookieOrderJdOrderHistoryGet(
+          requestParameters.orderId,
+          requestParameters.page,
+          requestParameters.size,
+          options
+        )
+        .then(request => request(axios, basePath));
+    },
    /**
     *
     * @summary Check JD Order Payment Status
@@ -856,6 +981,18 @@ export interface JDOrderManagementApiInterface {
    options?: RawAxiosRequestConfig
  ): AxiosPromise<KamiApiJdCookieV1GetJdOrderRes>;

+  /**
+   *
+   * @summary Get JD Order History
+   * @param {JDOrderManagementApiApiJdCookieOrderJdOrderHistoryGetRequest} requestParameters Request parameters.
+   * @param {*} [options] Override http request option.
+   * @throws {RequiredError}
+   */
+  apiJdCookieOrderJdOrderHistoryGet(
+    requestParameters: JDOrderManagementApiApiJdCookieOrderJdOrderHistoryGetRequest,
+    options?: RawAxiosRequestConfig
+  ): AxiosPromise<KamiApiJdCookieV1GetJdOrderHistoryRes>;
+
  /**
   *
   * @summary Check JD Order Payment Status
@@ -932,6 +1069,26 @@ export interface JDOrderManagementApiApiJdCookieOrderJdOrderGetRequest {
  readonly jdOrderId: string;
 }

+/**
+ * Request parameters for apiJdCookieOrderJdOrderHistoryGet operation in JDOrderManagementApi.
+ */
+export interface JDOrderManagementApiApiJdCookieOrderJdOrderHistoryGetRequest {
+  /**
+   * 订单号
+   */
+  readonly orderId: string;
+
+  /**
+   * 页码
+   */
+  readonly page?: number;
+
+  /**
+   * 每页大小
+   */
+  readonly size?: number;
+}
+
 /**
 * Request parameters for apiJdCookieOrderJdPaymentStatusPost operation in JDOrderManagementApi.
 */
@@ -1044,6 +1201,27 @@ export class JDOrderManagementApi
      .then(request => request(this.axios, this.basePath));
  }

+  /**
+   *
+   * @summary Get JD Order History
+   * @param {JDOrderManagementApiApiJdCookieOrderJdOrderHistoryGetRequest} requestParameters Request parameters.
+   * @param {*} [options] Override http request option.
+   * @throws {RequiredError}
+   */
+  public apiJdCookieOrderJdOrderHistoryGet(
+    requestParameters: JDOrderManagementApiApiJdCookieOrderJdOrderHistoryGetRequest,
+    options?: RawAxiosRequestConfig
+  ) {
+    return JDOrderManagementApiFp(this.configuration)
+      .apiJdCookieOrderJdOrderHistoryGet(
+        requestParameters.orderId,
+        requestParameters.page,
+        requestParameters.size,
+        options
+      )
+      .then(request => request(this.axios, this.basePath));
+  }
+
  /**
   *
   * @summary Check JD Order Payment Status
--- a/src/api/generated/docs/JDOrderManagementApi.md
+++ b/src/api/generated/docs/JDOrderManagementApi.md
@@ -7,6 +7,7 @@ All URIs are relative to _http://localhost_
 | [**apiJdCookieOrderCreatePost**](#apijdcookieordercreatepost)                   | **POST** /api/jd-cookie/order/create            | Create Order                  |
 | [**apiJdCookieOrderGetGet**](#apijdcookieordergetget)                           | **GET** /api/jd-cookie/order/get                | Get Single Order              |
 | [**apiJdCookieOrderJdOrderGet**](#apijdcookieorderjdorderget)                   | **GET** /api/jd-cookie/order/jd-order           | Get Single JD Order           |
+| [**apiJdCookieOrderJdOrderHistoryGet**](#apijdcookieorderjdorderhistoryget)     | **GET** /api/jd-cookie/order/jd-order-history   | Get JD Order History          |
 | [**apiJdCookieOrderJdPaymentStatusPost**](#apijdcookieorderjdpaymentstatuspost) | **POST** /api/jd-cookie/order/jd-payment-status | Check JD Order Payment Status |
 | [**apiJdCookieOrderListGet**](#apijdcookieorderlistget)                         | **GET** /api/jd-cookie/order/list               | Order List Query              |
 | [**apiJdCookieOrderPaymentUrlPost**](#apijdcookieorderpaymenturlpost)           | **POST** /api/jd-cookie/order/payment-url       | Get Payment URL               |
@@ -151,6 +152,58 @@ No authorization required

 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

+# **apiJdCookieOrderJdOrderHistoryGet**
+
+> KamiApiJdCookieV1GetJdOrderHistoryRes apiJdCookieOrderJdOrderHistoryGet()
+
+### Example
+
+```typescript
+import { JDOrderManagementApi, Configuration } from './api';
+
+const configuration = new Configuration();
+const apiInstance = new JDOrderManagementApi(configuration);
+
+let orderId: string; //订单号 (default to undefined)
+let page: number; //页码 (optional) (default to 1)
+let size: number; //每页大小 (optional) (default to 20)
+
+const { status, data } = await apiInstance.apiJdCookieOrderJdOrderHistoryGet(
+  orderId,
+  page,
+  size
+);
+```
+
+### Parameters
+
+| Name        | Type         | Description | Notes                     |
+| ----------- | ------------ | ----------- | ------------------------- |
+| **orderId** | [**string**] | 订单号      | defaults to undefined     |
+| **page**    | [**number**] | 页码        | (optional) defaults to 1  |
+| **size**    | [**number**] | 每页大小    | (optional) defaults to 20 |
+
+### Return type
+
+**KamiApiJdCookieV1GetJdOrderHistoryRes**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+### HTTP response details
+
+| Status code | Description | Response headers |
+| ----------- | ----------- | ---------------- |
+| **200**     |             | -                |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **apiJdCookieOrderJdPaymentStatusPost**

 > KamiApiJdCookieV1CheckJdOrderPaymentRes apiJdCookieOrderJdPaymentStatusPost()
--- a/src/api/generated/docs/KamiApiJdCookieV1GetJdOrderHistoryReq.md
+++ b/src/api/generated/docs/KamiApiJdCookieV1GetJdOrderHistoryReq.md
@@ -0,0 +1,23 @@
+# KamiApiJdCookieV1GetJdOrderHistoryReq
+
+## Properties
+
+| Name        | Type       | Description | Notes                      |
+| ----------- | ---------- | ----------- | -------------------------- |
+| **orderId** | **string** | 订单号      | [default to undefined]     |
+| **page**    | **number** | 页码        | [optional] [default to 1]  |
+| **size**    | **number** | 每页大小    | [optional] [default to 20] |
+
+## Example
+
+```typescript
+import { KamiApiJdCookieV1GetJdOrderHistoryReq } from './api';
+
+const instance: KamiApiJdCookieV1GetJdOrderHistoryReq = {
+  orderId,
+  page,
+  size
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
--- a/src/api/generated/docs/KamiApiJdCookieV1GetJdOrderHistoryRes.md
+++ b/src/api/generated/docs/KamiApiJdCookieV1GetJdOrderHistoryRes.md
@@ -0,0 +1,21 @@
+# KamiApiJdCookieV1GetJdOrderHistoryRes
+
+## Properties
+
+| Name      | Type                                                                                           | Description      | Notes                             |
+| --------- | ---------------------------------------------------------------------------------------------- | ---------------- | --------------------------------- |
+| **list**  | [**Array&lt;KamiApiJdCookieV1JdOrderHistoryInfo&gt;**](KamiApiJdCookieV1JdOrderHistoryInfo.md) | 京东订单历史列表 | [optional] [default to undefined] |
+| **total** | **number**                                                                                     | 总数             | [optional] [default to undefined] |
+
+## Example
+
+```typescript
+import { KamiApiJdCookieV1GetJdOrderHistoryRes } from './api';
+
+const instance: KamiApiJdCookieV1GetJdOrderHistoryRes = {
+  list,
+  total
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
--- a/src/api/generated/docs/KamiApiJdCookieV1JdOrderHistoryInfo.md
+++ b/src/api/generated/docs/KamiApiJdCookieV1JdOrderHistoryInfo.md
@@ -0,0 +1,29 @@
+# KamiApiJdCookieV1JdOrderHistoryInfo
+
+## Properties
+
+| Name            | Type       | Description                                             | Notes                             |
+| --------------- | ---------- | ------------------------------------------------------- | --------------------------------- |
+| **historyUuid** | **string** | 历史记录唯一标识                                        | [optional] [default to undefined] |
+| **jdOrderId**   | **string** | 京东订单号                                              | [optional] [default to undefined] |
+| **changeType**  | **string** | 变更类型：create,bind,unbind,pay,expire,invalid,replace | [optional] [default to undefined] |
+| **orderId**     | **string** | 关联的订单号                                            | [optional] [default to undefined] |
+| **wxPayUrl**    | **string** | 微信支付链接                                            | [optional] [default to undefined] |
+| **createdAt**   | **string** | 创建时间                                                | [optional] [default to undefined] |
+
+## Example
+
+```typescript
+import { KamiApiJdCookieV1JdOrderHistoryInfo } from './api';
+
+const instance: KamiApiJdCookieV1JdOrderHistoryInfo = {
+  historyUuid,
+  jdOrderId,
+  changeType,
+  orderId,
+  wxPayUrl,
+  createdAt
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
--- a/src/api/generated/models/index.ts
+++ b/src/api/generated/models/index.ts
@@ -225,6 +225,8 @@ export * from './kami-api-jd-cookie-v1-create-order-res';
 export * from './kami-api-jd-cookie-v1-delete-account-req';
 export * from './kami-api-jd-cookie-v1-get-account-req';
 export * from './kami-api-jd-cookie-v1-get-account-res';
+export * from './kami-api-jd-cookie-v1-get-jd-order-history-req';
+export * from './kami-api-jd-cookie-v1-get-jd-order-history-res';
 export * from './kami-api-jd-cookie-v1-get-jd-order-req';
 export * from './kami-api-jd-cookie-v1-get-jd-order-res';
 export * from './kami-api-jd-cookie-v1-get-order-req';
@@ -233,6 +235,7 @@ export * from './kami-api-jd-cookie-v1-get-order-status-req';
 export * from './kami-api-jd-cookie-v1-get-order-status-res';
 export * from './kami-api-jd-cookie-v1-get-payment-url-req';
 export * from './kami-api-jd-cookie-v1-get-payment-url-res';
+export * from './kami-api-jd-cookie-v1-jd-order-history-info';
 export * from './kami-api-jd-cookie-v1-jd-order-info';
 export * from './kami-api-jd-cookie-v1-list-account-req';
 export * from './kami-api-jd-cookie-v1-list-account-res';
--- a/src/api/generated/models/kami-api-jd-cookie-v1-get-jd-order-history-req.ts
+++ b/src/api/generated/models/kami-api-jd-cookie-v1-get-jd-order-history-req.ts
@@ -0,0 +1,28 @@
+/* tslint:disable */
+
+/**
+ *
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document:
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+export interface KamiApiJdCookieV1GetJdOrderHistoryReq {
+  /**
+   * 订单号
+   */
+  orderId: string;
+  /**
+   * 页码
+   */
+  page?: number;
+  /**
+   * 每页大小
+   */
+  size?: number;
+}
--- a/src/api/generated/models/kami-api-jd-cookie-v1-get-jd-order-history-res.ts
+++ b/src/api/generated/models/kami-api-jd-cookie-v1-get-jd-order-history-res.ts
@@ -0,0 +1,28 @@
+/* tslint:disable */
+
+/**
+ *
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document:
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+// May contain unused imports in some cases
+// @ts-ignore
+import type { KamiApiJdCookieV1JdOrderHistoryInfo } from './kami-api-jd-cookie-v1-jd-order-history-info';
+
+export interface KamiApiJdCookieV1GetJdOrderHistoryRes {
+  /**
+   * 京东订单历史列表
+   */
+  list?: Array<KamiApiJdCookieV1JdOrderHistoryInfo>;
+  /**
+   * 总数
+   */
+  total?: number;
+}
--- a/src/api/generated/models/kami-api-jd-cookie-v1-jd-order-history-info.ts
+++ b/src/api/generated/models/kami-api-jd-cookie-v1-jd-order-history-info.ts
@@ -0,0 +1,40 @@
+/* tslint:disable */
+
+/**
+ *
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document:
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+export interface KamiApiJdCookieV1JdOrderHistoryInfo {
+  /**
+   * 历史记录唯一标识
+   */
+  historyUuid?: string;
+  /**
+   * 京东订单号
+   */
+  jdOrderId?: string;
+  /**
+   * 变更类型：create,bind,unbind,pay,expire,invalid,replace
+   */
+  changeType?: string;
+  /**
+   * 关联的订单号
+   */
+  orderId?: string;
+  /**
+   * 微信支付链接
+   */
+  wxPayUrl?: string;
+  /**
+   * 创建时间
+   */
+  createdAt?: string;
+}
--- a/src/views/user-center/management/summary.tsx
+++ b/src/views/user-center/management/summary.tsx
@@ -6,7 +6,6 @@ import type {
 import type { Pagination } from '@/types/global';
 import {
  Button,
-  Card,
  Col,
  DatePicker,
  Divider,