設定 XAP SDK

軟體開發工具組 (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 呼叫，請配置日誌記錄。