# 沃尔玛卡券API

<cite>
**本文档引用文件**  
- [card-walmart-account.ts](file://src/api/card-walmart-account.ts)
- [card-walmart-order.ts](file://src/api/card-walmart-order.ts)
- [kami-api-card-info-walmart-v1-account-create-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-create-req.ts)
- [kami-api-card-info-walmart-v1-account-list-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-list-req.ts)
- [kami-api-card-info-walmart-v1-account-status-detect-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-status-detect-req.ts)
- [kami-api-card-info-walmart-v1-account-daily-summary-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-daily-summary-req.ts)
- [kami-api-card-info-walmart-v1-group-add-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-group-add-req.ts)
- [kami-api-card-info-walmart-v1-order-history-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-order-history-req.ts)
- [kami-api-card-info-walmart-v1-order-status-reset-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-order-status-reset-req.ts)
- [kami-api-card-info-walmart-v1-order-export-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-order-export-req.ts)
- [kami-api-card-info-walmart-v1-group-stat-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-group-stat-req.ts)
- [kami-api-card-info-walmart-v1-account-update-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-update-req.ts)
- [kami-api-card-info-walmart-v1-redeem-config-get-res.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-redeem-config-get-res.ts)
</cite>

## 目录

1. [简介](#简介)
2. [账户管理API](#账户管理api)
3. [订单处理API](#订单处理api)
4. [账户组统计API](#账户组统计api)
5. [分页与数据过滤](#分页与数据过滤)
6. [常见错误排查](#常见错误排查)

## 简介

沃尔玛卡券API提供了一套完整的接口，用于管理沃尔玛账户和处理卡券订单。该API支持账户的创建、状态检测、每日摘要查询、组管理等操作，同时也涵盖了订单历史查询、状态重置、订单导出等功能。通过这些API，开发者可以实现对沃尔玛卡券的全面管理。

## 账户管理API

账户管理API提供了对沃尔玛账户的全面管理功能，包括账户的创建、更新、删除、状态检测和分组管理等操作。

### 账户创建

创建新的沃尔玛账户，需要提供必要的账户信息。

```mermaid
flowchart TD
Start([开始]) --> ValidateInput["验证输入参数"]
ValidateInput --> CheckCookie["检查Cookie有效性"]
CheckCookie --> CreateAccount["创建账户"]
CreateAccount --> SetGroup["设置分组"]
SetGroup --> SetLimits["设置充值限制"]
SetLimits --> SaveAccount["保存账户信息"]
SaveAccount --> ReturnResult["返回创建结果"]
```

**图示来源**

- [card-walmart-account.ts](file://src/api/card-walmart-account.ts#L40-L42)
- [kami-api-card-info-walmart-v1-account-create-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-create-req.ts#L19-L62)

### 账户更新

更新现有沃尔玛账户的信息。

```mermaid
flowchart TD
Start([开始]) --> FindAccount["查找账户"]
FindAccount --> ValidateInput["验证输入参数"]
ValidateInput --> UpdateInfo["更新账户信息"]
UpdateInfo --> UpdateLimits["更新充值限制"]
UpdateLimits --> SaveChanges["保存更改"]
SaveChanges --> ReturnResult["返回更新结果"]
```

**图示来源**

- [card-walmart-account.ts](file://src/api/card-walmart-account.ts#L44-L48)
- [kami-api-card-info-walmart-v1-account-update-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-update-req.ts#L19-L68)

### 账户状态检测

检测沃尔玛账户的当前状态。

```mermaid
flowchart TD
Start([开始]) --> GetAccountId["获取账户ID"]
GetAccountId --> CheckStatus["检查账户状态"]
CheckStatus --> RefreshData["刷新账户数据"]
RefreshData --> ReturnStatus["返回状态信息"]
```

**图示来源**

- [card-walmart-account.ts](file://src/api/card-walmart-account.ts#L90-L92)
- [kami-api-card-info-walmart-v1-account-status-detect-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-status-detect-req.ts#L19-L26)

### 账户分组管理

管理沃尔玛账户的分组，包括创建新分组和管理现有分组。

```mermaid
flowchart TD
Start([开始]) --> CreateGroup["创建分组"]
CreateGroup --> SetGroupName["设置分组名称"]
SetGroupName --> AddDescription["添加描述"]
AddDescription --> SaveGroup["保存分组信息"]
SaveGroup --> ReturnResult["返回创建结果"]
```

**图示来源**

- [kami-api-card-info-walmart-v1-group-add-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-group-add-req.ts#L19-L32)

**本节来源**

- [card-walmart-account.ts](file://src/api/card-walmart-account.ts)
- [kami-api-card-info-walmart-v1-account-create-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-create-req.ts)
- [kami-api-card-info-walmart-v1-account-update-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-update-req.ts)
- [kami-api-card-info-walmart-v1-account-status-detect-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-status-detect-req.ts)
- [kami-api-card-info-walmart-v1-group-add-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-group-add-req.ts)

## 订单处理API

订单处理API提供了对沃尔玛卡券订单的全面管理功能，包括订单历史查询、状态重置和订单导出等操作。

### 订单历史查询

查询沃尔玛卡券的订单历史记录。

```mermaid
flowchart TD
Start([开始]) --> GetOrderNo["获取订单号"]
GetOrderNo --> SearchOrder["搜索订单"]
SearchOrder --> RetrieveHistory["获取历史记录"]
RetrieveHistory --> FormatData["格式化数据"]
FormatData --> ReturnResult["返回查询结果"]
```

**图示来源**

- [card-walmart-order.ts](file://src/api/card-walmart-order.ts#L107-L116)
- [kami-api-card-info-walmart-v1-order-history-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-order-history-req.ts#L19-L26)

### 订单状态重置

重置沃尔玛卡券订单的状态。

```mermaid
flowchart TD
Start([开始]) --> GetOrderId["获取订单ID"]
GetOrderId --> FindOrder["查找订单"]
FindOrder --> ResetStatus["重置状态"]
ResetStatus --> UpdateRecord["更新记录"]
UpdateRecord --> ReturnResult["返回重置结果"]
```

**图示来源**

- [kami-api-card-info-walmart-v1-order-status-reset-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-order-status-reset-req.ts#L19-L26)

### 订单导出

导出沃尔玛卡券订单数据。

```mermaid
flowchart TD
Start([开始]) --> SetFilters["设置过滤条件"]
SetFilters --> SelectFields["选择导出字段"]
SelectFields --> ApplyPagination["应用分页"]
ApplyPagination --> GenerateData["生成数据"]
GenerateData --> ExportFile["导出文件"]
ExportFile --> ReturnResult["返回导出结果"]
```

**图示来源**

- [kami-api-card-info-walmart-v1-order-export-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-order-export-req.ts#L19-L80)

**本节来源**

- [card-walmart-order.ts](file://src/api/card-walmart-order.ts)
- [kami-api-card-info-walmart-v1-order-history-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-order-history-req.ts)
- [kami-api-card-info-walmart-v1-order-status-reset-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-order-status-reset-req.ts)
- [kami-api-card-info-walmart-v1-order-export-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-order-export-req.ts)

## 账户组统计API

账户组统计API提供了对沃尔玛账户组的统计分析功能，包括组内账户和订单的统计。

### 组统计查询

查询沃尔玛账户组的统计信息。

```mermaid
flowchart TD
Start([开始]) --> SetGroupFilter["设置分组过滤"]
SetGroupFilter --> ApplyDateRange["应用日期范围"]
ApplyDateRange --> CalculateStats["计算统计"]
CalculateStats --> AggregateData["聚合数据"]
AggregateData --> ReturnResult["返回统计结果"]
```

**图示来源**

- [kami-api-card-info-walmart-v1-group-stat-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-group-stat-req.ts#L19-L56)

**本节来源**

- [kami-api-card-info-walmart-v1-group-stat-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-group-stat-req.ts)

## 分页与数据过滤

沃尔玛卡券API支持分页和数据过滤功能，以提高数据查询的效率和灵活性。

### 分页机制

API使用标准的分页参数来控制返回的数据量。

```mermaid
flowchart TD
Start([开始]) --> SetCurrentPage["设置当前页码"]
SetCurrentPage --> SetPageSize["设置每页大小"]
SetPageSize --> ValidateParams["验证参数"]
ValidateParams --> QueryData["查询数据"]
QueryData --> ReturnPage["返回分页结果"]
```

**图示来源**

- [kami-api-card-info-walmart-v1-account-list-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-list-req.ts#L19-L68)
- [kami-api-card-info-walmart-v1-account-daily-summary-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-daily-summary-req.ts#L19-L56)

### 数据过滤

API支持多种数据过滤参数，以便精确查询所需数据。

```mermaid
flowchart TD
Start([开始]) --> SetFilters["设置过滤条件"]
SetFilters --> ApplyNameFilter["应用名称过滤"]
ApplyNameFilter --> ApplyDateFilter["应用日期过滤"]
ApplyDateFilter --> ApplyStatusFilter["应用状态过滤"]
ApplyStatusFilter --> QueryData["查询数据"]
QueryData --> ReturnResult["返回过滤结果"]
```

**图示来源**

- [kami-api-card-info-walmart-v1-account-list-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-list-req.ts#L19-L68)

**本节来源**

- [kami-api-card-info-walmart-v1-account-list-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-list-req.ts)
- [kami-api-card-info-walmart-v1-account-daily-summary-req.ts](file://src/api/generated/models/kami-api-card-info-walmart-v1-account-daily-summary-req.ts)

## 常见错误排查

### Cookie无效

当账户Cookie无效时，API会返回相应的错误信息。

```mermaid
flowchart TD
Start([开始]) --> CheckCookie["检查Cookie"]
CheckCookie --> IsValid["Cookie是否有效?"]
IsValid --> |否| ReturnError["返回Cookie无效错误"]
IsValid --> |是| Continue["继续处理"]
```

**图示来源**

- [card-walmart-account.ts](file://src/api/card-walmart-account.ts#L112-L116)

### 账户不存在

当尝试操作不存在的账户时，API会返回账户不存在的错误。

```mermaid
flowchart TD
Start([开始]) --> FindAccount["查找账户"]
FindAccount --> Exists["账户是否存在?"]
Exists --> |否| ReturnError["返回账户不存在错误"]
Exists --> |是| Continue["继续处理"]
```

**图示来源**

- [card-walmart-account.ts](file://src/api/card-walmart-account.ts#L59-L69)

### 权限不足

当用户权限不足时，API会返回权限错误。

```mermaid
flowchart TD
Start([开始]) --> CheckPermission["检查权限"]
CheckPermission --> HasPermission["是否有权限?"]
HasPermission --> |否| ReturnError["返回权限不足错误"]
HasPermission --> |是| Continue["继续处理"]
```

**本节来源**

- [card-walmart-account.ts](file://src/api/card-walmart-account.ts)
- [card-walmart-order.ts](file://src/api/card-walmart-order.ts)
