设置 XAP SDK

软件开发套件简化了集成，因此您可以快速将产品推向市场

1. 设置 Java 开发环境

您的开发环境需要 Java 8 或更高版本。您可以使用 Apache Maven 或 Gradle 为项目配置 SDK 依赖项。

2. 创建服务客户端并配置凭据

所有 API 请求都必须使用 API 客户端 ID 和密钥进行身份验证。创建一个 XapClient 并使用凭据进行配置。

XapClient xapClient =
    XapClient
        .builder()
        .key("KEY")
        .secret("SECRET")
        .build();

（可选）2.1. 配置超时时间

您可以为该服务客户端配置不同的请求、连接和套接字超时时间。

2.1.1. 配置请求超时时间

请求超时时间是指从发出请求开始到响应完成的时间段。默认值为无限（即，无超时时间）。

XapClient xapClient=
    XapClient
        .builder()
        .requestTimeout(90_000) // 90 seconds
        .key("KEY")
        .secret("SECRET")
        .build();

2.1.2. 配置连接超时时间

连接超时时间是指从发出请求开始到与服务器建立连接的时间段。默认值为 10000 毫秒（10 秒）。

XapClient xapClient=
    XapClient
        .builder()
        .connectionTimeout(30_000) // 30 seconds
        .key("KEY")
        .secret("SECRET")
        .build();

2.1.3. 配置套接字超时时间

套接字超时时间是指在与服务器交换数据时，两个连续数据包之间的最长不活动时间。默认值为 15000 毫秒（15 秒）。

XapClient xapClient=
    XapClient
        .builder()
        .socketTimeout(30_000) // 30 seconds
        .key("KEY")
        .secret("SECRET")
        .build();

3. 构建请求操作并进行 API 调用

使用 SDK 中定义的类生成您的请求对象，并借助服务客户端用其进行 API 调用。

GetLodgingListingsOperationParams getLodgingListingsOperationParams
        = GetLodgingListingsOperationParams
            .builder()
            .partnerTransactionId("PARTNER TRANSACTION ID")
            .locationKeyword("LOCATION KEYWORD")
            .build();

GetLodgingListingsOperation getLodgingListingsOperation =
        new GetLodgingListingsOperation(getLodgingListingsOperationParams);

Response<HotelListingsResponse> hotelListingsResponse =
        client.execute(getLodgingListingsOperation);

需要更多信息？请查看我们的使用示例。要深入了解 API 调用，请配置日志记录。