Support API StandardSearch.

Author: sdk-team

airticketopen-20230117/ChangeLog.md

@@ -1,3 +1,35 @@
+2025-11-18 Version: 4.0.0
+- Support API StandardSearch.
+- Update API OrderDetail: add response parameters Body.data.baggage_allowance_map.carry_length.
+- Update API OrderDetail: add response parameters Body.data.baggage_allowance_map.carry_width.
+- Update API OrderDetail: add response parameters Body.data.baggage_allowance_map.carry_height.
+- Update API OrderDetail: add response parameters Body.data.baggage_allowance_map.carry_sum_of_length_width_height.
+- Update API OrderDetail: add response parameters Body.data.baggage_allowance_map.length.
+- Update API OrderDetail: add response parameters Body.data.baggage_allowance_map.width.
+- Update API OrderDetail: add response parameters Body.data.baggage_allowance_map.height.
+- Update API OrderDetail: add response parameters Body.data.baggage_allowance_map.sum_of_length_width_height.
+- Update API OrderDetail: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.carry_length.
+- Update API OrderDetail: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.carry_width.
+- Update API OrderDetail: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.carry_height.
+- Update API OrderDetail: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.carry_sum_of_length_width_height.
+- Update API OrderDetail: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.length.
+- Update API OrderDetail: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.width.
+- Update API OrderDetail: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.height.
+- Update API OrderDetail: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.sum_of_length_width_height.
+- Update API OrderDetail: delete response parameters Body.data.solution.product_type_description.
+- Update API OrderDetail: delete response parameters Body.data.solution.refund_ticket_coupon_description.
+- Update API Pricing: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.carry_length.
+- Update API Pricing: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.carry_width.
+- Update API Pricing: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.carry_height.
+- Update API Pricing: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.carry_sum_of_length_width_height.
+- Update API Pricing: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.length.
+- Update API Pricing: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.width.
+- Update API Pricing: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.height.
+- Update API Pricing: add response parameters Body.data.solution.segment_baggage_mapping_list.$.passenger_baggage_allowance_mapping.sum_of_length_width_height.
+- Update API Pricing: delete response parameters Body.data.solution.product_type_description.
+- Update API Pricing: delete response parameters Body.data.solution.refund_ticket_coupon_description.
+
+
 2025-11-07 Version: 3.0.2
 - Generated php 2023-01-17 for airticketOpen.
 

airticketopen-20230117/src/AirticketOpen.php

@@ -80,6 +80,10 @@
 use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\SearchRequest;
 use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\SearchResponse;
 use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\SearchShrinkRequest;
+use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\StandardSearchHeaders;
+use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\StandardSearchRequest;
+use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\StandardSearchResponse;
+use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\StandardSearchShrinkRequest;
 use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\TicketingCheckHeaders;
 use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\TicketingCheckRequest;
 use AlibabaCloud\SDK\AirticketOpen\V20230117\Models\TicketingCheckResponse;
