XAP SDKのセットアップ

ソフトウェア開発キットにより統合が簡単になるため、製品を迅速に市場に投入できます

1. Java 開発環境を設定する

開発環境には Java 8 以降が必要です。Apache Maven か Gradle を使用して、プロジェクトの SDK 依存関係を構成できます。

サービスクライアントを作成してログイン情報を構成する

API クライアント ID とシークレットを使用してすべての API リクエストを認証する必要があります。XapClient を作成し、ログイン情報で構成します。

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

(省略可) 2.1. タイムアウトを構成する

サービスクライアントでは、リクエスト、接続、ソケットでそれぞれ異なるタイムアウトを構成できます。

2.1.1.リクエストタイムアウトを構成する

リクエストタイムアウトとは、リクエストが開始されてからレスポンスが完了するまでの期間のことです。デフォルト値は infinite (タイムアウトなし) です。

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

2.1.2. 接続タイムアウトを構成する

接続タイムアウトとは、リクエストが開始されてからサーバーとの接続が確立されるまでの期間のことです。デフォルト値は 10,000 ミリ秒 (10 秒) です。

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

2.1.3. ソケットタイムアウトを構成する

ソケットタイムアウトとは、サーバーとデータを交換する際の 2 つの連続したデータパケット間の最大非アクティブ期間のことです。デフォルト値は 15,000 ミリ秒 (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 コールをよりきめ細かく把握するには、ロギングを構成します。