Merge pull request #252 from amadeus4dev/transfer-apis

Support for Transfer APIs

Author: tsolakoua

README.md

@@ -187,8 +187,8 @@ FlightDate[] flightDates = amadeus.shopping.flightDates.get(Params
 FlightOfferSearch[] flightOffersSearches = amadeus.shopping.flightOffersSearch.get(
               Params.with("originLocationCode", "SYD")
                       .and("destinationLocationCode", "BKK")
-                      .and("departureDate", "2022-09-01")
-                      .and("returnDate", "2022-09-08")
+                      .and("departureDate", "2023-11-01")
+                      .and("returnDate", "2023-11-08")
                       .and("adults", 2)
                       .and("max", 3));
 
@@ -214,8 +214,8 @@ FlightPrice[] flightPricing = amadeus.shopping.flightOffersSearch.pricing.post(
 FlightOfferSearch[] flightOffers = amadeus.shopping.flightOffersSearch.get(
               Params.with("originLocationCode", "NYC")
                       .and("destinationLocationCode", "MAD")
-                      .and("departureDate", "2021-04-01")
-                      .and("returnDate", "2021-04-08")
+                      .and("departureDate", "2024-04-01")
+                      .and("returnDate", "2024-04-08")
                       .and("adults", 1));
 
 // Using a JSonObject
@@ -319,7 +319,7 @@ Activity activity = amadeus.shopping.activity("4615").get();
 // What's the likelihood flights from this airport will leave on time?
 Prediction AirportOnTime = amadeus.airport.predictions.onTime.get(Params
     .with("airportCode", "NCE")
-    .and("date", "2021-04-01"));
+    .and("date", "2024-04-01"));
 
 // What's the likelihood of a given flight to be delayed?
 Prediction[] flightDelay = amadeus.travel.predictions.flightDelay.get(Params
@@ -354,8 +354,8 @@ SeatMap[] seatmap = amadeus.shopping.seatMaps.post(body);
 Prediction tripPurpose = amadeus.travel.predictions.tripPurpose.get(Params
     .with("originLocationCode", "NYC")
     .and("destinationLocationCode", "MAD")
-    .and("departureDate", "2021-04-01")
-    .and("returnDate", "2021-04-08"));
+    .and("departureDate", "2024-04-01")
+    .and("returnDate", "2024-04-08"));
 
 // Travel Recommendations
 Location destinations = amadeus.referenceData.recommendedLocations.get(Params
@@ -366,13 +366,13 @@ Location destinations = amadeus.referenceData.recommendedLocations.get(Params
 DatedFlight[] flightStatus = amadeus.schedule.flights.get(Params
     .with("carrierCode", "AZ")
     .and("flightNumber", "319")
-    .and("scheduledDepartureDate", "2021-03-13"));
+    .and("scheduledDepartureDate", "2024-03-13"));
 
 // Flight Price Analysis
 ItineraryPriceMetric[] metrics = amadeus.analytics.itineraryPriceMetrics.get(Params
     .with("originIataCode", "MAD")
     .and("destinationIataCode", "CDG")
-    .and("departureDate", "2021-03-21"));
+    .and("departureDate", "2024-03-21"));
 
 // Trip Parser v3 POST
 // body can be a String version of your JSON or a JsonObject or a compatible File object
@@ -428,7 +428,7 @@ Hotel[] result = amadeus.referenceData.locations.hotel.get(Params
 HotelOfferSearch[] offers = amadeus.shopping.hotelOffersSearch.get(Params
   .with("hotelIds", "MCLONGHM")
   .and("adults", 1)
-  .and("checkInDate", "2023-05-22")
+  .and("checkInDate", "2023-11-22")
   .and("roomQuantity", 1)
   .and("paymentPolicy", "NONE")
   .and("bestRateOnly", true));
@@ -447,6 +447,15 @@ HotelSentiment[] hotelSentiments = amadeus.ereputation.hotelSentiments.get(Param
 Destination[] destinations = amadeus.airline.destinations.get(Params
   .with("airlineCode", "BA")
   .and("max", 2));
+
+// Transfer Search
+TransferOffersPost[] transfers = amadeus.shopping.transferOffers.post(body);
+
+// Transfer Booking
+TransferOrder transfers = amadeus.ordering.transferOrders.post(body, params);
+
+// Transfer Management
+TransferCancellation transfers = amadeus.ordering.transferOrder("123456").transfers.cancellation.post(params);
 ```
 
 ## Development & Contributing

src/main/java/com/amadeus/Amadeus.java

@@ -111,6 +111,13 @@ public class Amadeus extends HTTPClient {
    */
   public Airline airline;
 
+  /**
+   * <p>
+   * A namespaced client for the <code>/v1/ordering</code> endpoints.
+   * </p>
+   */
+  public Ordering ordering;
+
   protected Amadeus(Configuration configuration) {
     super(configuration);
     this.referenceData = new ReferenceData(this);
@@ -125,6 +132,7 @@ protected Amadeus(Configuration configuration) {
     this.dutyOfCare = new DutyOfCare(this);
     this.location = new Location(this);
     this.airline = new Airline(this);
+    this.ordering = new Ordering(this);
   }
 
   /**

src/main/java/com/amadeus/Ordering.java

@@ -0,0 +1,51 @@
+package com.amadeus;
+
+import com.amadeus.ordering.TransferOrder;
+import com.amadeus.ordering.TransferOrders;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v1/ordering</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.ordering;</pre>
+ *
+ * @hide
+ */
+public class Ordering {
+  private Amadeus client;
+
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v1/ordering/transfer-orders</code> endpoints.
+   * </p>
+   */
+  public TransferOrders transferOrders;
+
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v1/ordering/transafer-orders/:orderId</code> endpoints.
+   * </p>
+   */
+  public TransferOrder transferOrder(String orderId) {
+    return new TransferOrder(client, orderId);
+  }
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public Ordering(Amadeus client) {
+    this.transferOrders = new TransferOrders(client);
+    this.client = client;
+  }
+}

src/main/java/com/amadeus/Shopping.java

@@ -10,6 +10,7 @@
 import com.amadeus.shopping.HotelOfferSearch;
 import com.amadeus.shopping.HotelOffersSearch;
 import com.amadeus.shopping.SeatMaps;
+import com.amadeus.shopping.TransferOffers;
 
 
 /**
@@ -103,6 +104,14 @@ public class Shopping {
    */
   public Availability availability;
 
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v1/shopping/transfer-offers</code> endpoints.
+   * </p>
+   */
+  public TransferOffers transferOffers;
+
   /**
    * Constructor.
    * @hide
@@ -117,6 +126,7 @@ public Shopping(Amadeus client) {
     this.seatMaps = new SeatMaps(client);
     this.activities = new Activities(client);
     this.availability = new Availability(client);
+    this.transferOffers = new TransferOffers(client);
   }
 
   /**

src/main/java/com/amadeus/ordering/TransferOrder.java

@@ -0,0 +1,39 @@
+package com.amadeus.ordering;
+
+import com.amadeus.Amadeus;
+import com.amadeus.ordering.transferOrders.Transfers;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v1/ordering/transfer-orders/:orderId</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder(API_KEY, API_SECRET).build();
+ * amadeus.ordering.transferOrder(orderId);</pre>
+ *
+ * @hide
+ */
+public class TransferOrder {
+  public Amadeus client;
+  public String orderId;
+  public Transfers transfers;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public TransferOrder(Amadeus client, String orderId) {
+    this.orderId = orderId;
+    this.client = client;
+    this.transfers = new Transfers(client, orderId);
+  }
+
+}
+
+  

src/main/java/com/amadeus/ordering/TransferOrders.java

@@ -0,0 +1,75 @@
+package com.amadeus.ordering;
+
+import com.amadeus.Amadeus;
+import com.amadeus.Params;
+import com.amadeus.Response;
+import com.amadeus.exceptions.ResponseException;
+import com.amadeus.resources.Resource;
+import com.amadeus.resources.TransferOrder;
+import com.google.gson.JsonObject;
+
+/**
+ * <p>
+ * A namespaced client for the
+ * <code>/v1/ordering/transfer-orders</code> endpoints.
+ * </p>
+ *
+ * <p>
+ * Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder(API_KEY, API_SECRET).build();
+ * amadeus.ordering.transferOrders;</pre>
+ */
+public class TransferOrders {
+  private Amadeus client;
+
+  private static final String TRANSFER_ORDERS_URL = "/v1/ordering/transfer-orders";
+
+  /**
+   * Constructor.
+   *
+   * @hide
+   */
+  public TransferOrders(Amadeus client) {
+    this.client = client;
+  }
+
+  /**
+   * <p>
+   *   The Amadeus Transfer Offers API allows travelers to book private transfers.
+   * </p>
+   *
+   * <pre>
+   * amadeus.ordering.transferOrders.post(body);</pre>
+   *
+   * @param body the parameters to send to the API as a JsonObject
+   * @param params URL parameters
+   * @return an API resource
+   * @throws ResponseException when an exception occurs
+   */
+  public TransferOrder post(JsonObject body, Params params) throws ResponseException {
+    Response response = client.post(TRANSFER_ORDERS_URL, params, body);
+    return (TransferOrder) Resource.fromObject(response, TransferOrder.class);
+  }
+
+  /**
+   * <p>
+   *   The Amadeus Transfer Offers API allows travelers to book private transfers.
+   * </p>
+   *
+   * <pre>
+   * amadeus.ordering.transferOrders.post(body);</pre>
+   *
+   * @param body the parameters to send to the API as a String
+   * @param params URL parameters
+   * @return an API resource
+   * @throws ResponseException when an exception occurs
+   */
+  public TransferOrder post(String body, Params params) throws ResponseException {
+    Response response = client.post(TRANSFER_ORDERS_URL, params, body);
+    return (TransferOrder) Resource.fromObject(response, TransferOrder.class);
+  }
+
+}

src/main/java/com/amadeus/ordering/transferOrders/Transfers.java

@@ -0,0 +1,38 @@
+package com.amadeus.ordering.transferOrders;
+
+import com.amadeus.Amadeus;
+import com.amadeus.ordering.transferOrders.transfers.Cancellation;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v1/ordering/transfer-orders/{orderId}/transfers/cancellation</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.ordering.transferOrders(orderId).urls;</pre>
+ *
+ * @hide
+ */
+public class Transfers {
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v1/ordering/transfer-orders/{orderId}/transfers/cancellation</code> endpoints.
+   * </p>
+   */
+  public Cancellation cancellation;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public Transfers(Amadeus client, String orderId) {
+    this.cancellation = new Cancellation(client, orderId);
+  }
+}