@@ -748,7 +752,7 @@ public function changeConfirm($request)
     }
 
     /**
-     * 改签-Detail.
+     * Change-Detail.
      *
      * @param request - ChangeDetailRequest
      * @param headers - ChangeDetailHeaders
@@ -803,7 +807,7 @@ public function changeDetailWithOptions($request, $headers, $runtime)
     }
 
     /**
-     * 改签-Detail.
+     * Change-Detail.
      *
      * @param request - ChangeDetailRequest
      *
@@ -1653,7 +1657,7 @@ public function orderList($request)
     }
 
     /**
-     * Trade - Seat and Price Verification.
+     * Transaction - Seat and Price Verification.
      *
      * @remarks
      * Check is price and remaining seats of solution you selected has changed. You should enter the solution_id returned by enrich.
@@ -1711,7 +1715,7 @@ public function pricingWithOptions($request, $headers, $runtime)
     }
 
     /**
-     * Trade - Seat and Price Verification.
+     * Transaction - Seat and Price Verification.
      *
      * @remarks
      * Check is price and remaining seats of solution you selected has changed. You should enter the solution_id returned by enrich.
@@ -1733,10 +1737,7 @@ public function pricing($request)
     }
 
     /**
-     * 退票-申请.
-     *
-     * @remarks
-     * Apply for a refund and generate a refund order.
+     * Ticket Refund - Application.
      *
      * @param tmpReq - RefundApplyRequest
      * @param headers - RefundApplyHeaders
@@ -1817,10 +1818,7 @@ public function refundApplyWithOptions($tmpReq, $headers, $runtime)
     }
 
     /**
-     * 退票-申请.
-     *
-     * @remarks
-     * Apply for a refund and generate a refund order.
+     * Ticket Refund - Application.
      *
      * @param request - RefundApplyRequest
      *
@@ -1841,9 +1839,6 @@ public function refundApply($request)
     /**
      * Refund - Detail.
      *
-     * @remarks
-     * Query refund order detail.
-     *
      * @param request - RefundDetailRequest
      * @param headers - RefundDetailHeaders
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1899,9 +1894,6 @@ public function refundDetailWithOptions($request, $headers, $runtime)
     /**
      * Refund - Detail.
      *
-     * @remarks
-     * Query refund order detail.
-     *
      * @param request - RefundDetailRequest
      *
      * @returns RefundDetailResponse
@@ -1921,9 +1913,6 @@ public function refundDetail($request)
     /**
      * Refund - Detail List.
      *
-     * @remarks
-     * Query refund order detail.
-     *
      * @param request - RefundDetailListRequest
      * @param headers - RefundDetailListHeaders
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1995,9 +1984,6 @@ public function refundDetailListWithOptions($request, $headers, $runtime)
     /**
      * Refund - Detail List.
      *
-     * @remarks
-     * Query refund order detail.
-     *
      * @param request - RefundDetailListRequest
      *
      * @returns RefundDetailListResponse
@@ -2015,7 +2001,7 @@ public function refundDetailList($request)
     }
 
     /**
-     * search.
+     * Search.
      *
      * @remarks
      * Enter the information of departure, arrival, departure date, passenger number and cabin, return the lowest price for each flight.
@@ -2103,7 +2089,7 @@ public function searchWithOptions($tmpReq, $headers, $runtime)
     }
 
     /**
-     * search.
+     * Search.
      *
      * @remarks
      * Enter the information of departure, arrival, departure date, passenger number and cabin, return the lowest price for each flight.
@@ -2124,6 +2110,110 @@ public function search($request)
         return $this->searchWithOptions($request, $headers, $runtime);
     }
 
+    /**
+     * 标准搜索.
+     *
+     * @param tmpReq - StandardSearchRequest
+     * @param headers - StandardSearchHeaders
+     * @param runtime - runtime options for this request RuntimeOptions
+     *
+     * @returns StandardSearchResponse
+     *
+     * @param StandardSearchRequest $tmpReq
+     * @param StandardSearchHeaders $headers
+     * @param RuntimeOptions        $runtime
+     *
+     * @return StandardSearchResponse
+     */
+    public function standardSearchWithOptions($tmpReq, $headers, $runtime)
+    {
+        $tmpReq->validate();
+        $request = new StandardSearchShrinkRequest([]);
+        Utils::convert($tmpReq, $request);
+        if (null !== $tmpReq->airLegs) {
+            $request->airLegsShrink = Utils::arrayToStringWithSpecifiedStyle($tmpReq->airLegs, 'air_legs', 'json');
+        }
+
+        if (null !== $tmpReq->searchControlOptions) {
+            $request->searchControlOptionsShrink = Utils::arrayToStringWithSpecifiedStyle($tmpReq->searchControlOptions, 'search_control_options', 'json');
+        }
+
+        $body = [];
+        if (null !== $request->adults) {
+            @$body['adults'] = $request->adults;
+        }
+
+        if (null !== $request->airLegsShrink) {
+            @$body['air_legs'] = $request->airLegsShrink;
+        }
+
+        if (null !== $request->cabinClass) {
+            @$body['cabin_class'] = $request->cabinClass;
+        }
+
+        if (null !== $request->children) {
+            @$body['children'] = $request->children;
+        }
+
+        if (null !== $request->infants) {
+            @$body['infants'] = $request->infants;
+        }
+
+        if (null !== $request->searchControlOptionsShrink) {
+            @$body['search_control_options'] = $request->searchControlOptionsShrink;
+        }
+
+        $realHeaders = [];
+        if (null !== $headers->commonHeaders) {
+            $realHeaders = $headers->commonHeaders;
+        }
+
+        if (null !== $headers->xAcsAirticketAccessToken) {
+            @$realHeaders['x-acs-airticket-access-token'] = '' . $headers->xAcsAirticketAccessToken;
+        }
+
+        if (null !== $headers->xAcsAirticketLanguage) {
+            @$realHeaders['x-acs-airticket-language'] = '' . $headers->xAcsAirticketLanguage;
+        }
+
+        $req = new OpenApiRequest([
+            'headers' => $realHeaders,
+            'body' => Utils::parseToMap($body),
+        ]);
+        $params = new Params([
+            'action' => 'StandardSearch',
+            'version' => '2023-01-17',
+            'protocol' => 'HTTPS',
+            'pathname' => '/airticket/v1/trade/action-standardsearch',
+            'method' => 'POST',
+            'authType' => 'AK',
+            'style' => 'ROA',
+            'reqBodyType' => 'formData',
+            'bodyType' => 'json',
+        ]);
+
+        return StandardSearchResponse::fromMap($this->callApi($params, $req, $runtime));
+    }
+
+    /**
+     * 标准搜索.
+     *
+     * @param request - StandardSearchRequest
+     *
+     * @returns StandardSearchResponse
+     *
+     * @param StandardSearchRequest $request
+     *
+     * @return StandardSearchResponse
+     */
+    public function standardSearch($request)
+    {
+        $runtime = new RuntimeOptions([]);
+        $headers = new StandardSearchHeaders([]);
+
+        return $this->standardSearchWithOptions($request, $headers, $runtime);
+    }
+
     /**
      * Transaction - Payment and Ticket Issuance.
      *