# api-vaas

**Repository Path**: bukcn/api-vaas

## Basic Information

- **Project Name**: api-vaas
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# api-vaas

机场增值服务（VAS）系统 Java SDK，封装了机场服务产品和租车服务的 API 接口调用。

## 功能

**机场服务 (AirportService)**
- 查询服务产品列表
- 查询账户余额
- 创建服务订单
- 查询订单详情
- 取消服务订单

**租车服务 (RentalCarService)**
- 查询提供租车服务的城市
- 查询租车报价

## 使用方式

### Maven 依赖

```xml
<dependency>
    <groupId>cn.buk.api.vaas</groupId>
    <artifactId>api-vaas</artifactId>
    <version>2.0.0</version>
</dependency>
```

### 机场服务示例

```java
AirportService airportService = new AirportServiceImpl(apiBaseUrl, username, secretKey);
// 查询服务产品
ServiceProductResponse products = airportService.getServiceProducts();
// 查询账户余额
String balance = airportService.getAccountBalance();
// 创建服务订单
VasOrderDto orderDto = new VasOrderDto();
// ... 填充订单信息
VasOrderCreateResponse response = airportService.createServiceOrder(orderDto);
// 查询订单详情
VasOrderResponse order = airportService.getServiceOrder(orderNo);
// 取消订单
BaseResponse result = airportService.cancelServiceOrder(orderNo, "取消原因");
```

### 租车服务示例

```java
RentalCarService rentalCarService = new RentalCarServiceImpl(apiBaseUrl, username, secretKey);
// 查询可租车城市
List<CityDto> cities = rentalCarService.searchRentalCities();
// 查询租车价格
CarOrderResponse price = rentalCarService.searchRentalPrice(useType, cityId, airportCode,
        terminalNo, flightNo, departure, arrival, useDateTime);
```

## 构建

```bash
# 编译
mvn clean compile

# 运行测试
mvn clean test

# 跳过测试编译打包
mvn clean package -DskipTests
```

## 发布

```bash
mvn clean deploy -DskipTests
```

## 环境要求

- JDK 21+
- Maven 3.6+