diff options
| author | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
|---|---|---|
| committer | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
| commit | 1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 (patch) | |
| tree | 5f0857666365b7e40cdaa3733ebe1f3ba9e13c67 /data/en_us/airticketopen/2023-01-17/api-docs.php | |
| parent | 7347bac4ab7e136157fc94777e6cf87ef9e08599 (diff) | |
| download | afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.tar.gz afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.zip | |
update APIs 20260712
Diffstat (limited to 'data/en_us/airticketopen/2023-01-17/api-docs.php')
| -rw-r--r-- | data/en_us/airticketopen/2023-01-17/api-docs.php | 14764 |
1 files changed, 4067 insertions, 10697 deletions
diff --git a/data/en_us/airticketopen/2023-01-17/api-docs.php b/data/en_us/airticketopen/2023-01-17/api-docs.php index 75e7ab5..70635de 100644 --- a/data/en_us/airticketopen/2023-01-17/api-docs.php +++ b/data/en_us/airticketopen/2023-01-17/api-docs.php @@ -1,222 +1,268 @@ <?php return [ 'version' => '1.0', - 'info' => [ - 'style' => 'ROA', - 'product' => 'airticketOpen', - 'version' => '2023-01-17', - ], + 'info' => ['style' => 'ROA', 'product' => 'airticketOpen', 'version' => '2023-01-17'], 'directories' => [ [ - 'id' => 180765, - 'title' => 'Token', + 'children' => ['GetToken'], 'type' => 'directory', - 'children' => [ - 'GetToken', - ], + 'title' => 'Token credentials', ], [ - 'id' => 180770, - 'title' => 'Reservation', + 'children' => ['Search', 'Enrich', 'AncillarySuggest', 'Pricing', 'Book', 'TicketingCheck', 'Ticketing', 'Cancel', 'OrderDetail', 'OrderList'], 'type' => 'directory', - 'children' => [ - 'Search', - 'Enrich', - 'AncillarySuggest', - 'Pricing', - 'Book', - 'TicketingCheck', - 'Ticketing', - 'Cancel', - 'OrderDetail', - 'OrderList', - ], + 'title' => 'Booking', ], [ - 'id' => 180787, - 'title' => 'Refund', + 'children' => ['RefundApply', 'RefundDetailList', 'RefundDetail'], 'type' => 'directory', - 'children' => [ - 'RefundApply', - 'RefundDetailList', - 'RefundDetail', - ], - ], - [ - 'id' => 180791, - 'title' => 'Change', - 'type' => 'directory', - 'children' => [ - 'ChangeConfirm', - 'ChangeCancel', - 'ChangeDetailListOfBuyer', - 'ChangeDetail', - 'ChangeApply', - 'ChangeDetailListOfOrderNum', - ], + 'title' => 'Refund', ], [ - 'id' => 180799, - 'title' => 'Irregular Flight', + 'children' => ['ChangeConfirm', 'ChangeCancel', 'ChangeDetailListOfBuyer', 'ChangeDetail', 'ChangeApply', 'ChangeDetailListOfOrderNum'], 'type' => 'directory', - 'children' => [ - 'FlightChangeOfOrder', - ], + 'title' => 'Rebooking', ], [ - 'id' => 182563, - 'title' => 'Other', + 'children' => ['FlightChangeOfOrder'], 'type' => 'directory', - 'children' => [ - 'AccountFlowList', - 'FileUpload', - 'LuggageDirect', - 'TransitVisa', - 'CollectFlightLowestPrice', - ], + 'title' => 'Schedule change', ], [ - 'id' => 0, - 'title' => '其它', + 'children' => ['AccountFlowList', 'FileUpload', 'LuggageDirect', 'TransitVisa', 'CollectFlightLowestPrice', 'StandardSearch'], 'type' => 'directory', - 'children' => [ - 'StandardSearch', - ], + 'title' => 'Other', ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ - 'GetToken' => [ - 'summary' => 'Get Token', - 'path' => '/airticket/v1/token', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'AccountFlowList' => [ + 'summary' => 'Queries the account fund flow list.', + 'path' => '/airticket/v1/account/flow-list', + 'methods' => ['get'], + 'schemes' => ['https', 'http'], 'security' => [ [ - 'rootTokenAuth' => [], + 'accessTokenAuth' => [], ], ], 'deprecated' => false, - 'systemTags' => [], 'parameters' => [ [ - 'name' => 'app_key', + 'name' => 'utc_begin_time', 'in' => 'query', - 'schema' => [ - 'title' => 'appKey', - 'description' => 'appKey', - 'type' => 'string', - 'required' => true, - 'example' => 'fu1bltcu3400iurywuri', - ], + 'schema' => ['title' => '', 'description' => 'The start search timestamp, effective to the day. Specify a 13-digit UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1677427200000'], ], [ - 'name' => 'app_secret', + 'name' => 'day_num', 'in' => 'query', - 'schema' => [ - 'title' => 'appSecret', - 'description' => 'appSecret', - 'type' => 'string', - 'required' => true, - 'example' => 'ZzQ3MW1mb3E1ODAwI2ldUjYlWUdJn5YI', - ], + 'schema' => ['title' => '', 'description' => 'The number of days to search. Maximum value: 30. Valid values: 0 to 30.', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '0'], + ], + [ + 'name' => 'page_index', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The page index.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], + ], + [ + 'name' => 'page_size', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The page size.', 'type' => 'integer', 'format' => 'int32', 'example' => '20', 'required' => false], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. Default value: the language configured for the buyer account.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ - 'title' => 'PopBaseRes<TokenInfoDTO, Object>', - 'description' => 'PopBaseRes<TokenInfoDTO, Object>', + 'title' => '', + 'description' => 'PopBaseRes<PageData<AccountFlow>, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'When the HTTP request is successful, the status value is 200.', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'Business error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'Error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'Whether it is correct', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'Request RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'Correctly processed return data', + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ - 'token' => [ - 'title' => 'token', - 'description' => 'token', - 'type' => 'string', - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiIyUlRjY0Ezc1puSndpYU11R1ctTkVRIiwiaWF0IjoxNjc3MTU1Njg3LCJleHAiOjE2NzcxNjI4ODcsIm5iZiI6MTY3NzE1NTYyN30.bd8qBedJ7R24NC8VpMtM4Ni5OR-Cc0utPiKSx8fjoj9taalt7zXBF8uIVTETw1N-Fx9reLflwVXrbDHky7ZKqlE5o_B5Bkx-crQKlJL-NzasEmNnuJNb5kmmbCy3mvIrQfo5Q5Y0ZaQ110pXK4qd1shRbklvuQXn8lPueJtNqo8VdIOAPGG_rPwOw2P767I0fyFHcome8FR4ST1UrwxeApNKMB_BkpCsUZLgpm9h9trhKbB-3qtk6UK1GKmfw6qlWpL3PQN7FAObNruS0r0CGh3Muc9PaGsuu8Xu5on21h9WmI7L0-jatZkS55p4PEerU56XpkwJfa35_hltKNTauu', - ], - 'expire_time' => [ - 'title' => 'token 剩余有效时间 单位秒', - 'description' => 'Remaining valid time of the token in seconds', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '7200', + 'list' => [ + 'title' => '', + 'description' => 'The data list.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'flow_id' => ['title' => '', 'description' => 'The flow ID.', 'type' => 'integer', 'format' => 'int64', 'example' => '1627239841225842666'], + 'gmt_create' => ['title' => '', 'description' => 'The creation time.', 'type' => 'integer', 'format' => 'int64', 'example' => '1676799185000'], + 'gmt_modified' => ['title' => '', 'description' => 'The modification time.', 'type' => 'integer', 'format' => 'int64', 'example' => '1676966530000'], + 'op_type' => ['title' => '', 'description' => 'The operation type. Valid values:'."\n" + .'- 1: payment'."\n" + .'- 2: refund'."\n" + .'- 3: top-up.', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'op_amount' => ['title' => '', 'description' => 'The operation amount, in CNY.', 'type' => 'number', 'format' => 'double', 'example' => '950.5'], + 'before_available_amount' => ['title' => '', 'description' => 'The available balance before the operation, in CNY.', 'type' => 'number', 'format' => 'double', 'example' => '1950.5'], + 'after_available_amount' => ['title' => '', 'description' => 'The available balance after the operation, in CNY.', 'type' => 'number', 'format' => 'double', 'example' => '1000'], + 'order_num' => ['title' => '', 'description' => 'The original order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4988430***971'], + 'out_order_num' => ['title' => '', 'description' => 'The external order number of the original order.', 'type' => 'string', 'example' => '4988430***971'], + 'change_order_num' => ['title' => '', 'description' => 'The change order number. This value is not empty if the flow is related to a ticket change.', 'type' => 'integer', 'format' => 'int64', 'example' => '49880***971'], + 'refund_order_num' => ['title' => '', 'description' => 'The refund order number. This value is not empty if the flow is related to a refund.', 'type' => 'integer', 'format' => 'int64', 'example' => '48430***971'], + 'order_type' => ['title' => '', 'description' => 'The order type. Valid values:'."\n" + .'- 0: original transaction'."\n" + .'- 1: change order payment'."\n" + .'- 2: refund.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'generate_time' => [ - 'title' => 'token生成时间戳，秒级别', - 'description' => 'Timestamp of token generation in seconds', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677055176', + 'pagination' => [ + 'title' => '', + 'description' => 'The pagination information.', + 'type' => 'object', + 'properties' => [ + 'total_count' => ['title' => '', 'description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'total_page' => ['title' => '', 'description' => 'The total number of pages.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'current_page' => ['title' => '', 'description' => 'The current page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'page_size' => ['title' => '', 'description' => 'The number of records per page.', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + ], + 'example' => '', ], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Data carried during error handling', - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"token\\": \\"eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiIyUlRjY0Ezc1puSndpYU11R1ctTkVRIiwiaWF0IjoxNjc3MTU1Njg3LCJleHAiOjE2NzcxNjI4ODcsIm5iZiI6MTY3NzE1NTYyN30.bd8qBedJ7R24NC8VpMtM4Ni5OR-Cc0utPiKSx8fjoj9taalt7zXBF8uIVTETw1N-Fx9reLflwVXrbDHky7ZKqlE5o_B5Bkx-crQKlJL-NzasEmNnuJNb5kmmbCy3mvIrQfo5Q5Y0ZaQ110pXK4qd1shRbklvuQXn8lPueJtNqo8VdIOAPGG_rPwOw2P767I0fyFHcome8FR4ST1UrwxeApNKMB_BkpCsUZLgpm9h9trhKbB-3qtk6UK1GKmfw6qlWpL3PQN7FAObNruS0r0CGh3Muc9PaGsuu8Xu5on21h9WmI7L0-jatZkS55p4PEerU56XpkwJfa35_hltKNTauu\\",\\n \\"expire_time\\": 7200,\\n \\"generate_time\\": 1677055176\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'GetToken', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"flow_id\\": 1627239841225842700,\\n \\"gmt_create\\": 1676799185000,\\n \\"gmt_modified\\": 1676966530000,\\n \\"op_type\\": 2,\\n \\"op_amount\\": 950.5,\\n \\"before_available_amount\\": 1950.5,\\n \\"after_available_amount\\": 1000,\\n \\"order_num\\": 0,\\n \\"out_order_num\\": \\"4988430***971\\",\\n \\"change_order_num\\": 0,\\n \\"refund_order_num\\": 0,\\n \\"order_type\\": 1\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'AccountFlowList', + 'changeSet' => [], ], - 'Search' => [ - 'summary' => 'Search', - 'path' => '/airticket/v1/trade/action-search', - 'methods' => [ - 'post', + 'AncillarySuggest' => [ + 'summary' => 'Recommends ancillary products.', + 'path' => '/airticket/v1/ancillary/action-suggest', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], ], - 'schemes' => [ - 'https', - 'http', + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ + [ + 'name' => 'solution_id', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The solution_id of the flight.', 'type' => 'string', 'required' => true, 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ'."\n"], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language setting. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'PopBaseRes<AncillarySuggestRes, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request was successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'solution_id' => ['title' => '', 'description' => 'The solution_id of the flight.', 'type' => 'string', 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ'], + 'seg_ancillary_map_list' => [ + 'title' => '', + 'description' => 'The mapping between flights and ancillary products.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'segment_id_list' => [ + 'title' => '', + 'description' => 'The list of segment IDs. These segments share the same ancillary product.', + 'type' => 'array', + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'."\n", 'title' => ''], + 'example' => '', + ], + 'ancillary' => [ + 'title' => '', + 'description' => 'The ancillary product.', + 'type' => 'object', + 'properties' => [ + 'ancillary_id' => ['title' => '', 'description' => 'The ancillary product ID.', 'type' => 'string', 'example' => 'eJwz8DeySEo0NjQ01TU3TU'], + 'ancillary_type' => ['title' => '', 'description' => 'The ancillary product type. Currently supported value: 4 (paid baggage).', 'type' => 'integer', 'format' => 'int32', 'example' => '4'], + 'baggage_ancillary' => [ + 'title' => '', + 'description' => 'The baggage ancillary details.', + 'type' => 'object', + 'properties' => [ + 'baggage_amount' => ['title' => '', 'description' => 'The number of baggage pieces. Valid values: 3, 2, 1, 0, and -2. A value of -2 indicates weight-based calculation.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'baggage_weight' => ['title' => '', 'description' => 'The baggage weight, ranging from 0 to 50. If isAllWeight is set to true, this value represents the total weight of all pieces.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'baggage_weight_unit' => ['title' => '', 'description' => 'The unit of baggage weight.', 'type' => 'string', 'example' => 'KG'], + 'is_all_weight' => ['title' => '', 'description' => 'Indicates whether the weight represents the total weight of all baggage pieces.', 'type' => 'boolean', 'example' => 'true'], + 'price' => ['title' => '', 'description' => 'The total price.', 'type' => 'number', 'format' => 'double', 'example' => '10.0'], + ], + 'example' => '', + ], + ], + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + ], + 'example' => '', + ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ\\",\\n \\"seg_ancillary_map_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"ancillary\\": {\\n \\"ancillary_id\\": \\"eJwz8DeySEo0NjQ01TU3TU\\",\\n \\"ancillary_type\\": 4,\\n \\"baggage_ancillary\\": {\\n \\"baggage_amount\\": 0,\\n \\"baggage_weight\\": 0,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"price\\": 10\\n }\\n }\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'AncillarySuggest', + 'changeSet' => [], + ], + 'Book' => [ + 'summary' => 'Creates a booking order.', + 'path' => '/airticket/v1/trade/action-book', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'accessTokenAuth' => [], @@ -225,1856 +271,1901 @@ 'deprecated' => false, 'parameters' => [ [ - 'name' => 'cabin_class', + 'name' => 'solution_id', 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'solution_id.', 'type' => 'string', 'required' => true, 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ'], + ], + [ + 'name' => 'out_order_num', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The external order number.', 'type' => 'string', 'required' => true, 'example' => 'x091-2023-0220-j-0001'], + ], + [ + 'name' => 'contact', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'title' => '不填写默认为 ALL_CABIN。舱等 ALL_CABIN:不限舱等; Y:经济舱; FC:头等舱和商务舱; S:超级经济舱; YS:经济舱和超级经济舱; YSC:经济舱、超级经济舱和商务舱;', - 'description' => 'cabin class'."\n" - .'1. **ALL_CABIN** : all cabin class'."\n" - .'2. **Y** : economy class'."\n" - .'3. **FC** : first class and business class'."\n" - .'4. **S** : premium economy class'."\n" - .'5. **YS** : economy class and premium economy class'."\n" - .'6. **YSC** : economy class, premium economy class and business class', - 'type' => 'string', - 'required' => false, - 'example' => 'ALL_CABIN', + 'title' => '', + 'description' => 'The contact information.', + 'type' => 'object', + 'properties' => [ + 'last_name' => ['title' => '', 'description' => 'The last name.', 'type' => 'string', 'required' => false, 'example' => 'ZHANG'], + 'first_name' => ['title' => '', 'description' => 'The first name.', 'type' => 'string', 'required' => false, 'example' => 'SAN'], + 'mobile_phone_num' => ['title' => '', 'description' => 'The mobile phone number.', 'type' => 'string', 'required' => false, 'example' => '183******96'], + 'mobile_country_code' => ['title' => '', 'description' => 'The country calling code.', 'type' => 'string', 'required' => false, 'example' => '86'], + 'email' => ['title' => '', 'description' => 'The email address.', 'type' => 'string', 'required' => false, 'example' => 'gao******@gmail.com'], + ], + 'required' => true, + 'example' => '', ], ], [ - 'name' => 'air_legs', + 'name' => 'passenger_list', 'in' => 'formData', 'style' => 'json', 'schema' => [ - 'title' => '行程数组 departure_city,departure_airport_list 二者至少一个不为空,departure_airport_list 有值时必须属于同一个城市; arrival_city,arrival_airport_list 二者至少一个不为空,arrival_airport_list 有值时必须属于同一个城市', - 'description' => 'itinerary list', + 'title' => '', + 'description' => 'The list of passengers.', 'type' => 'array', 'items' => [ - 'description' => 'itinerary', + 'description' => 'passenger', 'type' => 'object', 'properties' => [ - 'departure_city' => [ - 'title' => '出发城市三字码', - 'description' => 'departure city code', - 'type' => 'string', - 'required' => false, - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '到达城市三字码', - 'description' => 'arrival city code', - 'type' => 'string', + 'last_name' => ['title' => '', 'description' => 'The last name.', 'type' => 'string', 'required' => true, 'example' => 'ZHANG'], + 'first_name' => ['title' => '', 'description' => 'The first name.', 'type' => 'string', 'required' => true, 'example' => 'SAN'], + 'birthday' => ['title' => '', 'description' => 'The date of birth in yyyyMMdd format.', 'type' => 'string', 'example' => '20200320', 'required' => false], + 'type' => ['title' => '', 'description' => 'The passenger type. Valid values:'."\n" + .'- 0: adult'."\n" + .'- 1: child'."\n" + .'- 8: infant.', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '0'], + 'mobile_phone_number' => ['title' => '', 'description' => 'The mobile phone number.', 'type' => 'string', 'required' => true, 'example' => '183******95'], + 'mobile_country_code' => ['title' => '', 'description' => 'The country calling code for the mobile phone number.', 'type' => 'string', 'required' => true, 'example' => '86'], + 'gender' => ['title' => '', 'description' => 'The gender. Valid values:'."\n" + .'- 0: MALE'."\n" + .'- 1: FEMALE.', 'type' => 'integer', 'format' => 'int32', 'example' => '0', 'required' => false], + 'nationality' => ['title' => '', 'description' => 'The nationality. Use a two-letter country code.', 'type' => 'string', 'example' => 'CN', 'required' => false], + 'credential' => [ + 'title' => '', + 'description' => 'The credential information.', + 'type' => 'object', + 'properties' => [ + 'cert_issue_place' => ['title' => '', 'description' => 'The place of issue. Use a two-letter country code.', 'type' => 'string', 'example' => 'CN', 'required' => false], + 'credential_num' => ['title' => '', 'description' => 'The credential number.', 'type' => 'string', 'example' => 'E1***5674', 'required' => false], + 'expire_date' => ['title' => '', 'description' => 'The expiration date of the credential.', 'type' => 'string', 'example' => '20290101', 'required' => false], + 'credential_type' => ['title' => '', 'description' => 'The credential type. Valid values:'."\n" + .'- 0: ID card'."\n" + .'- 1: passport'."\n" + .'- 4: Home Return Permit'."\n" + .'- 5: Taiwan Compatriot Permit'."\n" + .'- 6: Hong Kong and Macau Travel Permit'."\n" + .'- 12: Taiwan Travel Permit'."\n" + .'- 19: no credential.', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '1'], + ], 'required' => false, - 'example' => 'MFM', + 'example' => '', ], - 'departure_airport_list' => [ - 'title' => '出发机场三字码', - 'description' => 'departure airport [IATA airport code] list', + ], + 'required' => false, + 'title' => '', + 'example' => '', + ], + 'required' => true, + 'example' => '', + ], + ], + [ + 'name' => 'passenger_ancillary_purchase_map_list', + 'in' => 'formData', + 'style' => 'json', + 'schema' => [ + 'title' => '', + 'description' => 'The mapping between passengers and ancillary purchases.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'passenger_list' => [ + 'title' => '', + 'description' => 'The list of passengers who purchase the same ancillary product.', 'type' => 'array', 'items' => [ - 'description' => 'departure airport [IATA airport code]', - 'type' => 'string', + 'description' => 'passenger', + 'type' => 'object', + 'properties' => [ + 'last_name' => ['title' => '', 'description' => 'The last name.', 'type' => 'string', 'required' => true, 'example' => 'ZHANG'], + 'first_name' => ['title' => '', 'description' => 'The first name.', 'type' => 'string', 'required' => true, 'example' => 'SAN'], + 'birthday' => ['title' => '', 'description' => 'The date of birth in yyyyMMdd format.', 'type' => 'string', 'example' => '20020320', 'required' => false], + 'type' => ['title' => '', 'description' => 'The passenger type. Valid values:'."\n" + .'- 0: adult'."\n" + .'- 1: child'."\n" + .'- 8: infant.', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '0'], + 'mobile_phone_number' => ['title' => '', 'description' => 'The mobile phone number.', 'type' => 'string', 'required' => true, 'example' => '182******92'], + 'mobile_country_code' => ['title' => '', 'description' => 'The country calling code for the mobile phone number.', 'type' => 'string', 'required' => true, 'example' => '86'], + 'gender' => ['title' => '', 'description' => 'The gender. Valid values:'."\n" + .'- 0: MALE'."\n" + .'- 1: FEMALE.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], + 'nationality' => ['title' => '', 'description' => 'The nationality.', 'type' => 'string', 'example' => 'CN', 'required' => false], + 'credential' => [ + 'title' => '', + 'description' => 'The credential information.', + 'type' => 'object', + 'properties' => [ + 'cert_issue_place' => ['title' => '', 'description' => 'The place of issue. Use a two-letter country code.', 'type' => 'string', 'example' => 'CN', 'required' => false], + 'credential_num' => ['title' => '', 'description' => 'The credential number.', 'type' => 'string', 'example' => 'E1***5673', 'required' => false], + 'expire_date' => ['title' => '', 'description' => 'The expiration date of the credential.', 'type' => 'string', 'example' => '20290102', 'required' => false], + 'credential_type' => ['title' => '', 'description' => 'The credential type. Valid values:'."\n" + .'- 0: ID card'."\n" + .'- 1: passport'."\n" + .'- 2: student ID'."\n" + .'- 3: military ID'."\n" + .'- 4: Home Return Permit'."\n" + .'- 5: Taiwan Compatriot Permit'."\n" + .'- 6: Hong Kong and Macau Travel Permit'."\n" + .'- 7: international seafarer certificate'."\n" + .'- 8: foreigner permanent residence permit'."\n" + .'- 10: police officer certificate'."\n" + .'- 11: soldier certificate'."\n" + .'- 12: Taiwan Travel Permit'."\n" + .'- 13: Taiwan Entry Permit'."\n" + .'- 14: household register'."\n" + .'- 15: birth certificate'."\n" + .'- 16: driver license'."\n" + .'- 17: Hong Kong and Macau resident residence permit'."\n" + .'- 18: Taiwan resident residence permit.', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '1'], + ], + 'required' => false, + 'example' => '', + ], + ], 'required' => false, - 'example' => 'PVG', + 'title' => '', + 'example' => '', ], 'required' => false, - 'example' => 'PVG', + 'example' => '', ], - 'arrival_airport_list' => [ - 'title' => '到达机场三字码', - 'description' => 'arrival airport [IATA airport code] list', - 'type' => 'array', - 'items' => [ - 'description' => 'arrival airport [IATA airport code]', - 'type' => 'string', - 'required' => false, - 'example' => 'MFM', + 'book_ancillary_req_item' => [ + 'title' => '', + 'description' => 'The ancillary product object for the booking request.', + 'type' => 'object', + 'properties' => [ + 'ancillary_id' => ['title' => '', 'description' => 'The ancillary product ID.', 'type' => 'string', 'example' => 'MDY2NTAxLCJleHAiOjE2NxNzM3MDEsIm5ix', 'required' => false], + 'ancillary_type' => ['title' => '', 'description' => 'The ancillary product type. Currently supported value: 4 (paid baggage). More types will be supported in the future.', 'type' => 'integer', 'format' => 'int32', 'example' => '4', 'required' => false], ], 'required' => false, - 'example' => 'MFM', - ], - 'departure_date' => [ - 'title' => '起飞日期 (eg: yyyyMMdd)', - 'description' => 'departure date (eg: yyyyMMdd)', - 'type' => 'string', - 'required' => true, - 'example' => '20230310', + 'example' => '', ], ], 'required' => false, + 'title' => '', + 'example' => '', ], - 'required' => true, + 'required' => false, + 'example' => '', ], ], [ - 'name' => 'adults', - 'in' => 'formData', + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language setting. Uses the buyer account configuration by default.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => '成人乘客数 1-9', - 'description' => 'adult passenger amount 1-9', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '2', + 'title' => '', + 'description' => 'PopBaseRes<BookRes, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'order_list' => [ + 'title' => '', + 'description' => 'The list of order information.', + 'type' => 'array', + 'items' => [ + 'description' => 'The list of order numbers.', + 'type' => 'object', + 'properties' => [ + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617111'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + ], + 'example' => '', + ], + 'error_data' => [ + 'title' => '', + 'description' => 'The data returned with the error.', + 'type' => 'object', + 'properties' => [ + 'order_list' => [ + 'title' => '', + 'description' => 'The list of order information. If you call the Book operation again with the same parameters after a successful booking, the order number is returned.', + 'type' => 'array', + 'items' => [ + 'description' => 'The list of order numbers.', + 'type' => 'object', + 'properties' => [ + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617111'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + ], + 'example' => 'null', + ], + ], + 'example' => '', ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_list\\": [\\n {\\n \\"order_num\\": 0\\n }\\n ]\\n },\\n \\"error_data\\": {\\n \\"order_list\\": [\\n {\\n \\"order_num\\": 0\\n }\\n ]\\n }\\n}","type":"json"}]', + 'title' => 'Book', + 'changeSet' => [ + ['createdAt' => '2025-09-29T07:26:39.000Z', 'description' => 'OpenAPI offline'], + ], + ], + 'Cancel' => [ + 'summary' => 'Cancels an unpaid order.', + 'path' => '/airticket/v1/trade/action-cancel', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'security' => [ [ - 'name' => 'children', + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ + [ + 'name' => 'order_num', 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '496***2617111'], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. The buyer account configuration is used by default.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => '儿童乘客数 0-9', - 'description' => 'child passenger amount 0-9', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', + 'title' => '', + 'description' => 'PopBaseRes<CancelRes, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '496***2617111'."\n"], + ], + 'example' => '', + ], + 'error_data' => ['title' => '', 'description' => 'The data returned for a failed request.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_num\\": 0\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'Cancel', + 'changeSet' => [], + ], + 'ChangeApply' => [ + 'summary' => 'Submits a change application.', + 'path' => '/airticket/v1/change/action-apply', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => ['operationType' => 'none'], + 'parameters' => [ [ - 'name' => 'infants', + 'name' => 'order_num', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '4988430***950'], + ], + [ + 'name' => 'type', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The change type. Valid values:'."\n" + .'- 0: voluntary change'."\n" + .'- 1: flight schedule change or flight cancellation.', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '0'], + ], + [ + 'name' => 'change_passenger_list', 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'title' => '婴儿乘客数 0-9', - 'description' => 'infant passenger amount 0-9', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', + 'title' => '', + 'description' => 'The list of passengers for the change.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'required' => true, 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'required' => true, 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number.', 'type' => 'string', 'example' => '411***********4411', 'required' => false], + ], + 'required' => false, + 'title' => '', + 'example' => '', + ], + 'required' => true, + 'example' => '', ], ], [ - 'name' => 'search_control_options', + 'name' => 'changed_journeys', 'in' => 'formData', 'style' => 'json', 'schema' => [ - 'title' => '搜索控制项，可选', - 'description' => 'search controls', - 'type' => 'object', - 'properties' => [ - 'airline_prefer_list' => [ - 'title' => '优选航司', - 'description' => 'preferred airlines list', - 'type' => 'array', - 'items' => [ - 'type' => 'string', + 'title' => '', + 'description' => 'The target journey for the change.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'segment_list' => [ + 'title' => '', + 'description' => 'The list of target segments for the change.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport.', 'type' => 'string', 'example' => 'PVG', 'required' => false], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport.', 'type' => 'string', 'example' => 'MFM', 'required' => false], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city.', 'type' => 'string', 'required' => true, 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city.', 'type' => 'string', 'required' => true, 'example' => 'MFM'], + 'departure_date' => ['title' => '', 'description' => 'The departure date (for example, yyyyMMdd).'."\n" + .'[_single.params.changed_journeys.items.segment_list.items.departure_time.desc](Deprecated) The departure date and time of the flight, in UTC timestamp.'."\n" + .'[_single.params.changed_journeys.items.segment_list.items.departure_time_str.desc](Required) The departure date and time of the flight, in local travel time. Format: yyyy-MM-dd HH:mm:ss.'."\n" + .'[_single.params.changed_journeys.items.segment_list.items.arrive_time.desc](Deprecated) The arrival date and time of the flight, in UTC timestamp.'."\n" + .'[_single.params.changed_journeys.items.segment_list.items.arrive_time_str.desc](Required) The arrival date and time of the flight, in local travel time. Format: yyyy-MM-dd HH:mm:ss.', 'type' => 'string', 'required' => true, 'example' => '20230320'], + 'departure_time' => ['title' => '', 'description' => '(该属性废弃)航班起飞日期，utc时间戳', 'type' => 'integer', 'format' => 'int64', 'example' => '1677232998000', 'required' => false], + 'departure_time_str' => ['title' => '', 'description' => '(必填参数)航班起飞日期时间，航班的旅行时间，格式：yyyy-MM-dd HH:mm:ss', 'type' => 'string', 'required' => false, 'example' => '2024-03-20 09:30:00'], + 'arrive_time' => ['title' => '', 'description' => '(该属性废弃)航班到达日期时间，utc时间戳', 'type' => 'integer', 'format' => 'int64', 'example' => '1677232999000', 'required' => false], + 'arrive_time_str' => ['title' => '', 'description' => '(必填参数)航班到达日期时间，航班的旅行时间，格式：yyyy-MM-dd HH:mm:ss', 'type' => 'string', 'required' => false, 'example' => '2024-03-20 12:30:00'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal of the flight.', 'type' => 'string', 'example' => 'T2', 'required' => false], + 'arrive_terminal' => ['title' => '', 'description' => 'The arrival terminal of the flight.', 'type' => 'string', 'example' => 'T1', 'required' => false], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (such as KA5809).', 'type' => 'string', 'required' => true, 'example' => 'HO1295'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (such as CX601).', 'type' => 'string', 'example' => 'HO1295', 'required' => false], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'example' => 'false', 'required' => false], + ], + 'required' => false, + 'title' => '', + 'example' => '', + ], 'required' => false, - 'example' => 'FD', + 'example' => '', ], - 'required' => false, - 'example' => 'FD', ], - 'airline_excluded_list' => [ - 'title' => '航司排除列表', - 'description' => 'excluded airlines list', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'required' => false, - 'example' => 'AK', + 'required' => false, + 'title' => '', + 'example' => '', + ], + 'required' => true, + 'example' => '', + ], + ], + [ + 'name' => 'contact', + 'in' => 'formData', + 'style' => 'json', + 'schema' => [ + 'title' => '', + 'description' => 'The contact information for the change.', + 'type' => 'object', + 'properties' => [ + 'mobile_country_code' => ['title' => '', 'description' => 'The country calling code.', 'type' => 'string', 'example' => '86', 'required' => false], + 'mobile_phone_num' => ['title' => '', 'description' => 'The mobile phone number of the contact.', 'type' => 'string', 'example' => '183*****92', 'required' => false], + 'email' => ['title' => '', 'description' => 'The email address.', 'type' => 'string', 'example' => 'gao******@gmail.com', 'required' => false], + ], + 'required' => true, + 'example' => '', + ], + ], + [ + 'name' => 'remark', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The buyer remarks.', 'type' => 'string', 'example' => 'remark desc', 'required' => false], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language setting. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'PopBaseRes<ApplyChangeRes, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4988430***950'], + 'change_orders' => [ + 'title' => '', + 'description' => 'The list of change order application results.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'change_order_num' => ['title' => '', 'description' => 'The change order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '49884*****950'], + 'change_order_status' => ['title' => '', 'description' => 'The change order status. Valid values:'."\n" + .'- 0: Change order created.'."\n" + .'- 5: Change order creation failed.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'fail_reason' => ['title' => '', 'description' => 'The reason for the change order creation failure.', 'type' => 'string', 'example' => 'desc reason'], + 'passengers' => [ + 'title' => '', + 'description' => 'The passenger information of the change order.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number.', 'type' => 'string', 'example' => '411***********4411'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], ], - 'required' => false, - 'example' => '7C', - ], - 'service_quality' => [ - 'title' => '出票服务质量', - 'description' => 'service quality', - 'type' => 'string', - 'required' => false, - 'example' => 'A1', + 'example' => '', ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], ], - 'required' => false, + 'example' => '', ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_num\\": 0,\\n \\"change_orders\\": [\\n {\\n \\"change_order_num\\": 0,\\n \\"change_order_status\\": 0,\\n \\"fail_reason\\": \\"desc reason\\",\\n \\"passengers\\": [\\n {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n }\\n ]\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'ChangeApply', + 'changeSet' => [ + ['createdAt' => '2025-05-08T09:47:18.000Z', 'description' => 'OpenAPI offline'], + ], + ], + 'ChangeCancel' => [ + 'summary' => 'Cancel the change order.', + 'path' => '/airticket/v1/change/action-cancel', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ + [ + 'name' => 'change_order_num', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'Change order number', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '4988430***950'], + ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'access_token', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'Language. Uses the buyer account configuration by default.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', + 'title' => '', + 'description' => 'PopBaseRes', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'If the HTTP request is successful, the status value is 200.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'Business error code', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'Error message', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', 'description' => ''], + 'data' => ['title' => '', 'description' => 'The data returned for a successful request.', 'type' => 'any', 'example' => 'null'], + 'error_data' => ['title' => '', 'description' => 'The data returned for a failed request.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": \\"null\\",\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'ChangeCancel', + 'changeSet' => [], + ], + 'ChangeConfirm' => [ + 'summary' => 'Confirms a flight change order.', + 'path' => '/airticket/v1/change/action-confirm', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ + [ + 'name' => 'change_order_num', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The change order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '4988430***950'], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. The buyer account configuration is used by default.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'language code(refer to ISO_639), defaults to the buyer\'s account configuration'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', + 'title' => '', + 'description' => 'PopBaseRes<ConfirmChangeRes, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', 'description' => ''], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'pay_amount' => ['title' => '', 'description' => 'The payment amount for the flight change.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'transaction_no' => ['title' => '', 'description' => 'The payment transaction number for the flight change.', 'type' => 'string', 'example' => 'hkduendkd-2023-dj0'], + ], + 'example' => '', + ], + 'error_data' => ['title' => '', 'description' => 'The data returned for a failed request.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', ], ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"pay_amount\\": 30,\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\"\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'ChangeConfirm', + 'changeSet' => [ + ['createdAt' => '2025-09-29T07:26:39.000Z', 'description' => 'OpenAPI offline'], + ], + ], + 'ChangeDetail' => [ + 'summary' => 'Retrieves the details of a flight change order.', + 'path' => '/airticket/v1/change/detail', + 'methods' => ['get'], + 'schemes' => ['https', 'http'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ + [ + 'name' => 'change_order_num', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The change order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '4988430***950'], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. The buyer account configuration is used by default.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<SearchRes, Object>', - 'description' => 'PopBaseRes<SearchRes, Object>', + 'title' => '', + 'description' => 'PopBaseRes<ChangeOrderDetail, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http request has been processed successfully，status code is 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code', - 'type' => 'string', - 'example' => '""', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'error message', - 'type' => 'string', - 'example' => '""', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'true represents success, false represents failure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'request ID', - 'type' => 'string', - 'example' => '2236993B-7BE7-5F92-B179-21FF08570165', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request was successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'data', + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ - 'solution_list' => [ - 'title' => '搜索询价结果', - 'description' => 'solution list', + 'change_order_num' => ['title' => '', 'description' => 'The change order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4988430***950'], + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '5988430***541'], + 'change_passengers' => [ + 'title' => '', + 'description' => 'The list of passengers for the flight change.', 'type' => 'array', 'items' => [ - 'description' => 'solution', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'solution_id' => [ - 'title' => 'solution_id', - 'description' => 'solution ID', - 'type' => 'string', - 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ', - ], - 'adult_price' => [ - 'title' => '成人单价', - 'description' => 'adult fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '600', + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number.', 'type' => 'string', 'example' => '411***********4411'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'total_amount' => ['title' => '', 'description' => 'The total payment amount of the change order.', 'type' => 'number', 'format' => 'double', 'example' => '300'], + 'order_status' => ['title' => '', 'description' => 'The status of the change order. Valid values:'."\n" + .'- 0: initial state'."\n" + .'- 1: pending payment'."\n" + .'- 2: payment successful'."\n" + .'- 3: change successful'."\n" + .'- 4: change closed.', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'close_reason' => ['title' => '', 'description' => 'The reason for closing the change order.', 'type' => 'string', 'example' => 'reason desc'], + 'transaction_no' => ['title' => '', 'description' => 'The transaction number.', 'type' => 'string', 'example' => 'hkduendkd-2023-dj0'], + 'change_reason_type' => ['title' => '', 'description' => 'The type of the change reason. Valid values:'."\n" + .'- 0: voluntary date change'."\n" + .'- 1: flight schedule change or flight cancellation'."\n" + .'- 2: change due to pandemic.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'create_utc_time' => ['title' => '', 'description' => 'The creation time of the change order, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415276000'], + 'last_confirm_utc_time' => ['title' => '', 'description' => 'The latest payment deadline for the buyer, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415278000'], + 'pay_status' => ['title' => '', 'description' => 'The payment status. Valid values:'."\n" + .'- 0: initial state'."\n" + .'- 1: pending payment'."\n" + .'- 2: payment successful'."\n" + .'- 4: paid order closed successfully'."\n" + .'- 5: unpaid order closed successfully.', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'pay_success_utc_time' => ['title' => '', 'description' => 'The time when the buyer completed the payment, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415255000'], + 'close_utc_time' => ['title' => '', 'description' => 'The time when the order was closed, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415244000'], + 'contact' => [ + 'title' => '', + 'description' => 'The contact information for the change order.', + 'type' => 'object', + 'properties' => [ + 'mobile_country_code' => ['title' => '', 'description' => 'The country calling code.', 'type' => 'string', 'example' => '86'], + 'mobile_phone_num' => ['title' => '', 'description' => 'The mobile phone number of the contact.', 'type' => 'string', 'example' => '183*****92'], + 'email' => ['title' => '', 'description' => 'The email address.', 'type' => 'string', 'example' => 'gao******@gmail.com'], + ], + 'example' => '', + ], + 'original_journeys' => [ + 'title' => '', + 'description' => 'The original journeys.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'segment_list' => [ + 'title' => '', + 'description' => 'The segment information.', + 'type' => 'array', + 'items' => [ + 'description' => 'segment', + 'type' => 'object', + 'properties' => [ + 'segment_id' => ['title' => '', 'description' => 'The segment ID. Format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (such as HO1295).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (such as 1295).', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline code (such as HO).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (such as CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline code (such as CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The cabin code.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This parameter has a value when stopQuantity is greater than 0. Multiple cities are separated by commas.', 'type' => 'string', 'example' => 'SEL,HKG'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration, in minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'adult_tax' => [ - 'title' => '成人税', - 'description' => 'adult tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '11', + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'changed_journeys' => [ + 'title' => '', + 'description' => 'The journeys after the change.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'segment_list' => [ + 'title' => '', + 'description' => 'The segment information.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'segment_id' => ['title' => '', 'description' => 'The segment ID. Format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (such as HO1295).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (such as 1295).', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline code (such as HO).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (such as CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline code (such as CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The cabin code.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This parameter has a value when stopQuantity is greater than 0. Multiple cities are separated by commas.', 'type' => 'string', 'example' => 'SEL,HKG'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration, in minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'child_price' => [ - 'title' => '儿童单价', - 'description' => 'child fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '500', + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'last_journeys' => [ + 'title' => '', + 'description' => 'The journeys from the previous change.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'segment_list' => [ + 'title' => '', + 'description' => 'The segment information.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'segment_id' => ['title' => '', 'description' => 'The segment ID. Format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (such as HO1295).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (such as 1295).', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline code (such as HO).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (such as CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline code (such as CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The cabin code.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This parameter has a value when stopQuantity is greater than 0. Multiple cities are separated by commas.', 'type' => 'string', 'example' => 'SEL,HKG'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration, in minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'child_tax' => [ - 'title' => '儿童税', - 'description' => 'child tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'change_fee_details' => [ + 'title' => '', + 'description' => 'The change fee details at the passenger level.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'passenger' => [ + 'title' => '', + 'description' => 'The passenger information for the change.', + 'type' => 'object', + 'properties' => [ + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number.', 'type' => 'string', 'example' => '411***********4411'], + ], + 'example' => '', ], - 'infant_price' => [ - 'title' => '婴儿单价', - 'description' => 'infant fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '400', + 'change_fee' => [ + 'title' => '', + 'description' => 'The change fee details for the passenger.', + 'type' => 'object', + 'properties' => [ + 'upgrade_fee' => ['title' => '', 'description' => 'The upgrade fee.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'service_fee' => ['title' => '', 'description' => 'The service fee.', 'type' => 'number', 'format' => 'double', 'example' => '50'], + 'tax_fee' => ['title' => '', 'description' => 'The change tax fee.', 'type' => 'number', 'format' => 'double', 'example' => '20'], + ], + 'example' => '', ], - 'infant_tax' => [ - 'title' => '婴儿税', - 'description' => 'infant tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '9', + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + ], + 'example' => '', + ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"change_order_num\\": 0,\\n \\"order_num\\": 0,\\n \\"change_passengers\\": [\\n {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n }\\n ],\\n \\"total_amount\\": 300,\\n \\"order_status\\": 2,\\n \\"close_reason\\": \\"reason desc\\",\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"change_reason_type\\": 1,\\n \\"create_utc_time\\": 1677415276000,\\n \\"last_confirm_utc_time\\": 1677415278000,\\n \\"pay_status\\": 2,\\n \\"pay_success_utc_time\\": 1677415255000,\\n \\"close_utc_time\\": 1677415244000,\\n \\"contact\\": {\\n \\"mobile_country_code\\": \\"86\\",\\n \\"mobile_phone_num\\": \\"183*****92\\",\\n \\"email\\": \\"gao******@gmail.com\\"\\n },\\n \\"original_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"changed_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"last_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"change_fee_details\\": [\\n {\\n \\"passenger\\": {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n },\\n \\"change_fee\\": {\\n \\"upgrade_fee\\": 30,\\n \\"service_fee\\": 50,\\n \\"tax_fee\\": 20\\n }\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'Change order details', + 'changeSet' => [], + ], + 'ChangeDetailListOfBuyer' => [ + 'summary' => 'Queries a paging list of change order summaries by buyer account.', + 'path' => '/airticket/v1/change/buyer/detail-list', + 'methods' => ['get'], + 'schemes' => ['https', 'http'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ + [ + 'name' => 'utc_create_begin', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The start time for change order creation. The value is a 13-digit UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415276000', 'required' => false], + ], + [ + 'name' => 'utc_create_end', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The end time for change order creation. The value is a 13-digit UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415279000', 'required' => false], + ], + [ + 'name' => 'page_index', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The page index.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], + ], + [ + 'name' => 'page_size', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The page size.', 'type' => 'integer', 'format' => 'int32', 'example' => '10', 'required' => false], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. Default value: the language configured for the buyer account.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'PopBaseRes<PageData<ChangeOrderSearchResult>, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', 'description' => ''], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'list' => [ + 'title' => '', + 'description' => 'The data list.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'change_order_num' => ['title' => '', 'description' => 'The change order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4988430***950'], + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4988430***971'], + 'order_status' => ['title' => '', 'description' => 'The application order status. Valid values:'."\n" + .'- 0: initial state'."\n" + .'- 1: pending payment'."\n" + .'- 2: payment successful'."\n" + .'- 3: change successful'."\n" + .'- 4: change closed.', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'pay_status' => ['title' => '', 'description' => 'The payment status. Valid values:'."\n" + .'- 0: initial state'."\n" + .'- 1: pending payment'."\n" + .'- 2: payment successful'."\n" + .'- 3: transaction successful'."\n" + .'- 4: paid order closed successfully'."\n" + .'- 5: unpaid order closed successfully.', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'transaction_no' => ['title' => '', 'description' => 'The transaction number.', 'type' => 'string', 'example' => 'hkduendkd-2023-dj0'], + 'utc_create_time' => ['title' => '', 'description' => 'The order creation time. The value is a UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415274000'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'pagination' => [ + 'title' => '', + 'description' => 'The pagination information.', + 'type' => 'object', + 'properties' => [ + 'total_count' => ['title' => '', 'description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'total_page' => ['title' => '', 'description' => 'The total number of pages.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'current_page' => ['title' => '', 'description' => 'The current page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'page_size' => ['title' => '', 'description' => 'The number of records per page.', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + ], + 'example' => '', + ], + ], + 'example' => '', + ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"change_order_num\\": 0,\\n \\"order_num\\": 0,\\n \\"order_status\\": 2,\\n \\"pay_status\\": 2,\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"utc_create_time\\": 1677415274000\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'ChangeDetailListOfBuyer', + 'changeSet' => [], + ], + 'ChangeDetailListOfOrderNum' => [ + 'summary' => 'Queries the list of change orders by the original order number.', + 'path' => '/airticket/v1/change/order-num/detail-list', + 'methods' => ['get'], + 'schemes' => ['https', 'http'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ + [ + 'name' => 'order_num', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '4988430***700'], + ], + [ + 'name' => 'page_index', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The page index.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], + ], + [ + 'name' => 'page_size', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The page size.', 'type' => 'integer', 'format' => 'int32', 'example' => '20', 'required' => false], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The access token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'PopBaseRes<PageData<ChangeOrderDetail>, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request was successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', 'description' => ''], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'list' => [ + 'title' => '', + 'description' => 'The data list.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'change_order_num' => ['title' => '', 'description' => 'The change order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4988430***950'], + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '5988430***541'], + 'change_passengers' => [ + 'title' => '', + 'description' => 'The list of passengers for the change order.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number.', 'type' => 'string', 'example' => '411***********4411'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'total_amount' => ['title' => '', 'description' => 'The total payment amount of the change order.', 'type' => 'number', 'format' => 'double', 'example' => '300'], + 'order_status' => ['title' => '', 'description' => 'The change order status. Valid values:'."\n" + .'- 0: initial state'."\n" + .'- 1: pending payment'."\n" + .'- 2: payment successful'."\n" + .'- 3: change successful'."\n" + .'- 4: change closed.', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'close_reason' => ['title' => '', 'description' => 'The reason for closing the change order.', 'type' => 'string', 'example' => 'reason desc'], + 'transaction_no' => ['title' => '', 'description' => 'The transaction number.', 'type' => 'string', 'example' => 'hkduendkd-2023-dj0'], + 'change_reason_type' => ['title' => '', 'description' => 'The change reason type. Valid values:'."\n" + .'- 0: voluntary date change'."\n" + .'- 1: flight schedule change or flight cancellation'."\n" + .'- 2: change due to epidemic.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'create_utc_time' => ['title' => '', 'description' => 'The creation time of the change order, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415276000'], + 'last_confirm_utc_time' => ['title' => '', 'description' => 'The latest payment deadline for the buyer, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415278000'], + 'pay_status' => ['title' => '', 'description' => 'The payment status. Valid values:'."\n" + .'- 0: initial state'."\n" + .'- 1: pending payment'."\n" + .'- 2: payment successful'."\n" + .'- 3: transaction transfer successful'."\n" + .'- 4: paid order closed successfully'."\n" + .'- 5: unpaid order closed successfully.', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'pay_success_utc_time' => ['title' => '', 'description' => 'The time when the buyer completed the payment, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415255000'], + 'close_utc_time' => ['title' => '', 'description' => 'The time when the order was closed, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677415244000'], + 'contact' => [ + 'title' => '', + 'description' => 'The contact information for the change order.', + 'type' => 'object', + 'properties' => [ + 'mobile_country_code' => ['title' => '', 'description' => 'The country calling code.', 'type' => 'string', 'example' => '86'], + 'mobile_phone_num' => ['title' => '', 'description' => 'The mobile phone number of the contact.', 'type' => 'string', 'example' => '183*****92'], + 'email' => ['title' => '', 'description' => 'The email address.', 'type' => 'string', 'example' => 'gao******@gmail.com'], + ], + 'example' => '', ], - 'journey_list' => [ - 'title' => '行程', - 'description' => 'segment list', + 'original_journeys' => [ + 'title' => '', + 'description' => 'The original journeys.', 'type' => 'array', 'items' => [ - 'description' => 'segment', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'segment Info', + 'title' => '', + 'description' => 'The segment information.', 'type' => 'array', 'items' => [ - 'description' => 'segment', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'segment ID format: flight no.+departure airport[IATA airport code]+arrival airport[IATA airport code]+departure time(MMdd)', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'departure airport code (capitalized)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'arrival airport code (capitalized)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'departure city code (capitalized)', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'arrival city code (capitalized)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'marketing airline flight no. (ex.: KA5809)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'marketing airline integer flight no. (ex.: 5809)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1259', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'marketing airline code (ex.: KA)', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'operating airline flight no. (ex.: CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'operating airline code (ex.: CX)', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'departure time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'arrival time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'code share or not', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'departure terminal', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'arrival terminal', - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'equipment type', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'cabin class', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数。取值范围 1,2,3,4,5,6,7,8,9,A；A 表示余座大于9。', - 'description' => 'available seats (for reference only)', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'stop city list'."\n" - .'when stop_quantity > 1, use “,” for seperation', - 'type' => 'string', - 'example' => 'MFM,PVG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'number of stops', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'flight time, unit: minute', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], + 'segment_id' => ['title' => '', 'description' => 'The segment ID. Format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (such as HO1295).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (such as 1295).', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline code (such as HO).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (such as CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline code (such as CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether this is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The cabin code.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This field has a value when stopQuantity is greater than 0. Multiple cities are separated by commas.', 'type' => 'string', 'example' => 'SEL,HKG'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration in minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'segment_baggage_mapping_list' => [ - 'title' => '免费行李规则', - 'description' => 'baggage rule', + 'changed_journeys' => [ + 'title' => '', + 'description' => 'The journeys after the change.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个免费行李规则', - 'description' => 'segment id list. '."\n" - .'all the listed segment id share the same baggage rule', + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'segment_list' => [ + 'title' => '', + 'description' => 'The segment information.', 'type' => 'array', 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - ], - 'passenger_baggage_allowance_mapping' => [ - 'title' => '乘客类型-免费行李额映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => 'baggage rule mapping, key is passenger type, value is baggage allowance details', - 'type' => 'object', - 'additionalProperties' => [ + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'baggage_amount' => [ - 'title' => '托运行李件数', - 'description' => 'checked baggage quantity', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'baggage_weight' => [ - 'title' => '托运行李重量', - 'description' => 'checked baggage weight', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'baggage_weight_unit' => [ - 'title' => '托运行李重量单位 KG', - 'description' => 'checked baggage weight unit', - 'type' => 'string', - 'example' => 'kg', - ], - 'is_all_weight' => [ - 'title' => '是否所有托运行李重量', - 'description' => 'whether weight basis', - 'type' => 'boolean', - 'example' => 'kg', - ], - 'carry_on_amount' => [ - 'title' => '手提行李件数', - 'description' => 'carry-on baggage quantity', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'carry_on_weight' => [ - 'title' => '手提行李重量', - 'description' => 'carry-on baggage weight', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'carry_on_weight_unit' => [ - 'title' => '手提行李重量单位 KG', - 'description' => 'carry-on baggage weight unit', - 'type' => 'string', - 'example' => 'kg', - ], - 'is_all_carry_on_weight' => [ - 'title' => '是否所有手提行李重量', - 'description' => 'whether weight basis', - 'type' => 'boolean', - 'example' => 'true', - ], + 'segment_id' => ['title' => '', 'description' => 'The segment ID. Format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (such as HO1295).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (such as 1295).', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline code (such as HO).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (such as CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline code (such as CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether this is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The cabin code.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This field has a value when stopQuantity is greater than 0. Multiple cities are separated by commas.', 'type' => 'string', 'example' => 'SEL,HKG'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration in minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], ], - 'description' => 'baggage allowance detail', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'segment_refund_change_rule_mapping_list' => [ - 'title' => '退改签规则', - 'description' => 'change and refund policy', + 'last_journeys' => [ + 'title' => '', + 'description' => 'The journeys from the previous change.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个退改签规则', - 'description' => 'segment id list. '."\n" - .'all the listed segment ids share the same change and refund policy', + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'segment_list' => [ + 'title' => '', + 'description' => 'The segment information.', 'type' => 'array', 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - ], - 'refund_change_rule_map' => [ - 'title' => '乘机人类型-退改签规则映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => 'change and refund policy mapping, key is passenger type, value is change and refund policy details', - 'type' => 'object', - 'additionalProperties' => [ + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'refund_rule_all_unused_list' => [ - 'title' => '全程未使用退票规则', - 'description' => 'refund rule for all-unused tickets', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'type: 0 - fully-unused ticket; 1 - partially used ticket', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable refund rule start time, time unit (day/hour)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable refund rule end time, time unit (day/hour)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'whether refundable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'refund fee X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'whether tax is fully refundable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'tax amount refundable X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - ], - 'description' => 'elements', - ], - ], - 'refund_rule_part_unused_list' => [ - 'title' => '部分未使用退票规则', - 'description' => 'refund rule for partially-used tickets', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'type: 0 - fully-unused ticket; 1 - partially used ticket', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable refund rule start time, time unit (day/hour)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable refund rule end time, time unit (day/hour)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'whether refundable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'refund fee X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'whether tax is fully refundable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'tax amount refundable X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - ], - 'description' => 'elements', - ], - ], - 'change_rule_in_unused_list' => [ - 'title' => '回程未使用改签规则', - 'description' => 'change rule for inbound segment unused tickets', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'type: 2 - outbound segment unused; 3 - inbound segment unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable change rule start time, time unit (day/hour)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable change rule end time, time unit (day/hour)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'whether changeable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'change fee X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - ], - 'description' => 'elements', - ], - ], - 'change_rule_out_unused_list' => [ - 'title' => '去程未使用改签规则', - 'description' => 'change rule for outbound segment unused tickets', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'type: 2 - outbound segment unused; 3 - inbound segment unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable change rule start time, time unit (day/hour)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable change rule end time, time unit (day/hour)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'whether changeable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'change fee X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - ], - 'description' => 'elements', - ], - ], + 'segment_id' => ['title' => '', 'description' => 'The segment ID. Format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (such as HO1295).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (such as 1295).', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline code (such as HO).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (such as CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline code (such as CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether this is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The cabin code.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This field has a value when stopQuantity is greater than 0. Multiple cities are separated by commas.', 'type' => 'string', 'example' => 'SEL,HKG'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration in minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], ], - 'description' => 'elements', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'segment_baggage_check_in_info_list' => [ - 'title' => '行李直挂规则', - 'description' => 'through check-in baggage policy', + 'change_fee_details' => [ + 'title' => '', + 'description' => 'The change fee details at the passenger level.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个行李直挂规则', - 'description' => 'segment id list. '."\n" - .'all the listed segment ids share the same baggage through check-in policy', - 'type' => 'array', - 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310'."\n", + 'passenger' => [ + 'title' => '', + 'description' => 'The passenger information for the change.', + 'type' => 'object', + 'properties' => [ + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number.', 'type' => 'string', 'example' => '411***********4411'], ], + 'example' => '', ], - 'luggage_direct_info_type' => [ - 'title' => '行李直挂规则类型 1:航段之间行李直达; 2:航段之间行李重新托运; 3:经停城市行李直达; 4:经停城市行李重新托运', - 'description' => 'through check-in baggage policy type'."\n" - .'1. baggage through check-in between segments'."\n" - .'2. baggage re-check-in needed between segments'."\n" - .'3. baggage through check-in at stop city ( applies for stop flight )'."\n" - .'4. baggage re-checkin needed at stop city ( applies for stop flight )', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], - ], - ], - 'solution_attribute' => [ - 'title' => '报价属性', - 'description' => 'Quotation attributes', - 'type' => 'object', - 'properties' => [ - 'supply_source_type' => [ - 'title' => '供给来源类型 1:自营;2:代理人;3:旗舰店', - 'description' => 'Supply source type 1: Self-operated; 2: Agent; 3: Flagship store', - 'type' => 'string', - 'example' => '1', - ], - 'issue_time_info' => [ - 'title' => '出票时效相关', - 'description' => 'Issue ticket time related', - 'type' => 'object', - 'properties' => [ - 'issue_time_limit' => [ - 'title' => '预计出票时长，单位：分钟', - 'description' => 'Estimated issue ticket time, unit: minutes', - 'type' => 'integer', - 'format' => 'int32', - ], - 'issue_ticket_type' => [ - 'title' => '出票类型 1:支付后; 2起飞前；-1未知', - 'description' => 'Issue ticket type: 1: after payment; 2: before departure; -1: unknown', - 'type' => 'integer', - 'format' => 'int32', + 'change_fee' => [ + 'title' => '', + 'description' => 'The change fee details for the passenger.', + 'type' => 'object', + 'properties' => [ + 'upgrade_fee' => ['title' => '', 'description' => 'The upgrade fee.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'service_fee' => ['title' => '', 'description' => 'The service fee.', 'type' => 'number', 'format' => 'double', 'example' => '50'], + 'tax_fee' => ['title' => '', 'description' => 'The change tax fee.', 'type' => 'number', 'format' => 'double', 'example' => '20'], ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'pagination' => [ + 'title' => '', + 'description' => 'The pagination information.', + 'type' => 'object', + 'properties' => [ + 'total_count' => ['title' => '', 'description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'total_page' => ['title' => '', 'description' => 'The total number of pages.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'current_page' => ['title' => '', 'description' => 'The current page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'page_size' => ['title' => '', 'description' => 'The number of records per page.', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], ], + 'example' => '', ], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'error data', - 'type' => 'any', - 'example' => '{}', + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"change_order_num\\": 0,\\n \\"order_num\\": 0,\\n \\"change_passengers\\": [\\n {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n }\\n ],\\n \\"total_amount\\": 300,\\n \\"order_status\\": 2,\\n \\"close_reason\\": \\"reason desc\\",\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"change_reason_type\\": 1,\\n \\"create_utc_time\\": 1677415276000,\\n \\"last_confirm_utc_time\\": 1677415278000,\\n \\"pay_status\\": 2,\\n \\"pay_success_utc_time\\": 1677415255000,\\n \\"close_utc_time\\": 1677415244000,\\n \\"contact\\": {\\n \\"mobile_country_code\\": \\"86\\",\\n \\"mobile_phone_num\\": \\"183*****92\\",\\n \\"email\\": \\"gao******@gmail.com\\"\\n },\\n \\"original_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"changed_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"last_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"change_fee_details\\": [\\n {\\n \\"passenger\\": {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n },\\n \\"change_fee\\": {\\n \\"upgrade_fee\\": 30,\\n \\"service_fee\\": 50,\\n \\"tax_fee\\": 20\\n }\\n }\\n ]\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'ChangeDetailListOfOrderNum', + 'changeSet' => [], + ], + 'CollectFlightLowestPrice' => [ + 'summary' => 'Collects lowest-price flight information.', + 'path' => '/airticket/v1/data-collect/flight-lowest-price', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'parameters' => [ + [ + 'name' => 'lowest_price_flight_info_list', + 'in' => 'formData', + 'style' => 'json', + 'schema' => [ + 'title' => '', + 'description' => 'The lowest-price flight information.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'request_id' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '123456789dacd', 'required' => false], + 'departure_city' => ['title' => '', 'description' => 'The departure city.', 'type' => 'string', 'required' => true, 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The arrival city.', 'type' => 'string', 'required' => true, 'example' => 'MFM'], + 'trip_type' => ['title' => '', 'description' => 'The trip type. Valid values:'."\n" + .'- 1: one-way'."\n" + .'- 2: round-trip.', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '1'], + 'departure_date' => ['title' => '', 'description' => 'The departure date. Format: yyyy-MM-dd.', 'type' => 'string', 'required' => true, 'example' => '2024-11-11'], + 'return_date' => ['title' => '', 'description' => 'The return date for round-trip scenarios. Format: yyyy-MM-dd.', 'type' => 'string', 'example' => '2024-11-11', 'required' => false], + 'departure_flight_number' => ['title' => '', 'description' => 'The list of outbound flight numbers. Multiple segments are split by commas (,).', 'type' => 'string', 'required' => true, 'example' => 'CA123,CA456'], + 'return_flight_number' => ['title' => '', 'description' => 'The list of return flight numbers. Multiple segments are split by commas (,).', 'type' => 'string', 'example' => 'CA123,CA456', 'required' => false], + 'suez_total_price' => ['title' => '', 'description' => 'The Suez quoted price, including fare and taxes. The currency is USD.', 'type' => 'number', 'format' => 'double', 'required' => true, 'example' => '100.1'], + 'market_total_price' => ['title' => '', 'description' => 'The lowest competitor price in the market, including fare and taxes. The currency is USD.', 'type' => 'number', 'format' => 'double', 'required' => true, 'example' => '100.0'], + 'solution_id' => ['title' => '', 'description' => 'The solution_id returned by Search/Enrich.', 'type' => 'string', 'required' => true, 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ'], ], + 'required' => false, + 'description' => '', + 'title' => '', + 'example' => '', ], + 'required' => true, + 'example' => '', ], ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"2236993B-7BE7-5F92-B179-21FF08570165\\",\\n \\"data\\": {\\n \\"solution_list\\": [\\n {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ\\",\\n \\"adult_price\\": 600,\\n \\"adult_tax\\": 11,\\n \\"child_price\\": 500,\\n \\"child_tax\\": 10,\\n \\"infant_price\\": 400,\\n \\"infant_tax\\": 9,\\n \\"journey_list\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1259,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"MFM,PVG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"segment_baggage_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"passenger_baggage_allowance_mapping\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 1,\\n \\"baggage_weight\\": 1,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 1,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true\\n }\\n }\\n }\\n ],\\n \\"segment_refund_change_rule_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 100,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 20\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 200\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 200\\n }\\n ]\\n }\\n }\\n }\\n ],\\n \\"segment_baggage_check_in_info_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"luggage_direct_info_type\\": 1\\n }\\n ],\\n \\"solution_attribute\\": {\\n \\"supply_source_type\\": \\"1\\",\\n \\"issue_time_info\\": {\\n \\"issue_time_limit\\": 0,\\n \\"issue_ticket_type\\": 0\\n }\\n }\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'Search', - 'description' => 'Enter the information of departure, arrival, departure date, passenger number and cabin, return the lowest price for each flight.', - 'translator' => 'machine', + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'PopBaseRes<LowestPriceFlightSyncRes, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], + 'data' => ['title' => '', 'description' => 'The data returned for a successful request.', 'type' => 'object', 'example' => 'null'], + 'error_data' => ['title' => '', 'description' => 'The data returned for a failed request.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": null,\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'CollectFlightLowestPrice', + 'description' => 'Collects lowest-price flight information.', + 'changeSet' => [], ], 'Enrich' => [ - 'summary' => 'Search-Enrich', + 'summary' => 'Find richer quote information for the itinerary, including free baggage allowance, refund and change rules, and baggage through-check rules.', 'path' => '/airticket/v1/trade/action-enrich', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'accessTokenAuth' => [], ], ], 'deprecated' => false, + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ 'name' => 'solution_id', 'in' => 'formData', - 'schema' => [ - 'title' => 'Search 返回的solution_id', - 'description' => 'The `solution_id` returned by the Search interface', - 'type' => 'string', - 'required' => false, - 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ', - ], + 'schema' => ['title' => '', 'description' => 'solution_id returned by Search', 'type' => 'string', 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ', 'required' => false], ], [ 'name' => 'adults', 'in' => 'formData', - 'schema' => [ - 'title' => '成人乘客数 1-9', - 'description' => 'Number of adult passengers (1-9)', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['title' => '', 'description' => 'Number of adult passengers 1-9', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], ], [ 'name' => 'children', 'in' => 'formData', - 'schema' => [ - 'title' => '儿童乘客数 0-9', - 'description' => 'Number of child passengers (0-9)', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['title' => '', 'description' => 'Number of child passengers 0-9', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], ], [ 'name' => 'infants', 'in' => 'formData', - 'schema' => [ - 'title' => '婴儿乘客数 0-9', - 'description' => 'Number of infant passengers (0-9)', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['title' => '', 'description' => 'Number of infant passengers 0-9', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], ], [ 'name' => 'cabin_class', 'in' => 'formData', - 'schema' => [ - 'title' => '不填写默认为 ALL_CABIN。舱等 ALL_CABIN:不限舱等; Y:经济舱; FC:头等舱和商务舱; S:超级经济舱; YS:经济舱和超级经济舱; YSC:经济舱、超级经济舱和商务舱;', - 'description' => 'Cabin class: ALL_CABIN: All cabin classes; Y: Economy; FC: First Class and Business Class; S: Premium Economy; YS: Economy and Premium Economy; YSC: Economy, Premium Economy, and Business Class;', - 'type' => 'string', - 'required' => false, - 'example' => 'ALL_CABIN', - ], + 'schema' => ['title' => '', 'description' => 'Cabin class ALL_CABIN: all cabin classes; Y: economy; FC: first class and business class; S: premium economy; YS: economy and premium economy; YSC: economy, premium economy, and business class;', 'type' => 'string', 'example' => 'ALL_CABIN', 'required' => false], ], [ 'name' => 'journey_param_list', 'in' => 'formData', 'style' => 'json', 'schema' => [ - 'title' => '行程信息', - 'description' => 'Trip information', + 'title' => '', + 'description' => 'Journey information', 'type' => 'array', 'items' => [ 'description' => 'journey_param', 'type' => 'object', 'properties' => [ - 'departure_city' => [ - 'title' => '起飞城市三字码(大写)', - 'description' => 'Departure city three-letter code (uppercase)', - 'type' => 'string', - 'required' => true, - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '到达城市三字码(大写)', - 'description' => 'Arrival city three-letter code (uppercase)', - 'type' => 'string', - 'required' => true, - 'example' => 'MFM', - ], - 'departure_date' => [ - 'title' => '起飞日期(yyyyMMdd)', - 'description' => 'Departure date (yyyyMMdd)', - 'type' => 'string', - 'required' => true, - 'example' => '20230310', - ], + 'departure_city' => ['title' => '', 'description' => 'Departure city code (3-letter uppercase)', 'type' => 'string', 'required' => true, 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'Arrival city code (3-letter uppercase)', 'type' => 'string', 'required' => true, 'example' => 'MFM'], + 'departure_date' => ['title' => '', 'description' => 'Departure date (yyyyMMdd)', 'type' => 'string', 'required' => true, 'example' => '20230310'], 'segment_param_list' => [ - 'title' => '该程指定航段信息', - 'description' => 'Specified segment information for this trip', + 'title' => '', + 'description' => 'Specified segment information for this journey', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'element', 'type' => 'object', 'properties' => [ - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Flight departure city three-letter code (uppercase)', - 'type' => 'string', - 'required' => false, - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Flight arrival city three-letter code (uppercase)', - 'type' => 'string', - 'required' => false, - 'example' => 'MFM', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Flight departure airport three-letter code (uppercase)', - 'type' => 'string', - 'required' => false, - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Flight arrival airport three-letter code (uppercase)', - 'type' => 'string', - 'required' => false, - 'example' => 'MFM', - ], - 'departure_time' => [ - 'title' => '字符串，航班起飞日期时间(yyyy-MM-dd HH:mm:ss)，departure_time和departure_date二选一，建议优先使用更精确的departure_time', - 'description' => 'String, flight departure date and time (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'required' => false, - 'example' => '2023-03-10 07:55:00'."\n", - ], - 'departure_date' => [ - 'title' => '字符串，航班起飞日期(yyyy-MM-dd)，departure_date和departure_time二选一，建议优先使用更精确的departure_time', - 'type' => 'string', - 'required' => false, - 'description' => 'String, flight departure date (yyyy-MM-dd), either departure_date or departure_time, with departure_time preferred for greater accuracy', - 'example' => '2023-03-10', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：KA5809)', - 'description' => 'Marketing flight number (e.g., KA5809)', - 'type' => 'string', - 'required' => true, - 'example' => 'HO1295', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'Cabin', - 'type' => 'string', - 'required' => false, - 'example' => 'V', - ], - 'child_cabin' => [ - 'title' => '儿童舱位', - 'description' => 'Child cabin', - 'type' => 'string', - 'required' => false, - 'example' => 'E', - ], + 'departure_city' => ['title' => '', 'description' => 'Flight departure city code (3-letter uppercase)', 'type' => 'string', 'example' => 'SHA', 'required' => false], + 'arrival_city' => ['title' => '', 'description' => 'Flight arrival city code (3-letter uppercase)', 'type' => 'string', 'example' => 'MFM', 'required' => false], + 'departure_airport' => ['title' => '', 'description' => 'Flight departure airport code (3-letter uppercase)', 'type' => 'string', 'required' => false, 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'Flight arrival airport code (3-letter uppercase)', 'type' => 'string', 'required' => false, 'example' => 'MFM'], + 'departure_time' => ['title' => '', 'description' => 'String, flight departure date and time (yyyy-MM-dd HH:mm:ss)', 'type' => 'string', 'required' => false, 'example' => '2023-03-10 07:55:00'."\n"], + 'marketing_flight_no' => ['title' => '', 'description' => 'Marketing carrier flight number (e.g., KA5809)', 'type' => 'string', 'required' => true, 'example' => 'HO1295'], + 'cabin' => ['title' => '', 'description' => 'Booking class', 'type' => 'string', 'example' => 'V', 'required' => false], + 'child_cabin' => ['title' => '', 'description' => 'Child booking class', 'type' => 'string', 'example' => 'E', 'required' => false], ], 'required' => false, + 'title' => '', + 'example' => '', ], 'required' => true, + 'example' => '', ], ], 'required' => false, + 'title' => '', + 'example' => '', ], 'required' => false, + 'example' => '', ], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'access_token', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'Multi-language, default is based on the buyer\'s account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US'."\n", - ], + 'schema' => ['title' => '', 'description' => 'Multilingual, defaults to buyer account configuration', 'type' => 'string', 'required' => false, 'example' => 'en_US'."\n"], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<EnrichRes, Object>', + 'title' => '', 'description' => 'PopBaseRes<EnrichRes, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http request successful, status value is 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'business error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'whether the request was successful', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'request RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'When HTTP request succeeds, status value is always 200', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'Business error code', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'Error message', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Whether successful', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'Request RequestId', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'correctly processed return data', + 'title' => '', + 'description' => 'Data returned on successful processing', 'type' => 'object', 'properties' => [ 'solution_list' => [ - 'title' => '搜索询价结果', - 'description' => 'search quotation results', + 'title' => '', + 'description' => 'Search and inquiry results', 'type' => 'array', 'items' => [ 'description' => 'solution', 'type' => 'object', 'properties' => [ - 'solution_id' => [ - 'title' => 'solution_id', - 'description' => 'solution_id', - 'type' => 'string', - 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ', - ], - 'adult_price' => [ - 'title' => '成人单价', - 'description' => 'adult unit price', - 'type' => 'number', - 'format' => 'double', - 'example' => '500', - ], - 'adult_tax' => [ - 'title' => '成人税', - 'description' => 'adult tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - 'child_price' => [ - 'title' => '儿童单价', - 'description' => 'child unit price', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - 'child_tax' => [ - 'title' => '儿童税', - 'description' => 'child tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - 'infant_price' => [ - 'title' => '婴儿单价', - 'description' => 'infant unit price', - 'type' => 'number', - 'format' => 'double', - 'example' => '500', - ], - 'infant_tax' => [ - 'title' => '婴儿税', - 'description' => 'infant tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'solution_id' => ['title' => '', 'description' => 'solution_id', 'type' => 'string', 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ'], + 'adult_price' => ['title' => '', 'description' => 'Adult unit price', 'type' => 'number', 'format' => 'double', 'example' => '500'], + 'adult_tax' => ['title' => '', 'description' => 'Adult tax', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'child_price' => ['title' => '', 'description' => 'Child unit price', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'child_tax' => ['title' => '', 'description' => 'Child tax', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'infant_price' => ['title' => '', 'description' => 'Infant unit price', 'type' => 'number', 'format' => 'double', 'example' => '500'], + 'infant_tax' => ['title' => '', 'description' => 'Infant tax', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'refund_ticket_coupon_description' => ['title' => '', 'type' => 'string', 'example' => 'description', 'description' => ''], + 'product_type_description' => ['title' => '', 'type' => 'string', 'example' => 'description', 'description' => ''], 'journey_list' => [ - 'title' => '行程', - 'description' => 'journey', + 'title' => '', + 'description' => 'Journey', 'type' => 'array', 'items' => [ 'description' => 'journey', 'type' => 'object', 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], + 'transfer_count' => ['title' => '', 'description' => 'Number of transfers', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'segment information', + 'title' => '', + 'description' => 'Segment information', 'type' => 'array', 'items' => [ 'description' => 'segment', 'type' => 'object', 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'segment ID format: flight number + departure airport + arrival airport + departure date (MMdd)', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Three-letter code of the departure airport (uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Three-letter code of the arrival airport (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Three-letter code of the departure city (uppercase)', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Three-letter code of the arrival city (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'Marketing flight number (e.g., KA5809)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'Marketing flight number in digits (e.g., 5809)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'Marketing airline (e.g., KA)', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'Operating flight number (e.g., CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'Operating airline (e.g., CX)', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Departure date and time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Arrival date and time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'Whether it is a code-share flight', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'Departure terminal of the flight', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'Arrival terminal of the flight', - 'type' => 'string', - 'example' => 'null', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'Aircraft type', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'Cabin class', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'Cabin grade', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数。取值范围 1,2,3,4,5,6,7,8,9,A；A 表示余座大于9。', - 'description' => 'Number of remaining seats. The value range is 1,2,3,4,5,6,7,8,9,A; A indicates more than 9 seats available.', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'List of stopover cities, with values when stopQuantity > 0, separated by commas', - 'type' => 'string', - 'example' => '""', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'Number of stopover cities', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'Flight duration in minutes', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], + 'segment_id' => ['title' => '', 'description' => 'Segment ID format: flight number + departure airport + arrival airport + departure date (MMdd)', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'Flight departure airport code (3-letter uppercase)', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'Flight arrival airport code (3-letter uppercase)', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'Flight departure city code (3-letter uppercase)', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'Flight arrival city code (3-letter uppercase)', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'Marketing carrier flight number (e.g., KA5809)', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'Marketing carrier numeric flight number (e.g., 5809)', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'Marketing carrier airline (e.g., KA)', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'Operating carrier flight number (e.g., CX601)', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'Operating carrier airline (e.g., CX)', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'Flight departure date and time, string format (yyyy-MM-dd HH:mm:ss)', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'Flight arrival date and time, string format (yyyy-MM-dd HH:mm:ss)', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Whether it is a codeshare flight', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'Flight departure terminal', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'Flight arrival terminal', 'type' => 'string', 'example' => 'null'], + 'equip_type' => ['title' => '', 'description' => 'Aircraft type', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'Booking class', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'Cabin class', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'Remaining seats. Value range: 1,2,3,4,5,6,7,8,9,A; A indicates more than 9 remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'Stopover city list, has value when stopQuantity > 0, multiple values separated by commas', 'type' => 'string', 'example' => '""'], + 'stop_quantity' => ['title' => '', 'description' => 'Number of stopover cities', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'Flight duration, unit: minutes', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'segment_baggage_mapping_list' => [ - 'title' => '免费行李规则', - 'description' => 'Free baggage rules', + 'title' => '', + 'description' => 'Free baggage allowance rules', 'type' => 'array', 'items' => [ - 'description' => 'Segment baggage mapping', + 'description' => 'segment\\_baggage\\_mapping', 'type' => 'object', 'properties' => [ 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个免费行李规则', - 'description' => 'List of segment IDs that use the same free baggage allowance rule', + 'title' => '', + 'description' => 'Segment ID list. These segment IDs share the same free baggage allowance rules', 'type' => 'array', - 'items' => [ - 'description' => 'segment ID', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', ], 'passenger_baggage_allowance_mapping' => [ - 'title' => '乘客类型-免费行李额映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => 'Mapping of passenger type to free baggage allowance', + 'title' => '', + 'description' => 'Passenger type to free baggage allowance mapping', 'type' => 'object', 'additionalProperties' => [ 'type' => 'object', 'properties' => [ - 'baggage_amount' => [ - 'title' => '托运行李件数', - 'description' => 'Number of checked baggage pieces', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '22', - ], - 'baggage_weight' => [ - 'title' => '托运行李重量', - 'description' => 'Weight of checked baggage', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'baggage_weight_unit' => [ - 'title' => '托运行李重量单位 KG', - 'description' => 'Unit of checked baggage weight (KG)', - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_weight' => [ - 'title' => '是否所有托运行李重量', - 'description' => 'Whether the weight applies to all checked baggage', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_on_amount' => [ - 'title' => '手提行李件数', - 'description' => 'Number of carry-on baggage pieces', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'carry_on_weight' => [ - 'title' => '手提行李重量', - 'description' => 'Weight of carry-on baggage', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'carry_on_weight_unit' => [ - 'title' => '手提行李重量单位 KG', - 'description' => 'Carry-on luggage weight unit KG', - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_carry_on_weight' => [ - 'title' => '是否所有手提行李重量', - 'description' => 'Whether it is the total carry-on luggage weight', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_length' => [ - 'title' => '手提长（单位：厘米）', - 'description' => 'Carry-on luggage length (unit: centimeters)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '55', - ], - 'carry_width' => [ - 'title' => '手提宽（单位：厘米）', - 'description' => 'Carry-on luggage width (unit: centimeters)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'carry_height' => [ - 'title' => '手提高（单位：厘米）', - 'description' => 'Carry-on luggage height (unit: centimeters)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'carry_sum_of_length_width_height' => [ - 'title' => '手提三边之和（单位：厘米）', - 'description' => 'Sum of three sides of the Carry-on luggage (unit: centimeters)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '115', - ], - 'length' => [ - 'title' => '托运长（单位：厘米）', - 'description' => 'Check-in luggage length (unit: centimeters)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'width' => [ - 'title' => '托运宽（单位：厘米）', - 'description' => 'Check-in luggage width (unit: centimeters)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'height' => [ - 'title' => '托运高（单位：厘米）', - 'description' => 'Check-in luggage height (unit: centimeters)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'sum_of_length_width_height' => [ - 'title' => '托运三边之和（单位：厘米）', - 'description' => 'Sum of three sides of the Check-in luggage (unit: centimeters)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], + 'baggage_amount' => ['title' => '', 'description' => 'Number of checked baggage pieces', 'type' => 'integer', 'format' => 'int32', 'example' => '22'], + 'baggage_weight' => ['title' => '', 'description' => 'Checked baggage weight', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'baggage_weight_unit' => ['title' => '', 'description' => 'Checked baggage weight unit KG', 'type' => 'string', 'example' => 'KG'], + 'is_all_weight' => ['title' => '', 'description' => 'Whether it is total checked baggage weight', 'type' => 'boolean', 'example' => 'true'], + 'carry_on_amount' => ['title' => '', 'description' => 'Number of carry-on baggage pieces', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'carry_on_weight' => ['title' => '', 'description' => 'Carry-on baggage weight', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'carry_on_weight_unit' => ['title' => '', 'description' => 'Carry-on baggage weight unit KG', 'type' => 'string', 'example' => 'KG'], + 'is_all_carry_on_weight' => ['title' => '', 'description' => 'Whether it is total carry-on baggage weight', 'type' => 'boolean', 'example' => 'true'], ], - 'description' => 'Element', + 'description' => 'element', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'segment_refund_change_rule_mapping_list' => [ - 'title' => '退改签规则', + 'title' => '', 'description' => 'Refund and change rules', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'element', 'type' => 'object', 'properties' => [ 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个退改签规则', - 'description' => 'Segment ID list. These segment IDs use the same refund and change rules.', + 'title' => '', + 'description' => 'Segment ID list. These segment IDs share the same refund and change rules', 'type' => 'array', - 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', ], 'refund_change_rule_map' => [ - 'title' => '乘机人类型-退改签规则映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => 'Passenger type - refund and change rule mapping', + 'title' => '', + 'description' => 'Passenger type to refund and change rules mapping', 'type' => 'object', 'additionalProperties' => [ 'type' => 'object', 'properties' => [ 'refund_rule_all_unused_list' => [ - 'title' => '全程未使用退票规则', - 'description' => 'Full unused ticket refund rules', + 'title' => '', + 'description' => 'Fully unused refund rules', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'The type of itinerary this refund rule applies to 0: fully unused; 1: partially unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'Time unit: day/hour', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'The start time of the refund time interval for this refund rule, in units of (days/hours)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'The end time of the refund time interval for this refund rule, in units of (days/hours)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'Whether a refund is allowed X-Y hours (days) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'Refund fee X-Y hours (days) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'Whether full tax refund is allowed X-Y hours (days) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'Partial tax refund amount X-Y hours (days) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], + 'type' => ['title' => '', 'description' => 'Refund rule applicable journey usage type 0: fully unused; 1: partially unused', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => 'Time unit: day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => 'Start time of the refund time interval applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => 'End time of the refund time interval applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => 'Whether refund is allowed X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => 'Refund fee X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'can_return_all_tax' => ['title' => '', 'description' => 'Whether full tax refund is available X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => 'Partial tax refund amount X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '20'], ], - 'description' => 'Element', + 'description' => 'element', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'refund_rule_part_unused_list' => [ - 'title' => '部分未使用退票规则', - 'description' => 'Partial unused ticket refund rules', + 'title' => '', + 'description' => 'Partially unused refund rules', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'The type of itinerary usage for this refund rule. 0: Entirely unused; 1: Partially unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'Time unit: day/hour', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'The start time of the refund time interval for this refund rule, in units of days/hours', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'The end time of the refund time interval for this refund rule, in units of days/hours', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'Whether a refund is allowed X-Y hours (days) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'Refund fee X-Y hours (days) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'Whether full tax refund is allowed X-Y hours (days) before departure', - 'type' => 'boolean', - 'example' => '30', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'Partial tax refund amount X-Y hours (days) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], + 'type' => ['title' => '', 'description' => 'Refund rule applicable journey usage type 0: fully unused; 1: partially unused', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'time_unit' => ['title' => '', 'description' => 'Time unit: day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => 'Start time of the refund time interval applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => 'End time of the refund time interval applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => 'Whether refund is allowed X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => 'Refund fee X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'can_return_all_tax' => ['title' => '', 'description' => 'Whether full tax refund is available X-Y hours (days) before departure', 'type' => 'boolean', 'example' => '30'], + 'return_part_tax_fee' => ['title' => '', 'description' => 'Partial tax refund amount X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '20'], ], - 'description' => 'Element', + 'description' => 'element', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'change_rule_in_unused_list' => [ - 'title' => '回程未使用改签规则', - 'description' => 'Unused return flight change rules', + 'title' => '', + 'description' => 'Return/inbound unused change rules', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'Type of itinerary usage for the change rule 2: outbound unused; 3: return unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'Time unit: day/hour', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'Start time of the refund time interval, in units of days/hours, to which this refund rule applies', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'End time of the refund time interval, in units of days/hours, to which this refund rule applies', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'Whether it is possible to change the ticket X-Y hours (days) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'Change fee X-Y hours (days) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], + 'type' => ['title' => '', 'description' => 'Change rule applicable journey usage type 2: outbound unused; 3: return/inbound unused', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => 'Time unit: day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => 'Start time of the refund time interval applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => 'End time of the refund time interval applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => 'Whether rebooking is allowed X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => 'Rebooking fee X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '20'], ], - 'description' => 'Element', + 'description' => 'element', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'change_rule_out_unused_list' => [ - 'title' => '去程未使用改签规则', - 'description' => 'Unused outbound change rules', + 'title' => '', + 'description' => 'Outbound unused change rules', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'The type of itinerary usage for this change rule 2: unused outbound; 3: unused return', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'Time unit: day/hour', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'Start time of the refund time interval for this refund rule, in days/hours', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'End time of the refund time interval for this refund rule, in days/hours', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'Whether it is possible to change the ticket X-Y hours (days) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'Change fee X-Y hours (days) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], + 'type' => ['title' => '', 'description' => 'Change rule applicable journey usage type 2: outbound unused; 3: return/inbound unused', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => 'Time unit: day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => 'Start time of the refund time interval applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => 'End time of the refund time interval applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => 'Whether rebooking is allowed X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => 'Rebooking fee X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '10'], ], - 'description' => 'Element', + 'description' => 'element', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], - 'description' => 'Element', + 'description' => 'element', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'segment_baggage_check_in_info_list' => [ - 'title' => '行李直挂规则', - 'description' => 'Baggage check-in rules', + 'title' => '', + 'description' => 'Baggage through-check rules', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'element', 'type' => 'object', 'properties' => [ 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个行李直挂规则', - 'description' => 'List of segment IDs that use the same baggage check-in rule', + 'title' => '', + 'description' => 'Segment ID list. These segment IDs share the same baggage through-check rules', 'type' => 'array', - 'items' => [ - 'description' => 'Segment ID', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - ], - 'luggage_direct_info_type' => [ - 'title' => '行李直挂规则类型 1:航段之间行李直达; 2:航段之间行李重新托运; 3:经停城市行李直达; 4:经停城市行李重新托运', - 'description' => 'Baggage check-in rule type 1: Direct baggage between segments; 2: Re-check baggage between segments; 3: Direct baggage at stopover cities; 4: Re-check baggage at stopover cities', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', ], + 'luggage_direct_info_type' => ['title' => '', 'description' => 'Baggage through-check rule type 1: baggage through-checked between segments; 2: baggage re-checked between segments; 3: baggage through-checked at stopover city; 4: baggage re-checked at stopover city', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'solution_attribute' => [ - 'title' => '报价属性', - 'description' => 'Quotation attributes', + 'title' => '', + 'description' => 'Quote attributes', 'type' => 'object', 'properties' => [ - 'supply_source_type' => [ - 'title' => '供给来源类型 1:自营;2:代理人;3:旗舰店', - 'description' => 'Supply source type 1: Self-operated; 2: Agent; 3: Flagship store', - 'type' => 'string', - 'example' => '1', - ], - 'issue_time_info' => [ - 'title' => '出票时效相关', - 'description' => 'Issue ticket time related', - 'type' => 'object', - 'properties' => [ - 'issue_time_limit' => [ - 'title' => '预计出票时长，单位：分钟', - 'description' => 'Estimated issue ticket time, unit: minutes', - 'type' => 'integer', - 'format' => 'int32', - ], - 'issue_ticket_type' => [ - 'title' => '出票类型 1:支付后; 2起飞前；-1未知', - 'description' => 'Issue ticket type: 1: after payment; 2: before departure; -1: unknown', - 'type' => 'integer', - 'format' => 'int32', - ], - ], - ], + 'supply_source_type' => ['title' => '', 'description' => 'Supply source type 1: self-operated; 2: agent; 3: flagship store', 'type' => 'string', 'example' => '1'], ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Data carried in error handling', - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'Data carried on error processing', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"solution_list\\": [\\n {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ\\",\\n \\"adult_price\\": 500,\\n \\"adult_tax\\": 100,\\n \\"child_price\\": 100,\\n \\"child_tax\\": 100,\\n \\"infant_price\\": 500,\\n \\"infant_tax\\": 100,\\n \\"journey_list\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"null\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"\\\\\\"\\\\\\"\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"segment_baggage_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"passenger_baggage_allowance_mapping\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 22,\\n \\"baggage_weight\\": 2,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 2,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true,\\n \\"carry_length\\": 55,\\n \\"carry_width\\": 40,\\n \\"carry_height\\": 20,\\n \\"carry_sum_of_length_width_height\\": 115,\\n \\"length\\": 60,\\n \\"width\\": 40,\\n \\"height\\": 60,\\n \\"sum_of_length_width_height\\": 200\\n }\\n }\\n }\\n ],\\n \\"segment_refund_change_rule_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 20,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 20\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 1,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 20,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 20\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 20\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 10\\n }\\n ]\\n }\\n }\\n }\\n ],\\n \\"segment_baggage_check_in_info_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"luggage_direct_info_type\\": 1\\n }\\n ],\\n \\"solution_attribute\\": {\\n \\"supply_source_type\\": \\"1\\",\\n \\"issue_time_info\\": {\\n \\"issue_time_limit\\": 0,\\n \\"issue_ticket_type\\": 0\\n }\\n }\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"solution_list\\": [\\n {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ\\",\\n \\"adult_price\\": 500,\\n \\"adult_tax\\": 100,\\n \\"child_price\\": 100,\\n \\"child_tax\\": 100,\\n \\"infant_price\\": 500,\\n \\"infant_tax\\": 100,\\n \\"refund_ticket_coupon_description\\": \\"description\\",\\n \\"product_type_description\\": \\"description\\",\\n \\"journey_list\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"null\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"\\\\\\"\\\\\\"\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"segment_baggage_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"passenger_baggage_allowance_mapping\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 22,\\n \\"baggage_weight\\": 2,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 2,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true\\n }\\n }\\n }\\n ],\\n \\"segment_refund_change_rule_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 20,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 20\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 1,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 20,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 20\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 20\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 10\\n }\\n ]\\n }\\n }\\n }\\n ],\\n \\"segment_baggage_check_in_info_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"luggage_direct_info_type\\": 1\\n }\\n ],\\n \\"solution_attribute\\": {\\n \\"supply_source_type\\": \\"1\\"\\n }\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', 'title' => 'Enrich', - 'description' => 'Choose either `solution_id` or `journey_param_list` in the parameters, and `solution_id` needs to be obtained from the Search interface.', - 'translator' => 'machine', - ], - 'AncillarySuggest' => [ - 'summary' => 'Ancillary - Suggestion', - 'path' => '/airticket/v1/ancillary/action-suggest', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', + 'description' => 'In the input parameters, choose either solution\\_id or journey\\_param\\_list. solution\\_id must be obtained from the Search API.', + 'changeSet' => [ + ['createdAt' => '2025-11-06T09:10:48.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-06T03:52:34.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-06T03:52:32.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-04T11:41:35.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-04T11:22:03.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-24T06:03:24.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-24T05:51:47.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-16T02:18:18.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-16T02:18:05.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-15T03:23:12.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-15T03:22:26.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-07-08T02:11:20.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-07-08T02:10:43.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T13:47:33.000Z', 'description' => 'Response parameters changed'], + ['createdAt' => '2025-06-16T13:45:19.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T13:20:00.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T06:40:50.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T04:09:49.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T04:09:45.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T04:09:44.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T03:47:56.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T01:54:11.000Z', 'description' => 'OpenAPI offline'], ], + ], + 'FileUpload' => [ + 'summary' => 'Uploads a file as an attachment image. The file size is limited to 300 KB or less.', + 'path' => '/airticket/v1/attachment/action-upload', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'accessTokenAuth' => [], @@ -2084,1812 +2175,211 @@ 'systemTags' => [], 'parameters' => [ [ - 'name' => 'solution_id', + 'name' => 'order_num', 'in' => 'formData', - 'schema' => [ - 'title' => '机票 solution_id', - 'description' => 'solution_id returned by enrich', - 'type' => 'string', - 'required' => true, - 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ'."\n", - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'Language Code(refer to ISO_639)'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<AncillarySuggestRes, Object>', - 'description' => 'PopBaseRes<AncillarySuggestRes, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http request successful, status value is always 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'Error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'true represents success, false represents failure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'Request ID', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'Properly processed return data', - 'type' => 'object', - 'properties' => [ - 'solution_id' => [ - 'title' => '机票 solution_id', - 'description' => 'solution_id, equals to solution_id in request', - 'type' => 'string', - 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ', - ], - 'seg_ancillary_map_list' => [ - 'title' => '机票-辅营映射关系', - 'description' => 'ancillary detail list', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段使用同一个辅营', - 'description' => 'Segment ID list, these segments share the same ancillary', - 'type' => 'array', - 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310'."\n", - ], - ], - 'ancillary' => [ - 'title' => '辅营产品', - 'description' => 'Ancillary product', - 'type' => 'object', - 'properties' => [ - 'ancillary_id' => [ - 'title' => '辅营商品ID', - 'description' => 'Ancillary product ID', - 'type' => 'string', - 'example' => 'eJwz8DeySEo0NjQ01TU3TU', - ], - 'ancillary_type' => [ - 'title' => '辅营产品类型 当前支持 4:付费行李', - 'description' => 'Ancillary product type. currently supports 4: paid luggage', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '4', - ], - 'baggage_ancillary' => [ - 'title' => '行李辅营详情', - 'description' => 'Baggage details', - 'type' => 'object', - 'properties' => [ - 'baggage_amount' => [ - 'title' => '行李件数 取值如：3、2、1、0、-2。 -2 表示计重', - 'description' => 'baggage quantity, values such as: 3, 2, 1, 0, -2. -2 indicates weight-based', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'baggage_weight' => [ - 'title' => '行李重量，0-50。isAllWeght=true 时，表示所有件数总重量。', - 'description' => 'Baggage weight, 0-50. When isAllWeight=true, it represents the total weight of all baggages.', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'baggage_weight_unit' => [ - 'title' => '行李重量单位', - 'description' => 'Unit of baggage weight', - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_weight' => [ - 'title' => '是否所有行李重量', - 'description' => 'Whether the weight is for all baggages', - 'type' => 'boolean', - 'example' => 'true', - ], - 'price' => [ - 'title' => '总价', - 'description' => 'Total price', - 'type' => 'number', - 'format' => 'double', - 'example' => '10.0', - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Data carried in error handling', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ\\",\\n \\"seg_ancillary_map_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"ancillary\\": {\\n \\"ancillary_id\\": \\"eJwz8DeySEo0NjQ01TU3TU\\",\\n \\"ancillary_type\\": 4,\\n \\"baggage_ancillary\\": {\\n \\"baggage_amount\\": 0,\\n \\"baggage_weight\\": 0,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"price\\": 10\\n }\\n }\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'AncillarySuggest', - 'description' => 'search ancillary for selected solution, you should enter the solution_id returned by enrich.', - 'translator' => 'machine', - ], - 'Pricing' => [ - 'summary' => 'Transaction - Seat and Price Verification', - 'path' => '/airticket/v1/trade/action-pricing', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], + 'schema' => ['title' => '', 'description' => 'The forward order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '496***2617111'], ], - ], - 'deprecated' => false, - 'parameters' => [ [ - 'name' => 'solution_id', + 'name' => 'file_content', 'in' => 'formData', - 'schema' => [ - 'title' => 'solution_id', - 'description' => 'solution_id returned by Enrich', - 'type' => 'string', - 'required' => true, - 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ', - ], + 'schema' => ['title' => '', 'description' => 'The Base64-encoded string of the attachment image file. Supported image types: .jpg, .png, and .jpeg.', 'type' => 'string', 'required' => true, 'example' => '0r2LSuIsHlxEoGZcnGe34U1njBOR83Q4HNSvMDGrDPK5J71VjcGdRIWz2x3+tFxvQaduwHB46Z9K'."\n" + .'dbIoDN8xPQ5PWlky8rKOPmAqSZfIRyPmAwvPvTJFwr8bRgHPPaq2VO8kHJ6jFIpJJ5I7Zqd1BjGS'."\n" + .'SR/kULQZHsDDd2zgA9RRTsEQF2OSxFFFx2P/2Q=='], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token'."\n" - ."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'language code(refer to ISO_639), defaults to the buyer\'s account configuration'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'The language setting. Uses the buyer account configuration by default.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<PricingRes, Object>', - 'description' => 'PopBaseRes<PricingRes, Object>', + 'title' => '', + 'description' => 'PopBaseRes<UploadAttachmentRes, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http request has been processed successfully，status code is 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'true represents success, false represents failure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'request ID', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'data', + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ - 'solution' => [ - 'title' => 'solution', - 'description' => 'the solution represented by the solution_id in request', - 'type' => 'object', - 'properties' => [ - 'solution_id' => [ - 'title' => 'solution_id', - 'description' => 'solution_id, equals to solution_id in request', - 'type' => 'string', - 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ', - ], - 'adult_price' => [ - 'title' => '成人单价', - 'description' => 'adult fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '300', - ], - 'adult_tax' => [ - 'title' => '成人税', - 'description' => 'adult tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'child_price' => [ - 'title' => '儿童单价', - 'description' => 'child fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'child_tax' => [ - 'title' => '儿童税', - 'description' => 'child tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - 'infant_price' => [ - 'title' => '婴儿单价', - 'description' => 'infant fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'infant_tax' => [ - 'title' => '婴儿税', - 'description' => 'infant tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], - 'journey_list' => [ - 'title' => '行程', - 'description' => 'journey list'."\n" - ."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'journey', - 'type' => 'object', - 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'segment list'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'segment', - 'type' => 'object', - 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'segment ID format: flight no.+departure airport[IATA airport code]+arrival airport[IATA airport code]+departure time(MMdd)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'departure airport code (capitalized)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'arrival airport code (capitalized)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'departure city code (capitalized)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'arrival city code (capitalized)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'marketing airline flight no. (eg: KA5809)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'marketing airline flight no. (eg: 5809)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'marketing airline code (eg: KA)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'operating airline flight no. (eg: CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'operating airline code (eg: CX)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'departure time in string format (yyyy-MM-dd HH:mm:ss)'."\n" - ."\n", - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'arrival time in string format (yyyy-MM-dd HH:mm:ss)'."\n" - ."\n", - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'code share or not'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'departure terminal'."\n" - ."\n", - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'arrival terminal'."\n" - ."\n", - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'equipment type'."\n" - ."\n", - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'cabin class'."\n" - ."\n", - 'type' => 'string', - 'example' => 'ALL_CABIN', - ], - 'availability' => [ - 'title' => '剩余座位数。取值范围 1,2,3,4,5,6,7,8,9,A；A 表示余座大于9。', - 'description' => 'available seats (for reference only)'."\n" - ."\n", - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'stop city list. when stop_quantity > 1 , use “,” for seperation', - 'type' => 'string', - 'example' => 'MFM,PVG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'number of stops', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'flight time, unit: minute'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], - ], - ], - ], - ], - ], - ], - 'segment_baggage_mapping_list' => [ - 'title' => '免费行李规则', - 'description' => 'baggage rule list'."\n" - ."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个免费行李规则', - 'description' => 'segment id list all the listed segment id share the same baggage rule'."\n" - ."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310'."\n", - ], - ], - 'passenger_baggage_allowance_mapping' => [ - 'title' => '乘客类型-免费行李额映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => 'baggage rule mapping, key is passenger type, value is baggage allowance details', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'object', - 'properties' => [ - 'baggage_amount' => [ - 'title' => '托运行李件数', - 'description' => 'checked baggage quantity', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'baggage_weight' => [ - 'title' => '托运行李重量', - 'description' => 'checked baggage weight'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'baggage_weight_unit' => [ - 'title' => '托运行李重量单位 KG', - 'description' => 'checked baggage weight unit'."\n" - ."\n", - 'type' => 'string', - 'example' => 'kg', - ], - 'is_all_weight' => [ - 'title' => '是否所有托运行李重量', - 'description' => 'Whether the weight is for all baggages', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_on_amount' => [ - 'title' => '手提行李件数', - 'description' => 'carry on baggage quantity', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'carry_on_weight' => [ - 'title' => '手提行李重量', - 'description' => 'carry-on baggage weight'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'carry_on_weight_unit' => [ - 'title' => '手提行李重量单位 KG', - 'description' => 'carry-on baggage weight unit'."\n" - ."\n", - 'type' => 'string', - 'example' => 'kg', - ], - 'is_all_carry_on_weight' => [ - 'title' => '是否所有手提行李重量', - 'description' => 'Whether the weight is for all baggages', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_length' => [ - 'title' => '手提长（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '55', - ], - 'carry_width' => [ - 'title' => '手提宽（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'carry_height' => [ - 'title' => '手提高（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'carry_sum_of_length_width_height' => [ - 'title' => '手提三边之和（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '115', - ], - 'length' => [ - 'title' => '托运长（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'width' => [ - 'title' => '托运宽（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'height' => [ - 'title' => '托运高（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'sum_of_length_width_height' => [ - 'title' => '托运三边之和（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - ], - 'description' => 'baggage allowance details', - ], - ], - ], - ], - ], - 'segment_refund_change_rule_mapping_list' => [ - 'title' => '退改签规则', - 'description' => 'change and refund policy'."\n" - ."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'elements', - 'type' => 'object', - 'properties' => [ - 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个退改签规则', - 'description' => 'segment id list. all the listed segment ids share the same change and refund policy', - 'type' => 'array', - 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - ], - 'refund_change_rule_map' => [ - 'title' => '乘机人类型-退改签规则映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => 'change and refund policy mapping, key is passenger type, value is change and refund policy detail'."\n" - ."\n", - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'object', - 'properties' => [ - 'refund_rule_all_unused_list' => [ - 'title' => '全程未使用退票规则', - 'description' => 'refund rule for fully-unused tickets', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'type: 0 - fully-unused ticket; 1 - partially used ticket', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable refund rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable refund rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'whether refundable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'refund fee X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'whether tax is fully refundable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'tax amount refundable X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], - ], - 'description' => 'elements', - ], - ], - 'refund_rule_part_unused_list' => [ - 'title' => '部分未使用退票规则', - 'description' => 'refund rule for partially-used tickets'."\n" - ."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'type: 0 - fully-unused ticket; 1 - partially used ticket', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable refund rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable refund rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'whether refundable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'refund fee X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'whether tax is fully refundable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'false', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'tax amount refundable X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - ], - 'description' => 'elements', - ], - ], - 'change_rule_in_unused_list' => [ - 'title' => '回程未使用改签规则', - 'description' => 'change rule for inbound segment unused tickets', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'type: 2 - outbound segment unused; 3 - inbound segment unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable change rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable change rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'whether changeable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'change fee X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], - ], - 'description' => 'elements', - ], - ], - 'change_rule_out_unused_list' => [ - 'title' => '去程未使用改签规则', - 'description' => 'change rule for outbound segment unused tickets', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'type: 2 - outbound segment unused; 3 - inbound segment unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '3', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable change rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable change rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'whether changeable X-Y hour(day) before departure', - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'change fee X-Y hour(day) before departure', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], - ], - 'description' => 'elements', - ], - ], - ], - 'description' => 'elements', - ], - ], - ], - ], - ], - 'segment_baggage_check_in_info_list' => [ - 'title' => '行李直挂规则', - 'description' => 'through check-in baggage policy', - 'type' => 'array', - 'items' => [ - 'description' => 'elements', - 'type' => 'object', - 'properties' => [ - 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个行李直挂规则', - 'description' => 'segment id list. all the listed segment ids share the same baggage through check-in policy', - 'type' => 'array', - 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310'."\n", - ], - ], - 'luggage_direct_info_type' => [ - 'title' => '行李直挂规则类型 1:航段之间行李直达; 2:航段之间行李重新托运; 3:经停城市行李直达; 4:经停城市行李重新托运', - 'description' => 'through check-in baggage policy type'."\n" - ."\n" - .'1. baggage through check-in between segments'."\n" - .'2. baggage re-check-in needed between segments'."\n" - .'3. baggage through check-in at stop city ( applies for stop flight )'."\n" - .'4. baggage re-checkin needed at stop city ( applies for stop flight )', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], - ], - ], - 'solution_attribute' => [ - 'title' => '报价属性', - 'description' => 'Quotation attributes', - 'type' => 'object', - 'properties' => [ - 'supply_source_type' => [ - 'title' => '供给来源类型 1:自营;2:代理人;3:旗舰店', - 'description' => 'Supply source type 1: Self-operated; 2: Agent; 3: Flagship store', - 'type' => 'string', - ], - 'issue_time_info' => [ - 'title' => '出票时效相关', - 'description' => 'Issue ticket time related', - 'type' => 'object', - 'properties' => [ - 'issue_time_limit' => [ - 'title' => '预计出票时长，单位：分钟', - 'description' => 'Estimated issue ticket time, unit: minutes', - 'type' => 'integer', - 'format' => 'int32', - ], - 'issue_ticket_type' => [ - 'title' => '出票类型 1:支付后; 2起飞前；-1未知', - 'description' => 'Issue ticket type: 1: after payment; 2: before departure; -1: unknown', - 'type' => 'integer', - 'format' => 'int32', - ], - ], - ], - ], - ], - ], - ], - 'is_changed' => [ - 'title' => '是否变价', - 'description' => 'whether the price has changed', - 'type' => 'boolean', - 'example' => 'true', - ], - 'original_price_info' => [ - 'title' => '变价之前价格信息 isChanged = true 时，才有值', - 'description' => 'the price information before the change, only available when is_changed = true', - 'type' => 'object', - 'properties' => [ - 'adult_tax' => [ - 'title' => '成人税', - 'description' => 'adult tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - 'child_tax' => [ - 'title' => '儿童税', - 'description' => 'child tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - 'infant_tax' => [ - 'title' => '婴儿税', - 'description' => 'infant tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - 'adult_price' => [ - 'title' => '成人单价', - 'description' => 'adult fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'child_price' => [ - 'title' => '儿童单价', - 'description' => 'child fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'infant_price' => [ - 'title' => '婴儿单价', - 'description' => 'infant fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - ], - ], - 'changed_price_info' => [ - 'title' => '变价之后价格信息 isChanged = true 时，才有值', - 'description' => 'price information after the price change', - 'type' => 'object', - 'properties' => [ - 'adult_tax' => [ - 'title' => '成人税', - 'description' => 'adult tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], - 'child_tax' => [ - 'title' => '儿童税', - 'description' => 'child tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], - 'infant_tax' => [ - 'title' => '婴儿税', - 'description' => 'infant tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], - 'adult_price' => [ - 'title' => '成人单价', - 'description' => 'adult fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - 'child_price' => [ - 'title' => '儿童单价', - 'description' => 'child fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - 'infant_price' => [ - 'title' => '婴儿单价', - 'description' => 'infant fare', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - ], - ], - 'remain_seats' => [ - 'title' => '剩余座位数，A 表示大于9，0-9 代表具体数字', - 'description' => 'remaining seats: A indicates more than 9, 0-9 represents the specific number', - 'type' => 'string', - 'example' => 'A', - ], + 'uploaded_file_url' => ['title' => '', 'description' => 'The file name after upload.', 'type' => 'string', 'example' => 'https://fliggy-flight-jinghang-bucket.oss-cn-zhangjiakou.aliyuncs.com/suez/flight_suez_9a634376****47.jpeg'], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'error data'."\n" - ."\n", - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with an error response.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"solution\\": {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ\\",\\n \\"adult_price\\": 300,\\n \\"adult_tax\\": 30,\\n \\"child_price\\": 200,\\n \\"child_tax\\": 20,\\n \\"infant_price\\": 200,\\n \\"infant_tax\\": 10,\\n \\"journey_list\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"ALL_CABIN\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"\\\\\\"\\\\\\"\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"segment_baggage_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"passenger_baggage_allowance_mapping\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 1,\\n \\"baggage_weight\\": 10,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 10,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true,\\n \\"carry_length\\": 55,\\n \\"carry_width\\": 40,\\n \\"carry_height\\": 20,\\n \\"carry_sum_of_length_width_height\\": 115,\\n \\"length\\": 60,\\n \\"width\\": 40,\\n \\"height\\": 60,\\n \\"sum_of_length_width_height\\": 200\\n }\\n }\\n }\\n ],\\n \\"segment_refund_change_rule_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 1,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 10,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 10\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 20,\\n \\"can_return_all_tax\\": false,\\n \\"return_part_tax_fee\\": 30\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 10\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 3,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 10\\n }\\n ]\\n }\\n }\\n }\\n ],\\n \\"segment_baggage_check_in_info_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"luggage_direct_info_type\\": 1\\n }\\n ],\\n \\"solution_attribute\\": {\\n \\"supply_source_type\\": \\"\\",\\n \\"issue_time_info\\": {\\n \\"issue_time_limit\\": 0,\\n \\"issue_ticket_type\\": 0\\n }\\n }\\n },\\n \\"is_changed\\": true,\\n \\"original_price_info\\": {\\n \\"adult_tax\\": 20,\\n \\"child_tax\\": 20,\\n \\"infant_tax\\": 20,\\n \\"adult_price\\": 200,\\n \\"child_price\\": 200,\\n \\"infant_price\\": 200\\n },\\n \\"changed_price_info\\": {\\n \\"adult_tax\\": 10,\\n \\"child_tax\\": 10,\\n \\"infant_tax\\": 10,\\n \\"adult_price\\": 100,\\n \\"child_price\\": 100,\\n \\"infant_price\\": 100\\n },\\n \\"remain_seats\\": \\"A\\"\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'Pricing', - 'description' => 'Check is price and remaining seats of solution you selected has changed. You should enter the solution_id returned by enrich.', - 'translator' => 'machine', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"uploaded_file_url\\": \\"https://fliggy-flight-jinghang-bucket.oss-cn-zhangjiakou.aliyuncs.com/suez/flight_suez_9a634376****47.jpeg\\"\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'FileUpload', + 'changeSet' => [], ], - 'Book' => [ - 'summary' => 'Transaction-Reservation', - 'path' => '/airticket/v1/trade/action-book', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'FlightChangeOfOrder' => [ + 'summary' => 'Queries flight change information by order number.', + 'path' => '/airticket/v1/flightchange/of-order', + 'methods' => ['get'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'accessTokenAuth' => [], ], ], 'deprecated' => false, + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'solution_id', - 'in' => 'formData', - 'schema' => [ - 'title' => 'solution_id', - 'description' => 'solution_id returned by Enrich', - 'type' => 'string', - 'required' => true, - 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ', - ], - ], - [ - 'name' => 'out_order_num', - 'in' => 'formData', - 'schema' => [ - 'title' => '外部订单号', - 'description' => 'external order number(buyer customization)', - 'type' => 'string', - 'required' => true, - 'example' => 'x091-2023-0220-j-0001', - ], - ], - [ - 'name' => 'contact', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'title' => '联系信息', - 'description' => 'contact information', - 'type' => 'object', - 'properties' => [ - 'last_name' => [ - 'title' => '姓', - 'description' => 'last name', - 'type' => 'string', - 'required' => false, - 'example' => 'ZHANG', - ], - 'first_name' => [ - 'title' => '名', - 'description' => 'first name', - 'type' => 'string', - 'required' => false, - 'example' => 'SAN', - ], - 'mobile_phone_num' => [ - 'title' => '手机号', - 'description' => 'mobile phone number', - 'type' => 'string', - 'required' => false, - 'example' => '183******96', - ], - 'mobile_country_code' => [ - 'title' => '国家区位码', - 'description' => 'country code', - 'type' => 'string', - 'required' => false, - 'example' => '86', - ], - 'email' => [ - 'title' => '邮件地址', - 'description' => 'email address', - 'type' => 'string', - 'required' => false, - 'example' => 'gao******@gmail.com', - ], - ], - 'required' => true, - ], - ], - [ - 'name' => 'passenger_list', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'title' => '乘机人列表', - 'description' => 'passenger list', - 'type' => 'array', - 'items' => [ - 'description' => 'passenger', - 'type' => 'object', - 'properties' => [ - 'last_name' => [ - 'title' => '姓', - 'description' => 'last name', - 'type' => 'string', - 'required' => true, - 'example' => 'ZHANG', - ], - 'first_name' => [ - 'title' => '名', - 'description' => 'first name', - 'type' => 'string', - 'required' => true, - 'example' => 'SAN', - ], - 'birthday' => [ - 'title' => '生日 yyyyMMdd', - 'description' => 'date of birth (yyyyMMdd)'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => '20200320', - ], - 'type' => [ - 'title' => '乘客类型 0:通成人; 1:儿童; 8:婴儿', - 'description' => 'passenger type 0: adult; 1: child; 8: infant', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '0', - ], - 'mobile_phone_number' => [ - 'title' => '手机号', - 'description' => 'mobile phone number', - 'type' => 'string', - 'required' => true, - 'example' => '183******95', - ], - 'mobile_country_code' => [ - 'title' => '手机号-国家码', - 'description' => 'mobile country code', - 'type' => 'string', - 'required' => true, - 'example' => '86', - ], - 'gender' => [ - 'title' => '性别 0:MALE; 1:FEMALE', - 'description' => 'gender 0: MALE; 1: FEMALE', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '0', - ], - 'nationality' => [ - 'title' => '国籍二字码', - 'description' => 'nationality (two-letter code)', - 'type' => 'string', - 'required' => false, - 'example' => 'CN', - ], - 'credential' => [ - 'title' => '证件', - 'description' => 'travel document', - 'type' => 'object', - 'properties' => [ - 'cert_issue_place' => [ - 'title' => '签发地，二字码', - 'description' => 'place of issue, two-letter code', - 'type' => 'string', - 'required' => false, - 'example' => 'CN', - ], - 'credential_num' => [ - 'title' => '证件号', - 'description' => 'travel document number', - 'type' => 'string', - 'required' => false, - 'example' => 'E1***5674', - ], - 'expire_date' => [ - 'title' => '证件过期时间', - 'description' => 'expiration date', - 'type' => 'string', - 'required' => false, - 'example' => '20290101', - ], - 'credential_type' => [ - 'title' => '目前支持的证件类型 0:身份证; 1:护照; 4:回乡证;5:台胞证;6:港澳通行证;12:Taiwan通行证; 19:无证件', - 'description' => 'travel document type , only support "1"(1 means passport) currently.', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '1', - ], - ], - 'required' => false, - ], - ], - 'required' => false, - ], - 'required' => true, - ], - ], - [ - 'name' => 'passenger_ancillary_purchase_map_list', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'title' => '乘机人-辅营购买关系', - 'description' => 'passenger-ancillary purchase relationship', - 'type' => 'array', - 'items' => [ - 'description' => 'element', - 'type' => 'object', - 'properties' => [ - 'passenger_list' => [ - 'title' => '购买统一辅营的乘机人列表', - 'description' => 'passenger list for unified ancillary purchases', - 'type' => 'array', - 'items' => [ - 'description' => 'passenger', - 'type' => 'object', - 'properties' => [ - 'last_name' => [ - 'title' => '姓', - 'description' => 'last name', - 'type' => 'string', - 'required' => true, - 'example' => 'ZHANG', - ], - 'first_name' => [ - 'title' => '名', - 'description' => 'first name'."\n" - ."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'SAN', - ], - 'birthday' => [ - 'title' => '生日 yyyyMMdd', - 'description' => 'date of birth (yyyyMMdd)', - 'type' => 'string', - 'required' => false, - 'example' => '20020320', - ], - 'type' => [ - 'title' => '乘客类型 0:通成人; 1:儿童; 8:婴儿', - 'description' => 'passenger type 0: adult; 1: child; 8: Infant', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '0', - ], - 'mobile_phone_number' => [ - 'title' => '手机号', - 'description' => 'mobile phone number', - 'type' => 'string', - 'required' => true, - 'example' => '182******92', - ], - 'mobile_country_code' => [ - 'title' => '手机号-国家码', - 'description' => 'country code for mobile phone number', - 'type' => 'string', - 'required' => true, - 'example' => '86', - ], - 'gender' => [ - 'title' => '性别 0:MALE; 1:FEMALE', - 'description' => 'gender 0: male; 1: female', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - 'nationality' => [ - 'title' => '国籍二字码', - 'description' => 'nationality', - 'type' => 'string', - 'required' => false, - 'example' => 'CN', - ], - 'credential' => [ - 'title' => '证件', - 'description' => 'travel document', - 'type' => 'object', - 'properties' => [ - 'cert_issue_place' => [ - 'title' => '签发地，二字码', - 'description' => 'place of issue, two-letter code', - 'type' => 'string', - 'required' => false, - 'example' => 'CN', - ], - 'credential_num' => [ - 'title' => '证件号', - 'description' => 'travel document number', - 'type' => 'string', - 'required' => false, - 'example' => 'E1***5673', - ], - 'expire_date' => [ - 'title' => '证件过期时间', - 'description' => 'expiration date', - 'type' => 'string', - 'required' => false, - 'example' => '20290102', - ], - 'credential_type' => [ - 'title' => '目前支持的证件类型 0:身份证; 1:护照; 4:回乡证;5:台胞证;6:港澳通行证;12:Taiwan通行证; 19:无证件', - 'description' => 'travel document type , only support "1"(1 means passport) currently', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '1', - ], - ], - 'required' => false, - ], - ], - 'required' => false, - ], - 'required' => false, - ], - 'book_ancillary_req_item' => [ - 'title' => '辅营对象', - 'description' => 'ancillary information', - 'type' => 'object', - 'properties' => [ - 'ancillary_id' => [ - 'title' => '辅营商品ID', - 'description' => 'ancillary product ID, returned by AncillarySuggest.', - 'type' => 'string', - 'required' => false, - 'example' => 'MDY2NTAxLCJleHAiOjE2NxNzM3MDEsIm5ix', - ], - 'ancillary_type' => [ - 'title' => '辅营产品类型 当前支持 4:付费行李', - 'description' => 'type of ancillary product, only support "4"(4 means paid baggage) currently.', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '4', - ], - ], - 'required' => false, - ], - ], - 'required' => false, - ], - 'required' => false, - ], + 'name' => 'order_num', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '4966***617111'], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'language code(refer to ISO_639), defaults to the buyer\'s account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'The language setting. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<BookRes, BookRes>', - 'description' => 'PopBaseRes<BookRes, Object>', + 'title' => '', + 'description' => 'PopBaseRes<List<FlightChangeOrderDTO>, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http reqeust has been processed successfully，status code is 200'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'error message'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'true represents success, false represents failure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'request ID'."\n" - ."\n", - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', 'description' => ''], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'data'."\n" - ."\n", - 'type' => 'object', - 'properties' => [ - 'order_list' => [ - 'title' => '订单信息列表', - 'description' => 'order information list', - 'type' => 'array', - 'items' => [ - 'description' => 'list of order numbers', - 'type' => 'object', - 'properties' => [ - 'order_num' => [ - 'title' => '订单号', - 'description' => 'order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4966***617111', - ], - 'order_attribute' => [ - 'title' => '订单属性', - 'type' => 'object', - 'properties' => [ - 'aba_pay_lock_rate_info' => [ - 'title' => 'ABA锁汇信息，只有支付方式是ABA支付且报价币种和扣款币种不同时，才会有值', - 'type' => 'object', - 'properties' => [ - 'pay_intended_currency_code' => [ - 'title' => '代扣币种即支付币种即意向币种，用户实际支付的币种', - 'type' => 'string', - 'example' => 'CNY', - ], - 'quotation_currency_code' => [ - 'title' => '报价币种', - 'type' => 'string', - 'example' => 'USD', - ], - 'to_pay_currency_rate' => [ - 'title' => '锁汇汇率即报价价格换算成实际支付价格的汇率', - 'type' => 'string', - 'example' => '7.1427', - ], - 'pay_intended_amount' => [ - 'title' => '支付意向金额即报价价格换算成扣款后的价格', - 'type' => 'string', - 'example' => '14.2854', - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'error data'."\n" - ."\n", - 'type' => 'object', - 'properties' => [ - 'order_list' => [ - 'title' => '订单信息列表', - 'description' => 'order information list. When the same input parameters are used to repeat a Book, if the booking has already been successful, the order number will be returned.', - 'type' => 'array', - 'items' => [ - 'description' => 'list of order numbers', + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'array', + 'items' => [ + 'description' => 'The data elements.', + 'type' => 'object', + 'properties' => [ + 'flight_change_detail' => [ + 'title' => '', + 'description' => 'The flight change information.', 'type' => 'object', 'properties' => [ - 'order_num' => [ - 'title' => '订单号', - 'description' => 'order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4966***617111', - ], - 'order_attribute' => [ - 'title' => '订单属性', - 'type' => 'object', - 'properties' => [ - 'aba_pay_lock_rate_info' => [ - 'title' => 'ABA锁汇信息，只有支付方式是ABA支付且报价币种和扣款币种不同时，才会有值', - 'type' => 'object', - 'properties' => [ - 'pay_intended_currency_code' => [ - 'title' => '代扣币种即支付币种即意向币种，用户实际支付的币种', - 'type' => 'string', - 'example' => 'CNY', - ], - 'quotation_currency_code' => [ - 'title' => '报价币种', - 'type' => 'string', - 'example' => 'USD', - ], - 'to_pay_currency_rate' => [ - 'title' => '锁汇汇率即报价价格换算成实际支付价格的汇率', - 'type' => 'string', - 'example' => '7.1427', - ], - 'pay_intended_amount' => [ - 'title' => '支付意向金额即报价价格换算成扣款后的价格', - 'type' => 'string', - 'example' => '14.2854', - ], - ], - ], - ], - ], + 'old_flight_no' => ['title' => '', 'description' => 'The original flight number.', 'type' => 'string', 'example' => 'HO1295'], + 'old_departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the original departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'old_arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the original arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'old_departure_time' => ['title' => '', 'description' => 'The departure date and time of the original flight in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-02-01 12:01:00'], + 'old_arrival_time' => ['title' => '', 'description' => 'The arrival date and time of the original flight in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '023-02-01 14:01:00'], + 'new_flight_no' => ['title' => '', 'description' => 'The new flight number.', 'type' => 'string', 'example' => 'HO1295'], + 'new_departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the new departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'new_arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the new arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'new_departure_time' => ['title' => '', 'description' => 'The departure date and time of the new flight in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-02-01 13:01:00'], + 'new_arrival_time' => ['title' => '', 'description' => 'The arrival date and time of the new flight in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-02-01 15:01:00'], + 'change_time' => ['title' => '', 'description' => 'The time of the flight change in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-02-01 10:01:00'], + 'change_type' => ['title' => '', 'description' => 'The type of the flight change. Valid values:'."\n" + .'- 1: cancellation'."\n" + .'- 2: schedule change.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'change_reason' => ['title' => '', 'description' => 'The reason for the flight change.', 'type' => 'string', 'example' => '天气'], ], + 'example' => '', ], + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617111'], ], + 'title' => '', + 'example' => '', ], - 'example' => 'null', + 'example' => '', ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_list\\": [\\n {\\n \\"order_num\\": 0,\\n \\"order_attribute\\": {\\n \\"aba_pay_lock_rate_info\\": {\\n \\"pay_intended_currency_code\\": \\"CNY\\",\\n \\"quotation_currency_code\\": \\"USD\\",\\n \\"to_pay_currency_rate\\": \\"7.1427\\",\\n \\"pay_intended_amount\\": \\"14.2854\\"\\n }\\n }\\n }\\n ]\\n },\\n \\"error_data\\": {\\n \\"order_list\\": [\\n {\\n \\"order_num\\": 0,\\n \\"order_attribute\\": {\\n \\"aba_pay_lock_rate_info\\": {\\n \\"pay_intended_currency_code\\": \\"CNY\\",\\n \\"quotation_currency_code\\": \\"USD\\",\\n \\"to_pay_currency_rate\\": \\"7.1427\\",\\n \\"pay_intended_amount\\": \\"14.2854\\"\\n }\\n }\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => 'Book', - 'description' => 'Enter solution_id returned by enrich, ancillary_id returned by ancillarySuggest(optional), passengers information and contact information, the book interface will create an order wait for pay.'."\n" - ."\n" - .'There are two issues should be noticed:'."\n" - ."\n" - .'1. the solution_id must be processed by pricing.'."\n" - .'2. the order created by book interface should be pay within 30 minutes, otherwise the order will be closed.', - 'translator' => 'machine', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": [\\n {\\n \\"flight_change_detail\\": {\\n \\"old_flight_no\\": \\"HO1295\\",\\n \\"old_departure_airport\\": \\"PVG\\",\\n \\"old_arrival_airport\\": \\"MFM\\",\\n \\"old_departure_time\\": \\"2023-02-01 12:01:00\\",\\n \\"old_arrival_time\\": \\"023-02-01 14:01:00\\",\\n \\"new_flight_no\\": \\"HO1295\\",\\n \\"new_departure_airport\\": \\"PVG\\",\\n \\"new_arrival_airport\\": \\"MFM\\",\\n \\"new_departure_time\\": \\"2023-02-01 13:01:00\\",\\n \\"new_arrival_time\\": \\"2023-02-01 15:01:00\\",\\n \\"change_time\\": \\"2023-02-01 10:01:00\\",\\n \\"change_type\\": 1,\\n \\"change_reason\\": \\"天气\\"\\n },\\n \\"order_num\\": 0\\n }\\n ],\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'FlightChangeOfOrder', + 'changeSet' => [], ], - 'TicketingCheck' => [ - 'summary' => 'Transaction - Pre-payment verification', - 'path' => '/airticket/v1/trade/action-ticketing-check', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'GetToken' => [ + 'summary' => 'Obtains a token for API calls. The token is valid for 2 hours.', + 'path' => '/airticket/v1/token', + 'methods' => ['get'], + 'schemes' => ['https', 'http'], 'security' => [ [ - 'accessTokenAuth' => [], + 'rootTokenAuth' => [], ], ], 'deprecated' => false, + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'order_num', - 'in' => 'formData', - 'schema' => [ - 'title' => '订单号', - 'description' => 'order number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '496***2617111', - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'name' => 'app_key', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The appKey.', 'type' => 'string', 'required' => true, 'example' => 'fu1bltcu3400iurywuri'], ], [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'language Code(refer to ISO_639), defaults to the buyer\'s account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'name' => 'app_secret', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The appSecret.', 'type' => 'string', 'required' => true, 'example' => 'ZzQ3MW1mb3E1ODAwI2ldUjYlWUdJn5YI'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ - 'title' => 'PopBaseRes<TicketingCheckRes, Object>', - 'description' => 'PopBaseRes<TicketingCheckRes, Object>', + 'title' => '', + 'description' => 'PopBaseRes<TokenInfoDTO, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http reqeust has been processed successfully，status code is 200'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'error message'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'true represents success, false represents failure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'request ID'."\n" - ."\n", - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'data'."\n" - ."\n", + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ - 'order_num' => [ - 'title' => '订单号', - 'description' => 'order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '496***2617111', - ], + 'token' => ['title' => '', 'description' => 'token', 'type' => 'string', 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiIyUlRjY0Ezc1puSndpYU11R1ctTkVRIiwiaWF0IjoxNjc3MTU1Njg3LCJleHAiOjE2NzcxNjI4ODcsIm5iZiI6MTY3NzE1NTYyN30.bd8qBedJ7R24NC8VpMtM4Ni5OR-Cc0utPiKSx8fjoj9taalt7zXBF8uIVTETw1N-Fx9reLflwVXrbDHky7ZKqlE5o_B5Bkx-crQKlJL-NzasEmNnuJNb5kmmbCy3mvIrQfo5Q5Y0ZaQ110pXK4qd1shRbklvuQXn8lPueJtNqo8VdIOAPGG_rPwOw2P767I0fyFHcome8FR4ST1UrwxeApNKMB_BkpCsUZLgpm9h9trhKbB-3qtk6UK1GKmfw6qlWpL3PQN7FAObNruS0r0CGh3Muc9PaGsuu8Xu5on21h9WmI7L0-jatZkS55p4PEerU56XpkwJfa35_hltKNTauu'], + 'expire_time' => ['title' => '', 'description' => 'The remaining validity period of the token. Unit: seconds.', 'type' => 'integer', 'format' => 'int64', 'example' => '7200'], + 'generate_time' => ['title' => '', 'description' => 'The UNIX timestamp when the token was generated. Unit: seconds.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677055176'], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'error data'."\n" - ."\n", - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with an error response.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_num\\": 0\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'TicketingCheck', - 'description' => 'Pre-check for Ticketing, this interface is optional to use.', - 'translator' => 'machine', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"token\\": \\"eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiIyUlRjY0Ezc1puSndpYU11R1ctTkVRIiwiaWF0IjoxNjc3MTU1Njg3LCJleHAiOjE2NzcxNjI4ODcsIm5iZiI6MTY3NzE1NTYyN30.bd8qBedJ7R24NC8VpMtM4Ni5OR-Cc0utPiKSx8fjoj9taalt7zXBF8uIVTETw1N-Fx9reLflwVXrbDHky7ZKqlE5o_B5Bkx-crQKlJL-NzasEmNnuJNb5kmmbCy3mvIrQfo5Q5Y0ZaQ110pXK4qd1shRbklvuQXn8lPueJtNqo8VdIOAPGG_rPwOw2P767I0fyFHcome8FR4ST1UrwxeApNKMB_BkpCsUZLgpm9h9trhKbB-3qtk6UK1GKmfw6qlWpL3PQN7FAObNruS0r0CGh3Muc9PaGsuu8Xu5on21h9WmI7L0-jatZkS55p4PEerU56XpkwJfa35_hltKNTauu\\",\\n \\"expire_time\\": 7200,\\n \\"generate_time\\": 1677055176\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'GetToken', + 'changeSet' => [], ], - 'Ticketing' => [ - 'summary' => 'Transaction - Payment and Ticket Issuance', - 'path' => '/airticket/v1/trade/action-ticketing', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'LuggageDirect' => [ + 'summary' => 'Queries luggage through-check information for an itinerary.', + 'path' => '/airticket/v1/flight-data/luggage-direct', + 'methods' => ['get'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'accessTokenAuth' => [], @@ -3898,2093 +2388,799 @@ 'deprecated' => false, 'parameters' => [ [ - 'name' => 'order_num', - 'in' => 'formData', - 'schema' => [ - 'title' => '订单号', - 'description' => 'order number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '496***2617111', - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'language code(refer to ISO_639), defaults to the buyer\'s account configuration'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ + 'name' => 'flight_segment_param_list', + 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'title' => 'PopBaseRes<TicketingRes, Object>', - 'description' => 'PopBaseRes<TicketingRes, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http reqeust has been processed successfully，status code is 200'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'error message'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'true represents success, false represents failure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'request ID'."\n" - ."\n", - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'data', - 'type' => 'object', - 'properties' => [ - 'order_num' => [ - 'title' => '订单号', - 'description' => 'order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '496***2617111'."\n", - ], - 'transaction_no' => [ - 'title' => '交易流水号', - 'description' => 'transaction serial number', - 'type' => 'string', - 'example' => 'hkduendkd-2023-dj0', - ], - 'pay_time' => [ - 'title' => '支付时间，13位时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1757404878000', - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'error data'."\n" - ."\n", - 'type' => 'any', - 'example' => 'null', + 'title' => '', + 'description' => 'The list of flight segments that constitute an itinerary. Maximum size: 2.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport.', 'type' => 'string', 'required' => true, 'example' => 'HGH'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport.', 'type' => 'string', 'required' => true, 'example' => 'SIN'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T1', 'required' => false], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1', 'required' => false], + 'departure_time' => ['title' => '', 'description' => 'The departure time. A 13-digit UNIX timestamp.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1705285430445'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival time. A 13-digit UNIX timestamp.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1705285430445'], + 'stop_city_list' => ['title' => '', 'description' => 'The three-letter IATA codes of stopover cities.', 'type' => 'string', 'example' => 'SEL,HKG', 'required' => false], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline.', 'type' => 'string', 'required' => true, 'example' => 'CZ'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline.', 'type' => 'string', 'example' => 'CZ', 'required' => false], + 'ticketing_airline' => ['title' => '', 'description' => 'The ticketing airline.', 'type' => 'string', 'example' => 'CZ', 'required' => false], + 'marketing_flight_no' => ['title' => '', 'description' => 'The flight number.', 'type' => 'string', 'required' => true, 'example' => 'CZ616'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'required' => true, 'example' => 'true', 'default' => 'false'], ], + 'required' => false, + 'description' => '', + 'title' => '', + 'example' => '', ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_num\\": 0,\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\"\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'Ticketing', - 'requestParamsDescription' => 'order pay', - 'translator' => 'machine', - ], - 'Cancel' => [ - 'summary' => 'Transaction - Unpaid Cancellation', - 'path' => '/airticket/v1/trade/action-cancel', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ - [ - 'name' => 'order_num', - 'in' => 'formData', - 'schema' => [ - 'title' => '订单号', - 'description' => 'order number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '496***2617111', + 'required' => false, + 'example' => '', ], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'The access token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'language code(refer to ISO_639), defaults to buyer account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'The language. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<CancelRes, Object>', - 'description' => 'PopBaseRes<CancelRes, Object>', + 'title' => '', + 'description' => 'PopBaseRes<List<LuggageDirect>, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http reqeust has been processed successfully，status code is 200'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'error message'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'true represents success, false represents failure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'request ID'."\n" - ."\n", - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'data', - 'type' => 'object', - 'properties' => [ - 'order_num' => [ - 'title' => '订单号', - 'description' => 'order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '496***2617111'."\n", + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'city_code' => ['title' => '', 'description' => 'The three-letter IATA code of the city.', 'type' => 'string', 'example' => 'BJS'], + 'direct_type' => ['title' => '', 'description' => 'The luggage through-check rule type. Valid values:'."\n" + .'- 0: luggage through-check is not supported.'."\n" + .'- 1: luggage through-check is supported.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'error data'."\n" - ."\n", - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error response.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_num\\": 0\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'Cancel', - 'description' => 'close an unpaid order', - 'translator' => 'machine', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": [\\n {\\n \\"city_code\\": \\"BJS\\",\\n \\"direct_type\\": 1\\n }\\n ],\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'LuggageDirect', + 'description' => 'Queries luggage through-check information for an itinerary. Provide itinerary information as input, and the API returns whether luggage through-check is supported for the itinerary. Luggage through-check applies to transfer and stopover scenarios.', + 'changeSet' => [], ], 'OrderDetail' => [ - 'summary' => 'Trade-Order Details', + 'summary' => 'Queries order details.', 'path' => '/airticket/v1/trade/order-detail', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'methods' => ['get'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'accessTokenAuth' => [], ], ], 'deprecated' => false, + 'systemTags' => [], 'parameters' => [ [ 'name' => 'order_num', 'in' => 'query', - 'schema' => [ - 'title' => '订单号', - 'description' => 'order number created by book', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '4966***617111', - ], + 'schema' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617111', 'required' => false], ], [ 'name' => 'out_order_num', 'in' => 'query', - 'schema' => [ - 'title' => '外部订单号', - 'description' => 'external order number(customized by buyer when book)', - 'type' => 'string', - 'required' => false, - 'example' => 'x091-2023-0220-j-0001', - ], + 'schema' => ['title' => '', 'description' => 'The external order number.', 'type' => 'string', 'example' => 'x091-2023-0220-j-0001', 'required' => false], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'The access token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'language code(refer to ISO_639), defaults to the buyer\'s account configuration'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'The language. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<OrderDetailRes, Object>', + 'title' => '', 'description' => 'PopBaseRes<OrderDetailRes, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http request has been processed successfully，status code is 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'error message'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'true represents success, false represents failure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'request ID'."\n" - ."\n", - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request was successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'data', + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ 'refund_change_rule_map' => [ - 'title' => '乘客类型-退改规则', - 'description' => 'change and refund policy mapping, key is passenger type, value is change and refund policy details', + 'title' => '', + 'description' => 'The mapping of passenger types to refund and change rules.', 'type' => 'object', 'additionalProperties' => [ 'type' => 'object', 'properties' => [ 'refund_rule_all_unused_list' => [ - 'title' => '全程未使用退票规则', - 'description' => 'refund rule for fully-unused tickets', + 'title' => '', + 'description' => '全程未使用退票规则', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'type: 0 - fully-unused ticket; 1 - partially used ticket', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable refund rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable refund rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'whether refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'refund fee X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'whether tax is fully refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'tax amount refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否退票', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 退票手续费', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'can_return_all_tax' => ['title' => '', 'description' => '起飞前X-Y小时(天) 是否全额退税', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可部分退税金额', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'refund_rule_part_unused_list' => [ - 'title' => '部分未使用退票规则', - 'description' => 'refund rule for partially-used tickets'."\n" - ."\n", + 'title' => '', + 'description' => '部分未使用退票规则', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'type: 0 - fully-unused ticket; 1 - partially used ticket', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable refund rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable refund rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'whether refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'refund fee X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'whether tax is fully refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'tax amount refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否退票', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 退票手续费', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'can_return_all_tax' => ['title' => '', 'description' => '起飞前X-Y小时(天) 是否全额退税', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可部分退税金额', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'change_rule_in_unused_list' => [ - 'title' => '回程未使用改签规则', - 'description' => 'change rule for inbound segment unused tickets', + 'title' => '', + 'description' => '回程未使用改签规则', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'type: 2 - outbound segment unused; 3 - inbound segment unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable change rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable change rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'whether changeable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'change fee X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否可以改签', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 改签费', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'change_rule_out_unused_list' => [ - 'title' => '去程未使用改签规则', - 'description' => 'change rule for outbound-flight-unused tickets'."\n" - ."\n", + 'title' => '', + 'description' => '去程未使用改签规则', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'type: 2 - outbound segment unused; 3 - inbound segment unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable change rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable change rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'whether changeable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'change fee X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否可以改签', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 改签费', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'baggage_allowance_map' => [ - 'title' => '乘客类型-行李规则', - 'description' => 'baggage rule mapping, key is passenger type, value is baggage allowance details', + 'title' => '', + 'description' => 'The mapping of passenger types to baggage rules.', 'type' => 'object', 'additionalProperties' => [ 'type' => 'object', 'properties' => [ - 'baggage_amount' => [ - 'title' => '托运行李件数', - 'description' => 'checked baggage quantity', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'baggage_weight' => [ - 'title' => '托运行李重量', - 'description' => 'checked baggage weight'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'baggage_weight_unit' => [ - 'title' => '托运行李重量单位 KG', - 'description' => 'checked baggage weight unit'."\n" - ."\n", - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_weight' => [ - 'title' => '是否所有托运行李重量', - 'description' => 'Whether the weight is for all baggages', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_on_amount' => [ - 'title' => '手提行李件数', - 'description' => 'carry-on baggage quantity', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'carry_on_weight' => [ - 'title' => '手提行李重量', - 'description' => 'carry-on baggage weight'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'carry_on_weight_unit' => [ - 'title' => '手提行李重量单位 KG', - 'description' => 'carry-on baggage weight unit'."\n" - ."\n", - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_carry_on_weight' => [ - 'title' => '是否所有手提行李重量', - 'description' => 'Whether the weight is for all baggages', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_length' => [ - 'title' => '手提长（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '55', - ], - 'carry_width' => [ - 'title' => '手提宽（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'carry_height' => [ - 'title' => '手提高（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'carry_sum_of_length_width_height' => [ - 'title' => '手提三边之和（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '115', - ], - 'length' => [ - 'title' => '托运长（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'width' => [ - 'title' => '托运宽（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'height' => [ - 'title' => '托运高（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'sum_of_length_width_height' => [ - 'title' => '托运三边之和（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], + 'baggage_amount' => ['title' => '', 'description' => '托运行李件数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'baggage_weight' => ['title' => '', 'description' => '托运行李重量', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'baggage_weight_unit' => ['title' => '', 'description' => '托运行李重量单位', 'type' => 'string', 'example' => 'KG'], + 'is_all_weight' => ['title' => '', 'description' => '是否所有托运行李重量', 'type' => 'boolean', 'example' => 'true'], + 'carry_on_amount' => ['title' => '', 'description' => '手提行李件数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'carry_on_weight' => ['title' => '', 'description' => '手提行李重量', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'carry_on_weight_unit' => ['title' => '', 'description' => '手提行李重量单位', 'type' => 'string', 'example' => 'KG'], + 'is_all_carry_on_weight' => ['title' => '', 'description' => '是否所有手提行李重量', 'type' => 'boolean', 'example' => 'true'], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'solution' => [ - 'title' => '航班信息', - 'description' => 'the solution buyer booked'."\n" - ."\n", + 'title' => '', + 'description' => 'The flight information.', 'type' => 'object', 'properties' => [ - 'solution_id' => [ - 'title' => 'solution_id', - 'description' => 'solution_id', - 'type' => 'string', - 'example' => 'eJwz8DeySEo0NjQ01TU3TUxxx', - ], - 'adult_price' => [ - 'title' => '成人单价', - 'description' => 'adult fare'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '300', - ], - 'adult_tax' => [ - 'title' => '成人税', - 'description' => 'adult tax'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'child_price' => [ - 'title' => '儿童单价', - 'description' => 'child fare'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'child_tax' => [ - 'title' => '儿童税', - 'description' => 'child tax'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - 'infant_price' => [ - 'title' => '婴儿单价', - 'description' => 'infant fare'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - 'infant_tax' => [ - 'title' => '婴儿税', - 'description' => 'infant tax'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], + 'solution_id' => ['title' => '', 'description' => 'solution_id', 'type' => 'string', 'example' => 'eJwz8DeySEo0NjQ01TU3TUxxx'], + 'adult_price' => ['title' => '', 'description' => 'The unit price for an adult.', 'type' => 'number', 'format' => 'double', 'example' => '300'], + 'adult_tax' => ['title' => '', 'description' => 'The tax for an adult.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'child_price' => ['title' => '', 'description' => 'The unit price for a child.', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'child_tax' => ['title' => '', 'description' => 'The tax for a child.', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'infant_price' => ['title' => '', 'description' => 'The unit price for an infant.', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'infant_tax' => ['title' => '', 'description' => 'The tax for an infant.', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'refund_ticket_coupon_description' => ['title' => '', 'description' => 'The description of the refund ticket coupon.', 'type' => 'string', 'example' => 'description'], + 'product_type_description' => ['title' => '', 'description' => 'The product type description.', 'type' => 'string', 'example' => 'description'], 'journey_list' => [ - 'title' => '行程', - 'description' => 'journey list'."\n" - ."\n", + 'title' => '', + 'description' => 'The journey list.', 'type' => 'array', 'items' => [ - 'description' => 'journey'."\n" - ."\n", + 'description' => 'journey', 'type' => 'object', 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'segment list'."\n" - ."\n", + 'title' => '', + 'description' => 'The segment information.', 'type' => 'array', 'items' => [ 'description' => 'segment', 'type' => 'object', 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'segment ID format: flight no.+departure airport[IATA airport code]+arrival airport[IATA airport code]+departure time(MMdd)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310'."\n", - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'departure airport code (capitalized)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'arrival airport code (capitalized)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'departure city code (capitalized)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'arrival city code (capitalized)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'marketing airline flight no. (eg: KA5809)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'marketing airline flight no. (eg: 5809)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'marketing airline code (eg: KA)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'operating airline flight no. (eg: CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'operating airline code (eg: CX)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'departure time in string format (yyyy-MM-dd HH:mm:ss)'."\n" - ."\n", - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'arrival time in string format (yyyy-MM-dd HH:mm:ss)'."\n" - ."\n", - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'code share or not'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'departure terminal'."\n" - ."\n", - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'arrival terminal'."\n" - ."\n", - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'equipment type'."\n" - ."\n", - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'cabin class'."\n" - ."\n", - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数。取值范围 1,2,3,4,5,6,7,8,9,A；A 表示余座大于9。', - 'description' => 'availability', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'stop city list when stop_quantity > 1 , use “,” for seperation', - 'type' => 'string', - 'example' => 'SEL,HKG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'number of stops', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'flight time, unit: minute'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], + 'segment_id' => ['title' => '', 'description' => 'The segment ID. Format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'."\n"], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (for example, HO1295).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (for example, 1295).', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline code (for example, HO).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (for example, CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline code (for example, CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The cabin.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This parameter has a value when stopQuantity is greater than 0. Multiple cities are separated by commas.', 'type' => 'string', 'example' => 'SEL,HKG'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration. Unit: minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'segment_baggage_mapping_list' => [ - 'title' => '免费行李规则', - 'description' => 'baggage rule list'."\n" - ."\n", + 'title' => '', + 'description' => 'The complimentary baggage rules.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个免费行李规则', - 'description' => 'segment id list. all the listed segment ids share the same baggage rule', + 'title' => '', + 'description' => 'The list of segment IDs. These segments share the same complimentary baggage rule.', 'type' => 'array', - 'items' => [ - 'description' => 'segment_id'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310'."\n", - ], + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'."\n", 'title' => ''], + 'example' => '', ], 'passenger_baggage_allowance_mapping' => [ - 'title' => '乘客类型-免费行李额映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => 'baggage rule mapping, key is passenger type, value is baggage allowance details', + 'title' => '', + 'description' => 'The mapping of passenger types to complimentary baggage allowances.', 'type' => 'object', 'additionalProperties' => [ 'type' => 'object', 'properties' => [ - 'baggage_amount' => [ - 'title' => '托运行李件数', - 'description' => 'checked baggage quantity', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'baggage_weight' => [ - 'title' => '托运行李重量', - 'description' => 'checked baggage weight'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'baggage_weight_unit' => [ - 'title' => '托运行李重量单位 KG', - 'description' => 'checked baggage weight unit'."\n" - ."\n", - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_weight' => [ - 'title' => '是否所有托运行李重量', - 'description' => 'Whether the weight is for all baggages', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_on_amount' => [ - 'title' => '手提行李件数', - 'description' => 'carry-on baggage quantity', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'carry_on_weight' => [ - 'title' => '手提行李重量', - 'description' => 'carry-on baggage weight'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'carry_on_weight_unit' => [ - 'title' => '手提行李重量单位 KG', - 'description' => 'carry-on baggage weight unit'."\n" - ."\n", - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_carry_on_weight' => [ - 'title' => '是否所有手提行李重量', - 'description' => 'Whether the weight is for all baggages', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_length' => [ - 'title' => '手提长（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '55', - ], - 'carry_width' => [ - 'title' => '手提宽（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'carry_height' => [ - 'title' => '手提高（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'carry_sum_of_length_width_height' => [ - 'title' => '手提三边之和（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '115', - ], - 'length' => [ - 'title' => '托运长（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'width' => [ - 'title' => '托运宽（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'height' => [ - 'title' => '托运高（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'sum_of_length_width_height' => [ - 'title' => '托运三边之和（单位：厘米）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], + 'baggage_amount' => ['title' => '', 'description' => '托运行李件数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'baggage_weight' => ['title' => '', 'description' => '托运行李重量', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'baggage_weight_unit' => ['title' => '', 'description' => '托运行李重量单位', 'type' => 'string', 'example' => 'KG'], + 'is_all_weight' => ['title' => '', 'description' => '是否所有托运行李重量', 'type' => 'boolean', 'example' => 'true'], + 'carry_on_amount' => ['title' => '', 'description' => '手提行李件数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'carry_on_weight' => ['title' => '', 'description' => '手提行李重量', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'carry_on_weight_unit' => ['title' => '', 'description' => '手提行李重量单位', 'type' => 'string', 'example' => 'KG'], + 'is_all_carry_on_weight' => ['title' => '', 'description' => '是否所有手提行李重量', 'type' => 'boolean', 'example' => 'true'], ], - 'description' => 'baggage allowance details', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'segment_refund_change_rule_mapping_list' => [ - 'title' => '退改签规则', - 'description' => 'change and refund policy'."\n" - ."\n", + 'title' => '', + 'description' => 'The refund and change rules.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个退改签规则', - 'description' => 'segment id list. all the listed segment ids share the same change and refund policy', + 'title' => '', + 'description' => 'The list of segment IDs. These segments share the same refund and change rule.', 'type' => 'array', - 'items' => [ - 'description' => 'segment_id'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', ], 'refund_change_rule_map' => [ - 'title' => '乘机人类型-退改签规则映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => 'change and refund policy mapping, key is passenger type, value is change and refund policy details', + 'title' => '', + 'description' => 'The mapping of passenger types to refund and change rules.', 'type' => 'object', 'additionalProperties' => [ 'type' => 'object', 'properties' => [ 'refund_rule_all_unused_list' => [ - 'title' => '全程未使用退票规则', - 'description' => 'refund rule for fully-unused tickets', + 'title' => '', + 'description' => '全程未使用退票规则', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'type: 0 - fully-unused ticket; 1 - partially used ticket', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable refund rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable refund rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'whether refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'refund fee X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'whether tax is fully refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'tax amount refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否退票', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 退票手续费', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'can_return_all_tax' => ['title' => '', 'description' => '起飞前X-Y小时(天) 是否全额退税', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可部分退税金额', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'refund_rule_part_unused_list' => [ - 'title' => '部分未使用退票规则', - 'description' => 'refund rule for partially-used tickets'."\n" - ."\n", + 'title' => '', + 'description' => '部分未使用退票规则', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => 'type: 0 - fully-unused ticket; 1 - partially used ticket', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable refund rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable refund rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => 'whether refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => 'refund fee X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => 'whether tax is fully refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => 'tax amount refundable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否退票', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 退票手续费', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'can_return_all_tax' => ['title' => '', 'description' => '起飞前X-Y小时(天) 是否全额退税', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可部分退税金额', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'change_rule_in_unused_list' => [ - 'title' => '回程未使用改签规则', - 'description' => 'change rule for inbound segment unused tickets', + 'title' => '', + 'description' => '回程未使用改签规则', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'type: 2 - outbound segment unused; 3 - inbound segment unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable change rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable change rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'whether changeable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'change fee X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否可以改签', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 改签费', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'change_rule_out_unused_list' => [ - 'title' => '去程未使用改签规则', - 'description' => 'change rule for outbound-flight-unused tickets', + 'title' => '', + 'description' => '去程未使用改签规则', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => 'type: 2 - outbound segment unused; 3 - inbound segment unused', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => 'time unit: day/hour'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => 'applicable change rule start time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => 'applicable change rule end time, time unit (day/hour)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => 'whether changeable X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => 'change fee X-Y hour(day) before departure'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否可以改签', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 改签费', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], - 'description' => 'elements', + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'segment_baggage_check_in_info_list' => [ - 'title' => '行李直挂规则', - 'description' => 'through check-in baggage policy', + 'title' => '', + 'description' => 'The baggage through-check rules.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个行李直挂规则', - 'description' => 'segment id list. all the listed segment ids share the same baggage through check-in policy', + 'title' => '', + 'description' => 'The list of segment IDs. These segments share the same baggage through-check rule.', 'type' => 'array', - 'items' => [ - 'description' => 'segment_id'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310'."\n", - ], - ], - 'luggage_direct_info_type' => [ - 'title' => '行李直挂规则类型 1:航段之间行李直达; 2:航段之间行李重新托运; 3:经停城市行李直达; 4:经停城市行李重新托运', - 'description' => 'through check-in baggage policy type'."\n" - ."\n" - .'1. baggage through check-in between segments'."\n" - .'2. baggage re-check-in needed between segments'."\n" - .'3. baggage through check-in at stop city ( applies for stop flight )'."\n" - .'4. baggage re-checkin needed at stop city ( applies for stop flight )', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], - ], - ], - 'solution_attribute' => [ - 'title' => '报价属性', - 'description' => 'Quotation Attributes', - 'type' => 'object', - 'properties' => [ - 'supply_source_type' => [ - 'title' => '供给来源类型 1:自营;2:代理人;3:旗舰店', - 'description' => 'Supply source type 1: Self-operated; 2: Agent; 3: Flagship store', - 'type' => 'string', - ], - 'issue_time_info' => [ - 'title' => '出票时效相关', - 'description' => 'Issue ticket time related', - 'type' => 'object', - 'properties' => [ - 'issue_time_limit' => [ - 'title' => '预计出票时长，单位：分钟', - 'description' => 'Estimated issue ticket time, unit: minutes', - 'type' => 'integer', - 'format' => 'int32', - ], - 'issue_ticket_type' => [ - 'title' => '出票类型 1:支付后; 2起飞前；-1未知', - 'description' => 'Issue ticket type: 1: after payment; 2: before departure; -1: unknown', - 'type' => 'integer', - 'format' => 'int32', - ], + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'."\n", 'title' => ''], + 'example' => '', ], + 'luggage_direct_info_type' => ['title' => '', 'description' => 'The baggage through-check rule type. Valid values:'."\n" + .'- 1: baggage is checked through between segments.'."\n" + .'- 2: baggage must be rechecked between segments.'."\n" + .'- 3: baggage is checked through at stopover cities.'."\n" + .'- 4: baggage must be rechecked at stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'example' => '', ], 'flight_item_detail_list' => [ - 'title' => '机票商品履约明细', - 'description' => 'flight product fulfillment details', + 'title' => '', + 'description' => 'The flight ticket fulfillment details.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ 'passenger' => [ - 'title' => '乘客信息', - 'description' => 'passenger', + 'title' => '', + 'description' => 'The passenger information.', 'type' => 'object', 'properties' => [ - 'last_name' => [ - 'title' => '姓', - 'description' => 'last name'."\n" - ."\n", - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'first_name' => [ - 'title' => '名', - 'description' => 'first name'."\n" - ."\n", - 'type' => 'string', - 'example' => 'SAN', - ], - 'birthday' => [ - 'title' => '生日 yyyyMMdd', - 'description' => 'date of birth (yyyyMMdd)'."\n" - ."\n\n", - 'type' => 'string', - 'example' => '20020301', - ], - 'type' => [ - 'title' => '乘客类型 0:通成人; 1:儿童; 8:婴儿', - 'description' => 'passenger type 0: adult; 1: child; 8: infant'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'mobile_phone_number' => [ - 'title' => '手机号', - 'description' => 'mobile phone number'."\n" - ."\n", - 'type' => 'string', - 'example' => '183******96', - ], - 'mobile_country_code' => [ - 'title' => '手机号-国家码', - 'description' => 'mobile country code'."\n" - ."\n", - 'type' => 'string', - 'example' => '86', - ], - 'gender' => [ - 'title' => '性别 0:MALE; 1:FEMALE', - 'description' => 'gender 0: MALE; 1: FEMALE'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'nationality' => [ - 'title' => '国籍二字码', - 'description' => 'nationality (two-letter code)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'CN', - ], + 'last_name' => ['title' => '', 'description' => 'The last name.', 'type' => 'string', 'example' => 'ZHANG'], + 'first_name' => ['title' => '', 'description' => 'The first name.', 'type' => 'string', 'example' => 'SAN'], + 'birthday' => ['title' => '', 'description' => 'The date of birth in yyyyMMdd format.', 'type' => 'string', 'example' => '20020301'], + 'type' => ['title' => '', 'description' => 'The passenger type. Valid values:'."\n" + .'- 0: adult.'."\n" + .'- 1: child.'."\n" + .'- 8: infant.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'mobile_phone_number' => ['title' => '', 'description' => 'The mobile phone number.', 'type' => 'string', 'example' => '183******96'], + 'mobile_country_code' => ['title' => '', 'description' => 'The country code of the mobile phone number.', 'type' => 'string', 'example' => '86'], + 'gender' => ['title' => '', 'description' => 'The gender. Valid values:'."\n" + .'- 0: MALE.'."\n" + .'- 1: FEMALE.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'nationality' => ['title' => '', 'description' => 'The two-letter nationality code.', 'type' => 'string', 'example' => 'CN'], 'credential' => [ - 'title' => '证件', - 'description' => 'travel document', + 'title' => '', + 'description' => 'The credential information.', 'type' => 'object', 'properties' => [ - 'cert_issue_place' => [ - 'title' => '签发地，二字码', - 'description' => 'place of issue, two-letter code', - 'type' => 'string', - 'example' => 'CN', - ], - 'credential_num' => [ - 'title' => '证件号', - 'description' => 'travel document number', - 'type' => 'string', - 'example' => 'E1***5674', - ], - 'expire_date' => [ - 'title' => '证件过期时间', - 'description' => 'expiration date', - 'type' => 'string', - 'example' => '20290101', - ], - 'credential_type' => [ - 'title' => '目前支持的证件类型 0:身份证; 1:护照; 4:回乡证;5:台胞证;6:港澳通行证;12:Taiwan通行证; 19:无证件', - 'description' => 'travel document type , only support "1"(1 means passport) currently.', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], + 'cert_issue_place' => ['title' => '', 'description' => 'The place of issuance, represented as a two-letter code.', 'type' => 'string', 'example' => 'CN'], + 'credential_num' => ['title' => '', 'description' => 'The credential number.', 'type' => 'string', 'example' => 'E1***5674'], + 'expire_date' => ['title' => '', 'description' => 'The credential expiration date.', 'type' => 'string', 'example' => '20290101'], + 'credential_type' => ['title' => '', 'description' => 'The credential type. Valid values:'."\n" + .'- 0: ID card.'."\n" + .'- 1: passport.'."\n" + .'- 4: Home Return Permit.'."\n" + .'- 5: Mainland Travel Permit for Taiwan Residents.'."\n" + .'- 6: Exit-Entry Permit for Hong Kong and Macao Residents.'."\n" + .'- 12: Taiwan Travel Permit.'."\n" + .'- 19: no credential.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'example' => '', ], ], + 'example' => '', ], 'flight_price' => [ - 'title' => '乘客价格信息', - 'description' => 'flight price information for current passenger', + 'title' => '', + 'description' => 'The passenger price information.', 'type' => 'object', 'properties' => [ - 'sell_price' => [ - 'title' => '销售价格 单位元', - 'description' => 'selling price', - 'type' => 'number', - 'format' => 'double', - 'example' => '300', - ], - 'tax' => [ - 'title' => '税费', - 'description' => 'tax', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], + 'sell_price' => ['title' => '', 'description' => 'The selling price. Unit: CNY.', 'type' => 'number', 'format' => 'double', 'example' => '300'], + 'tax' => ['title' => '', 'description' => 'The tax.', 'type' => 'number', 'format' => 'double', 'example' => '10'], ], + 'example' => '', ], 'flight_segment_cabin_relation' => [ - 'title' => '航段舱位信息列表', - 'description' => 'RBD information in flight segment dimension', + 'title' => '', + 'description' => 'The list of segment-cabin information.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID', - 'description' => 'segment ID format: flight no.+departure airport[IATA airport code]+arrival airport[IATA airport code]+departure time(yyMMddHHmm)'."\n", - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_quantity' => [ - 'title' => '可售票量', - 'description' => 'availability', - 'type' => 'string', - 'example' => 'A', - ], - 'cabin_class' => [ - 'title' => '舱位等级', - 'description' => 'cabin class', - 'type' => 'string', - 'example' => 'Y', - ], - 'cabin_class_name' => [ - 'title' => '舱位等级描述', - 'description' => 'cabin class description', - 'type' => 'string', - 'example' => 'economy class', - ], + 'segment_id' => ['title' => '', 'description' => 'The segment ID.', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'cabin' => ['title' => '', 'description' => 'The cabin.', 'type' => 'string', 'example' => 'V'], + 'cabin_quantity' => ['title' => '', 'description' => 'The number of available tickets.', 'type' => 'string', 'example' => 'A'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'cabin_class_name' => ['title' => '', 'description' => 'The cabin class description.', 'type' => 'string', 'example' => 'economy class'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'ticket_nos' => [ - 'title' => 'ticketNo 列表', - 'description' => 'ticket number list', + 'title' => '', + 'description' => 'The list of ticket numbers.', 'type' => 'array', - 'items' => [ - 'description' => 'ticket number', - 'type' => 'string', - 'example' => '784-0000000001', - ], - ], - 'ticket_air_line' => [ - 'title' => '出票航司，拼接可能有多个出票航司', - 'description' => 'ticketing airline', - 'type' => 'string', - 'example' => 'HO', + 'items' => ['description' => 'ticketNo', 'type' => 'string', 'example' => '784-0000000001', 'title' => ''], + 'example' => '', ], + 'ticket_air_line' => ['title' => '', 'description' => 'The ticketing airline. Multiple ticketing airlines may be concatenated.', 'type' => 'string', 'example' => 'HO'], 'c_pnr_list' => [ - 'title' => 'cPnr 列表 cPnr 小编码; bPnr 大编码；对于廉航只有 cPnr', - 'description' => 'c PNR(airline booking code) list', + 'title' => '', + 'description' => 'The list of cPnr values.', 'type' => 'array', - 'items' => [ - 'description' => 'c PNR', - 'type' => 'string', - 'example' => 'HY6P0A', - ], + 'items' => ['description' => 'The element.', 'type' => 'string', 'example' => 'HY6P0A', 'title' => ''], + 'example' => '', ], 'b_pnr_list' => [ - 'title' => 'bPnr 列表', - 'description' => 'b PNR(airline booking code) list', + 'title' => '', + 'description' => 'The list of bPnr values.', 'type' => 'array', - 'items' => [ - 'description' => 'b PNR', - 'type' => 'string', - 'example' => 'HY6P0A', - ], + 'items' => ['description' => 'The element.', 'type' => 'string', 'example' => 'HY6P0A', 'title' => ''], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'ancillary_item_detail_list' => [ - 'title' => '辅营商品履约明细', - 'description' => 'ancillary product fulfillment details', + 'title' => '', + 'description' => 'The ancillary product fulfillment details.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ 'passenger' => [ - 'title' => '乘客信息', - 'description' => 'passenger', + 'title' => '', + 'description' => 'The passenger information.', 'type' => 'object', 'properties' => [ - 'last_name' => [ - 'title' => '姓', - 'description' => 'last name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'first_name' => [ - 'title' => '名', - 'description' => 'first name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'birthday' => [ - 'title' => '生日 yyyyMMdd', - 'description' => 'date of birth (yyyyMMdd)'."\n" - ."\n", - 'type' => 'string', - 'example' => '20020301', - ], - 'type' => [ - 'title' => '乘客类型 0:通成人; 1:儿童; 8:婴儿', - 'description' => 'passenger type 0: adult; 1: child; 8: infant'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'mobile_phone_number' => [ - 'title' => '手机号', - 'description' => 'mobile phone number'."\n" - ."\n", - 'type' => 'string', - 'example' => '183******96', - ], - 'mobile_country_code' => [ - 'title' => '手机号-国家码', - 'description' => 'country code for mobile phone number'."\n" - ."\n", - 'type' => 'string', - 'example' => '86', - ], - 'gender' => [ - 'title' => '性别 0:MALE; 1:FEMALE', - 'description' => 'gender 0: male; 1: female'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'nationality' => [ - 'title' => '国籍二字码', - 'description' => 'nationality', - 'type' => 'string', - 'example' => 'CN', - ], + 'last_name' => ['title' => '', 'description' => 'The last name.', 'type' => 'string', 'example' => 'ZHANG'], + 'first_name' => ['title' => '', 'description' => 'The first name.', 'type' => 'string', 'example' => 'SAN'], + 'birthday' => ['title' => '', 'description' => 'The date of birth in yyyyMMdd format.', 'type' => 'string', 'example' => '20020301'], + 'type' => ['title' => '', 'description' => 'The passenger type. Valid values:'."\n" + .'- 0: adult.'."\n" + .'- 1: child.'."\n" + .'- 8: infant.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'mobile_phone_number' => ['title' => '', 'description' => 'The mobile phone number.', 'type' => 'string', 'example' => '183******96'], + 'mobile_country_code' => ['title' => '', 'description' => 'The country code of the mobile phone number.', 'type' => 'string', 'example' => '86'], + 'gender' => ['title' => '', 'description' => 'The gender. Valid values:'."\n" + .'- 0: MALE.'."\n" + .'- 1: FEMALE.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'nationality' => ['title' => '', 'description' => 'The two-letter nationality code.', 'type' => 'string', 'example' => 'CN'], 'credential' => [ - 'title' => '证件', - 'description' => 'travel document', + 'title' => '', + 'description' => 'The credential information.', 'type' => 'object', 'properties' => [ - 'cert_issue_place' => [ - 'title' => '签发地，二字码', - 'description' => 'place of issue, two-letter code'."\n" - ."\n", - 'type' => 'string', - 'example' => 'CN', - ], - 'credential_num' => [ - 'title' => '证件号', - 'description' => 'travel document number', - 'type' => 'string', - 'example' => 'E1***5674', - ], - 'expire_date' => [ - 'title' => '证件过期时间', - 'description' => 'expiration date', - 'type' => 'string', - 'example' => '20290101', - ], - 'credential_type' => [ - 'title' => '目前支持的证件类型 0:身份证; 1:护照; 4:回乡证;5:台胞证;6:港澳通行证;12:Taiwan通行证; 19:无证件', - 'description' => 'travel document type , only support "1"(1 means passport) currently.', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], + 'cert_issue_place' => ['title' => '', 'description' => 'The place of issuance, represented as a two-letter code.', 'type' => 'string', 'example' => 'CN'], + 'credential_num' => ['title' => '', 'description' => 'The credential number.', 'type' => 'string', 'example' => 'E1***5674'], + 'expire_date' => ['title' => '', 'description' => 'The credential expiration date.', 'type' => 'string', 'example' => '20290101'], + 'credential_type' => ['title' => '', 'description' => 'The credential type. Valid values:'."\n" + .'- 0: ID card.'."\n" + .'- 1: passport.'."\n" + .'- 4: Home Return Permit.'."\n" + .'- 5: Mainland Travel Permit for Taiwan Residents.'."\n" + .'- 6: Exit-Entry Permit for Hong Kong and Macao Residents.'."\n" + .'- 12: Taiwan Travel Permit.'."\n" + .'- 19: no credential.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'example' => '', ], ], + 'example' => '', ], 'segment_id_list' => [ - 'title' => '辅营商品适用的航段ID', - 'description' => 'segment ID list, these segments share the same ancillary', + 'title' => '', + 'description' => 'The segment IDs to which the ancillary product applies.', 'type' => 'array', - 'items' => [ - 'description' => 'segment_id'."\n" - ."\n", - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', ], 'ancillary' => [ - 'title' => '辅营详细信息', - 'description' => 'the ancillary buyer booked'."\n" - ."\n", + 'title' => '', + 'description' => 'The ancillary product details.', 'type' => 'object', 'properties' => [ - 'ancillary_id' => [ - 'title' => '辅营商品ID', - 'description' => 'ancillay_id', - 'type' => 'string', - 'example' => 'MDY2NTAxLCJleHAiOjE2NxNzM3MDEsIm5ix', - ], - 'ancillary_type' => [ - 'title' => '辅营产品类型 当前支持 4:付费行李', - 'description' => 'ancillary product type currently supports 4: paid luggage'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '4', - ], + 'ancillary_id' => ['title' => '', 'description' => 'The ancillary product ID.', 'type' => 'string', 'example' => 'MDY2NTAxLCJleHAiOjE2NxNzM3MDEsIm5ix'], + 'ancillary_type' => ['title' => '', 'description' => 'The ancillary product type. Currently supported value: 4 (paid baggage).', 'type' => 'integer', 'format' => 'int32', 'example' => '4'], 'baggage_ancillary' => [ - 'title' => '行李辅营详情', - 'description' => 'Ancillary Service Details', + 'title' => '', + 'description' => 'The baggage ancillary details.', 'type' => 'object', 'properties' => [ - 'baggage_amount' => [ - 'title' => '行李件数 取值如：3、2、1、0、-2。 -2 表示计重', - 'description' => 'Number of luggage pieces. Values can be: 3, 2, 1, 0, -2. -2 indicates weight-based calculation.', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'baggage_weight' => [ - 'title' => '行李重量，0-50。isAllWeght=true 时，表示所有件数总重量。', - 'description' => 'Luggage weight, 0-50. When isAllWeght=true, it indicates the total weight of all items.', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'baggage_weight_unit' => [ - 'title' => '行李重量单位', - 'description' => 'Unit of luggage weight', - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_weight' => [ - 'title' => '是否所有行李重量', - 'description' => 'whether all luggage weight', - 'type' => 'boolean', - ], - 'price' => [ - 'title' => '总价', - 'description' => 'Total Price', - 'type' => 'number', - 'format' => 'double', - 'example' => '10.0', - ], + 'baggage_amount' => ['title' => '', 'description' => 'The number of baggage pieces. Valid values: 3, 2, 1, 0, and -2. A value of -2 indicates weight-based calculation.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'baggage_weight' => ['title' => '', 'description' => 'The baggage weight, ranging from 0 to 50. When isAllWeight is set to true, this value represents the total weight of all pieces.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'baggage_weight_unit' => ['title' => '', 'description' => 'The baggage weight unit.', 'type' => 'string', 'example' => 'KG'], + 'is_all_weight' => ['title' => '', 'description' => 'Indicates whether the weight represents the total weight of all baggage pieces.', 'type' => 'boolean', 'example' => ''], + 'price' => ['title' => '', 'description' => 'The total price.', 'type' => 'number', 'format' => 'double', 'example' => '10.0'], ], + 'example' => '', ], ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'order_num' => [ - 'title' => '订单号', - 'description' => 'order number created by book'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4966***617111', - ], - 'out_order_num' => [ - 'title' => '外部订单号', - 'description' => 'external order number(customized by buyer when book)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'x091-2023-0220-j-0001', - ], - 'transaction_no' => [ - 'title' => '资金交易流水号', - 'description' => 'transaction number', - 'type' => 'string', - 'example' => 'hkduendkd-2023-dj0', - ], - 'order_status' => [ - 'title' => '订单状态 1:预定处理中; 2:预定成功; 3:订单已支付; 4:订单成功; 5:订单关闭', - 'description' => 'order status '."\n" - ."\n" - .'1: order creation in process; '."\n" - ."\n" - .'2: order creation successful; '."\n" - ."\n" - .'3: order paid; '."\n" - ."\n" - .'4: order successful; '."\n" - ."\n" - .'5: order closed', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '4', - ], - 'book_time' => [ - 'title' => '预定时间(生单时间) 使用时间戳 13位', - 'description' => 'book time(timestamp)', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677210784000', - ], - 'succeed_time' => [ - 'title' => '出票时间 使用时间戳 13位', - 'description' => 'order success time(timestamp)', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677210786000', - ], - 'pay_time' => [ - 'title' => '支付时间 使用时间戳 13位', - 'description' => 'pay time(timestamp)', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677210788000', - ], - 'total_price' => [ - 'title' => '订单总价(单位：元)', - 'description' => 'total price of current order', - 'type' => 'number', - 'format' => 'double', - 'example' => '3000', - ], - 'real_pay_price' => [ - 'title' => '实付金额(单位：元)', - 'description' => 'actual payment amount', - 'type' => 'number', - 'format' => 'double', - 'example' => '3000', - ], - 'promotion_price' => [ - 'title' => '优惠金额(单位：元)', - 'description' => 'discount amount', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617111'], + 'out_order_num' => ['title' => '', 'description' => 'The external order number.', 'type' => 'string', 'example' => 'x091-2023-0220-j-0001'], + 'transaction_no' => ['title' => '', 'description' => 'The transaction number.', 'type' => 'string', 'example' => 'hkduendkd-2023-dj0'], + 'order_status' => ['title' => '', 'description' => 'The order status. Valid values:'."\n" + .'- 1: Booking in progress.'."\n" + .'- 2: Booking succeeded.'."\n" + .'- 3: Order paid.'."\n" + .'- 4: Order succeeded.'."\n" + .'- 5: Order closed.', 'type' => 'integer', 'format' => 'int32', 'example' => '4'], + 'book_time' => ['title' => '', 'description' => 'The booking time (order creation time). The value is a 13-digit timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677210784000'], + 'succeed_time' => ['title' => '', 'description' => 'The ticketing time. The value is a 13-digit timestamp. This parameter has a value only after ticketing is complete.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677210786000'], + 'pay_time' => ['title' => '', 'description' => 'The payment time. The value is a 13-digit timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677210788000'], + 'total_price' => ['title' => '', 'description' => 'The total order price. Unit: CNY.', 'type' => 'number', 'format' => 'double', 'example' => '3000'], + 'real_pay_price' => ['title' => '', 'description' => 'The actual payment amount. Unit: CNY.', 'type' => 'number', 'format' => 'double', 'example' => '3000'], + 'promotion_price' => ['title' => '', 'description' => 'The discount amount. Unit: CNY.', 'type' => 'number', 'format' => 'double', 'example' => '10'], 'passenger_list' => [ - 'title' => '乘机人', - 'description' => 'the information about all passenger of current order', + 'title' => '', + 'description' => 'The passenger list.', 'type' => 'array', 'items' => [ - 'description' => 'elements', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'last_name' => [ - 'title' => '姓', - 'description' => 'last name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'first_name' => [ - 'title' => '名', - 'description' => 'first name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'birthday' => [ - 'title' => '生日 yyyyMMdd', - 'description' => 'date of birth (yyyyMMdd)'."\n" - ."\n", - 'type' => 'string', - 'example' => '20020301', - ], - 'type' => [ - 'title' => '乘客类型 0:通成人; 1:儿童; 8:婴儿', - 'description' => 'passenger type 0: adult; 1: child; 8: infant'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'mobile_phone_number' => [ - 'title' => '手机号', - 'description' => 'mobile phone number'."\n" - ."\n", - 'type' => 'string', - 'example' => '183******96', - ], - 'mobile_country_code' => [ - 'title' => '手机号-国家码', - 'description' => 'mobile country code'."\n" - ."\n", - 'type' => 'string', - 'example' => '86', - ], - 'gender' => [ - 'title' => '性别 0:MALE; 1:FEMALE', - 'description' => 'gender 0: MALE; 1: FEMALE'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'nationality' => [ - 'title' => '国籍二字码', - 'description' => 'nationality (two-letter code)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'CN', - ], + 'last_name' => ['title' => '', 'description' => 'The last name.', 'type' => 'string', 'example' => 'ZHANG'], + 'first_name' => ['title' => '', 'description' => 'The first name.', 'type' => 'string', 'example' => 'SAN'], + 'birthday' => ['title' => '', 'description' => 'The date of birth in yyyyMMdd format.', 'type' => 'string', 'example' => '20020301'], + 'type' => ['title' => '', 'description' => 'The passenger type. Valid values:'."\n" + .'- 0: adult.'."\n" + .'- 1: child.'."\n" + .'- 8: infant.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'mobile_phone_number' => ['title' => '', 'description' => 'The mobile phone number.', 'type' => 'string', 'example' => '183******96'], + 'mobile_country_code' => ['title' => '', 'description' => 'The country code of the mobile phone number.', 'type' => 'string', 'example' => '86'], + 'gender' => ['title' => '', 'description' => 'The gender. Valid values:'."\n" + .'- 0: MALE.'."\n" + .'- 1: FEMALE.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'nationality' => ['title' => '', 'description' => 'The two-letter nationality code.', 'type' => 'string', 'example' => 'CN'], 'credential' => [ - 'title' => '证件', - 'description' => 'travel document', + 'title' => '', + 'description' => 'The credential information.', 'type' => 'object', 'properties' => [ - 'cert_issue_place' => [ - 'title' => '签发地，二字码', - 'description' => 'place of issue, two-letter code', - 'type' => 'string', - 'example' => 'CN', - ], - 'credential_num' => [ - 'title' => '证件号', - 'description' => 'travel document number', - 'type' => 'string', - 'example' => 'E1***5674', - ], - 'expire_date' => [ - 'title' => '证件过期时间', - 'description' => 'expiration date', - 'type' => 'string', - 'example' => '20290101', - ], - 'credential_type' => [ - 'title' => '目前支持的证件类型 0:身份证; 1:护照; 4:回乡证;5:台胞证;6:港澳通行证;12:Taiwan通行证; 19:无证件', - 'description' => 'travel document type , only support "1"(1 means passport) currently.', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], + 'cert_issue_place' => ['title' => '', 'description' => 'The place of issuance, represented as a two-letter code.', 'type' => 'string', 'example' => 'CN'], + 'credential_num' => ['title' => '', 'description' => 'The credential number.', 'type' => 'string', 'example' => 'E1***5674'], + 'expire_date' => ['title' => '', 'description' => 'The credential expiration date.', 'type' => 'string', 'example' => '20290101'], + 'credential_type' => ['title' => '', 'description' => 'The credential type. Valid values:'."\n" + .'- 0: ID card.'."\n" + .'- 1: passport.'."\n" + .'- 4: Home Return Permit.'."\n" + .'- 5: Mainland Travel Permit for Taiwan Residents.'."\n" + .'- 6: Exit-Entry Permit for Hong Kong and Macao Residents.'."\n" + .'- 12: Taiwan Travel Permit.'."\n" + .'- 19: no credential.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'session_nick' => [ - 'title' => '买家昵称', - 'description' => 'buyer nickname'."\n", - 'type' => 'string', - 'example' => 'nick', - ], - 'pay_status' => [ - 'title' => '支付状态 0:初始化; 1:创建成功; 2:支付成功; 4:关闭交易', - 'description' => 'payment status '."\n" - ."\n" - .'1: payment in process; '."\n" - ."\n" - .'2: deduction successful; '."\n" - ."\n" - .'3: paid to the seller; '."\n" - ."\n" - .'4: transaction closed', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], + 'session_nick' => ['title' => '', 'description' => 'The buyer nickname.', 'type' => 'string', 'example' => 'nick'], + 'pay_status' => ['title' => '', 'description' => 'The payment status. Valid values:'."\n" + .'- 0: Initialized.'."\n" + .'- 1: Created.'."\n" + .'- 2: Payment succeeded.'."\n" + .'- 4: Transaction closed.', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'error data'."\n" - ."\n", - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ]\\n }\\n },\\n \\"baggage_allowance_map\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 1,\\n \\"baggage_weight\\": 10,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 5,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true,\\n \\"carry_length\\": 55,\\n \\"carry_width\\": 40,\\n \\"carry_height\\": 20,\\n \\"carry_sum_of_length_width_height\\": 115,\\n \\"length\\": 60,\\n \\"width\\": 40,\\n \\"height\\": 60,\\n \\"sum_of_length_width_height\\": 200\\n }\\n },\\n \\"solution\\": {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TUxxx\\",\\n \\"adult_price\\": 300,\\n \\"adult_tax\\": 30,\\n \\"child_price\\": 200,\\n \\"child_tax\\": 20,\\n \\"infant_price\\": 100,\\n \\"infant_tax\\": 10,\\n \\"journey_list\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\\\n\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"segment_baggage_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"passenger_baggage_allowance_mapping\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 1,\\n \\"baggage_weight\\": 10,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 5,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true,\\n \\"carry_length\\": 55,\\n \\"carry_width\\": 40,\\n \\"carry_height\\": 20,\\n \\"carry_sum_of_length_width_height\\": 115,\\n \\"length\\": 60,\\n \\"width\\": 40,\\n \\"height\\": 60,\\n \\"sum_of_length_width_height\\": 200\\n }\\n }\\n }\\n ],\\n \\"segment_refund_change_rule_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ]\\n }\\n }\\n }\\n ],\\n \\"segment_baggage_check_in_info_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"luggage_direct_info_type\\": 1\\n }\\n ],\\n \\"solution_attribute\\": {\\n \\"supply_source_type\\": \\"\\",\\n \\"issue_time_info\\": {\\n \\"issue_time_limit\\": 0,\\n \\"issue_ticket_type\\": 0\\n }\\n }\\n },\\n \\"flight_item_detail_list\\": [\\n {\\n \\"passenger\\": {\\n \\"last_name\\": \\"ZHANG\\",\\n \\"first_name\\": \\"SAN\\",\\n \\"birthday\\": \\"20020301\\",\\n \\"type\\": 0,\\n \\"mobile_phone_number\\": \\"183******96\\",\\n \\"mobile_country_code\\": \\"86\\",\\n \\"gender\\": 0,\\n \\"nationality\\": \\"CN\\",\\n \\"credential\\": {\\n \\"cert_issue_place\\": \\"CN\\",\\n \\"credential_num\\": \\"E1***5674\\",\\n \\"expire_date\\": \\"20290101\\",\\n \\"credential_type\\": 1\\n }\\n },\\n \\"flight_price\\": {\\n \\"sell_price\\": 300,\\n \\"tax\\": 10\\n },\\n \\"flight_segment_cabin_relation\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_quantity\\": \\"A\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"cabin_class_name\\": \\"economy class\\"\\n }\\n ],\\n \\"ticket_nos\\": [\\n \\"784-0000000001\\"\\n ],\\n \\"ticket_air_line\\": \\"HO\\",\\n \\"c_pnr_list\\": [\\n \\"HY6P0A\\"\\n ],\\n \\"b_pnr_list\\": [\\n \\"HY6P0A\\"\\n ]\\n }\\n ],\\n \\"ancillary_item_detail_list\\": [\\n {\\n \\"passenger\\": {\\n \\"last_name\\": \\"ZHANG\\",\\n \\"first_name\\": \\"SAN\\",\\n \\"birthday\\": \\"20020301\\",\\n \\"type\\": 0,\\n \\"mobile_phone_number\\": \\"183******96\\",\\n \\"mobile_country_code\\": \\"86\\",\\n \\"gender\\": 0,\\n \\"nationality\\": \\"CN\\",\\n \\"credential\\": {\\n \\"cert_issue_place\\": \\"CN\\",\\n \\"credential_num\\": \\"E1***5674\\",\\n \\"expire_date\\": \\"20290101\\",\\n \\"credential_type\\": 1\\n }\\n },\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"ancillary\\": {\\n \\"ancillary_id\\": \\"MDY2NTAxLCJleHAiOjE2NxNzM3MDEsIm5ix\\",\\n \\"ancillary_type\\": 4,\\n \\"baggage_ancillary\\": {\\n \\"baggage_amount\\": 0,\\n \\"baggage_weight\\": 0,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"price\\": 10\\n }\\n }\\n }\\n ],\\n \\"order_num\\": 0,\\n \\"out_order_num\\": \\"x091-2023-0220-j-0001\\",\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"order_status\\": 4,\\n \\"book_time\\": 1677210784000,\\n \\"succeed_time\\": 1677210786000,\\n \\"pay_time\\": 1677210788000,\\n \\"total_price\\": 3000,\\n \\"real_pay_price\\": 3000,\\n \\"promotion_price\\": 10,\\n \\"passenger_list\\": [\\n {\\n \\"last_name\\": \\"ZHANG\\",\\n \\"first_name\\": \\"SAN\\",\\n \\"birthday\\": \\"20020301\\",\\n \\"type\\": 0,\\n \\"mobile_phone_number\\": \\"183******96\\",\\n \\"mobile_country_code\\": \\"86\\",\\n \\"gender\\": 0,\\n \\"nationality\\": \\"CN\\",\\n \\"credential\\": {\\n \\"cert_issue_place\\": \\"CN\\",\\n \\"credential_num\\": \\"E1***5674\\",\\n \\"expire_date\\": \\"20290101\\",\\n \\"credential_type\\": 1\\n }\\n }\\n ],\\n \\"session_nick\\": \\"nick\\",\\n \\"pay_status\\": 2\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'OrderDetail', - 'description' => 'query order detail', - 'translator' => 'machine', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ]\\n }\\n },\\n \\"baggage_allowance_map\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 1,\\n \\"baggage_weight\\": 10,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 5,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true\\n }\\n },\\n \\"solution\\": {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TUxxx\\",\\n \\"adult_price\\": 300,\\n \\"adult_tax\\": 30,\\n \\"child_price\\": 200,\\n \\"child_tax\\": 20,\\n \\"infant_price\\": 100,\\n \\"infant_tax\\": 10,\\n \\"refund_ticket_coupon_description\\": \\"description\\",\\n \\"product_type_description\\": \\"description\\",\\n \\"journey_list\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\\\n\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"segment_baggage_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"passenger_baggage_allowance_mapping\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 1,\\n \\"baggage_weight\\": 10,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 5,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true\\n }\\n }\\n }\\n ],\\n \\"segment_refund_change_rule_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ]\\n }\\n }\\n }\\n ],\\n \\"segment_baggage_check_in_info_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"luggage_direct_info_type\\": 1\\n }\\n ]\\n },\\n \\"flight_item_detail_list\\": [\\n {\\n \\"passenger\\": {\\n \\"last_name\\": \\"ZHANG\\",\\n \\"first_name\\": \\"SAN\\",\\n \\"birthday\\": \\"20020301\\",\\n \\"type\\": 0,\\n \\"mobile_phone_number\\": \\"183******96\\",\\n \\"mobile_country_code\\": \\"86\\",\\n \\"gender\\": 0,\\n \\"nationality\\": \\"CN\\",\\n \\"credential\\": {\\n \\"cert_issue_place\\": \\"CN\\",\\n \\"credential_num\\": \\"E1***5674\\",\\n \\"expire_date\\": \\"20290101\\",\\n \\"credential_type\\": 1\\n }\\n },\\n \\"flight_price\\": {\\n \\"sell_price\\": 300,\\n \\"tax\\": 10\\n },\\n \\"flight_segment_cabin_relation\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_quantity\\": \\"A\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"cabin_class_name\\": \\"economy class\\"\\n }\\n ],\\n \\"ticket_nos\\": [\\n \\"784-0000000001\\"\\n ],\\n \\"ticket_air_line\\": \\"HO\\",\\n \\"c_pnr_list\\": [\\n \\"HY6P0A\\"\\n ],\\n \\"b_pnr_list\\": [\\n \\"HY6P0A\\"\\n ]\\n }\\n ],\\n \\"ancillary_item_detail_list\\": [\\n {\\n \\"passenger\\": {\\n \\"last_name\\": \\"ZHANG\\",\\n \\"first_name\\": \\"SAN\\",\\n \\"birthday\\": \\"20020301\\",\\n \\"type\\": 0,\\n \\"mobile_phone_number\\": \\"183******96\\",\\n \\"mobile_country_code\\": \\"86\\",\\n \\"gender\\": 0,\\n \\"nationality\\": \\"CN\\",\\n \\"credential\\": {\\n \\"cert_issue_place\\": \\"CN\\",\\n \\"credential_num\\": \\"E1***5674\\",\\n \\"expire_date\\": \\"20290101\\",\\n \\"credential_type\\": 1\\n }\\n },\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"ancillary\\": {\\n \\"ancillary_id\\": \\"MDY2NTAxLCJleHAiOjE2NxNzM3MDEsIm5ix\\",\\n \\"ancillary_type\\": 4,\\n \\"baggage_ancillary\\": {\\n \\"baggage_amount\\": 0,\\n \\"baggage_weight\\": 0,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": false,\\n \\"price\\": 10\\n }\\n }\\n }\\n ],\\n \\"order_num\\": 0,\\n \\"out_order_num\\": \\"x091-2023-0220-j-0001\\",\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"order_status\\": 4,\\n \\"book_time\\": 1677210784000,\\n \\"succeed_time\\": 1677210786000,\\n \\"pay_time\\": 1677210788000,\\n \\"total_price\\": 3000,\\n \\"real_pay_price\\": 3000,\\n \\"promotion_price\\": 10,\\n \\"passenger_list\\": [\\n {\\n \\"last_name\\": \\"ZHANG\\",\\n \\"first_name\\": \\"SAN\\",\\n \\"birthday\\": \\"20020301\\",\\n \\"type\\": 0,\\n \\"mobile_phone_number\\": \\"183******96\\",\\n \\"mobile_country_code\\": \\"86\\",\\n \\"gender\\": 0,\\n \\"nationality\\": \\"CN\\",\\n \\"credential\\": {\\n \\"cert_issue_place\\": \\"CN\\",\\n \\"credential_num\\": \\"E1***5674\\",\\n \\"expire_date\\": \\"20290101\\",\\n \\"credential_type\\": 1\\n }\\n }\\n ],\\n \\"session_nick\\": \\"nick\\",\\n \\"pay_status\\": 2\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'Order details', + 'changeSet' => [ + ['createdAt' => '2025-11-18T06:20:04.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-18T06:10:43.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-12T04:01:07.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-12T03:58:52.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-12T03:58:45.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-24T06:03:24.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-24T05:51:47.000Z', 'description' => 'OpenAPI offline'], + ], ], 'OrderList' => [ - 'summary' => 'Trade - Order List', + 'summary' => 'Queries the order list.', 'path' => '/airticket/v1/trade/order-list', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'methods' => ['get'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'accessTokenAuth' => [], @@ -5995,434 +3191,530 @@ [ 'name' => 'book_time_start', 'in' => 'query', - 'schema' => [ - 'title' => '查询开始时间 13位时间戳', - 'description' => 'earliest book time(timestamp)', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1677227005000', - ], + 'schema' => ['title' => '', 'description' => 'The query start time. The value is a 13-digit UNIX timestamp.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1677229005000'], ], [ 'name' => 'book_time_end', 'in' => 'query', - 'schema' => [ - 'title' => '查询结束时间 13位时间戳', - 'description' => 'latest booking time (timestamp)', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1677229005000', - ], + 'schema' => ['title' => '', 'description' => 'The query end time. The value is a 13-digit UNIX timestamp.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1677229006000'], ], [ 'name' => 'status', 'in' => 'query', - 'schema' => [ - 'title' => '订单状态 1:生单预定处理中; 2:生单预定成功; 3:订单已支付; 4:订单成功; 5:订单关闭', - 'description' => 'which order status will be query'."\n" - ."\n" - .'1: order reservation in process'."\n" - ."\n" - .'2: order reservation successful'."\n" - ."\n" - .'3: order paid'."\n" - ."\n" - .'4: order successful'."\n" - ."\n" - .'5: order closed'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '4', - ], + 'schema' => ['title' => '', 'description' => 'The order status. Valid values:'."\n" + .'- 2: order creation succeeded.'."\n" + .'- 3: order paid.'."\n" + .'- 4: order succeeded.'."\n" + .'- 5: order closed.', 'type' => 'integer', 'format' => 'int32', 'example' => '4', 'required' => false], ], [ 'name' => 'page_index', 'in' => 'query', - 'schema' => [ - 'title' => '页索引', - 'description' => 'pagination query parameters, from which page to start querying,querying starts with 0', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '0', - ], + 'schema' => ['title' => '', 'description' => 'The page index. The value starts from 1.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], ], [ 'name' => 'page_size', 'in' => 'query', - 'schema' => [ - 'title' => '页大小', - 'description' => 'pagination query parameters, how many orders to return'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '20', - ], + 'schema' => ['title' => '', 'description' => 'The page size.', 'type' => 'integer', 'format' => 'int32', 'example' => '20', 'required' => false], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'language code(refer to ISO_639), defaults to the buyer\'s account configuration'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'The language. Default value: the language configured for the buyer account.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<PageData<BaseOrderDetailRes>, Object>', + 'title' => '', 'description' => 'PopBaseRes<PageData<BaseOrderDetailRes>, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'http reqeust has been processed successfully，status code is 200'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'error message'."\n" - ."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'true represents success, false represents failure'."\n" - ."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'request ID'."\n" - ."\n", - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'data', + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ 'list' => [ - 'title' => '数据列表', - 'description' => 'order list', + 'title' => '', + 'description' => 'The data list.', 'type' => 'array', 'items' => [ - 'description' => 'order', + 'description' => 'The paginated data.', 'type' => 'object', 'properties' => [ - 'order_num' => [ - 'title' => '订单号', - 'description' => 'order number created by book'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4966***617111', - ], - 'out_order_num' => [ - 'title' => '外部订单号', - 'description' => 'external order number(customized by buyer when book)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'x091-2023-0220-j-0001', - ], - 'transaction_no' => [ - 'title' => '资金交易流水号', - 'description' => 'transaction number'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hkduendkd-2023-dj0', - ], - 'order_status' => [ - 'title' => '订单状态 1:生单预定处理中; 2:生单预定成功; 3:订单已支付; 4:订单成功; 5:订单关闭', - 'description' => 'order status'."\n" - ."\n" - .'1: order reservation in process'."\n" - ."\n" - .'2: order reservation successful'."\n" - ."\n" - .'3: order paid'."\n" - ."\n" - .'4: order successful'."\n" - ."\n" - .'5: order closed', - 'type' => 'string', - 'example' => '4', - ], - 'book_time' => [ - 'title' => '预定时间(生单时间) 使用时间戳 13位', - 'description' => 'book time(timestamp)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677210784000', - ], - 'succeed_time' => [ - 'title' => '出票时间 使用时间戳 13位', - 'description' => 'order success time(timestamp)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677210786000', - ], - 'pay_time' => [ - 'title' => '支付时间 使用时间戳 13位', - 'description' => 'pay time(timestamp)'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677210788000', - ], - 'total_price' => [ - 'title' => '订单总价(单位：元)', - 'description' => 'total price of current order'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '3000', - ], - 'real_pay_price' => [ - 'title' => '实付金额(单位：元)', - 'description' => 'actual payment amount'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '3000', - ], - 'promotion_price' => [ - 'title' => '优惠金额(单位：元)', - 'description' => 'discount amount'."\n" - ."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617111'], + 'out_order_num' => ['title' => '', 'description' => 'The external order number.', 'type' => 'string', 'example' => 'x091-2023-0220-j-0001'], + 'transaction_no' => ['title' => '', 'description' => 'The transaction serial number.', 'type' => 'string', 'example' => 'hkduendkd-2023-dj0'], + 'order_status' => ['title' => '', 'description' => 'The order status. Valid values:'."\n" + .'- 2: order creation succeeded.'."\n" + .'- 3: order paid.'."\n" + .'- 4: order succeeded.'."\n" + .'- 5: order closed.', 'type' => 'string', 'example' => '4'], + 'book_time' => ['title' => '', 'description' => 'The booking time (order creation time). The value is a 13-digit UNIX timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677210784000'], + 'succeed_time' => ['title' => '', 'description' => 'The ticketing time. The value is a 13-digit UNIX timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677210786000'], + 'pay_time' => ['title' => '', 'description' => 'The payment time. The value is a 13-digit UNIX timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677210788000'], + 'total_price' => ['title' => '', 'description' => 'The total price of the order. Unit: yuan.', 'type' => 'number', 'format' => 'double', 'example' => '3000'], + 'real_pay_price' => ['title' => '', 'description' => 'The actual payment amount. Unit: yuan.', 'type' => 'number', 'format' => 'double', 'example' => '3000'], + 'promotion_price' => ['title' => '', 'description' => 'The discount amount. Unit: yuan.', 'type' => 'number', 'format' => 'double', 'example' => '10'], 'passenger_list' => [ - 'title' => '乘机人', - 'description' => 'the information about all passenger of current order'."\n" - ."\n", + 'title' => '', + 'description' => 'The passenger list.', 'type' => 'array', 'items' => [ - 'description' => '', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'last_name' => [ - 'title' => '姓', - 'description' => 'last name'."\n" - ."\n", - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'first_name' => [ - 'title' => '名', - 'description' => 'first name'."\n" - ."\n", - 'type' => 'string', - 'example' => 'SAN', - ], - 'birthday' => [ - 'title' => '生日 yyyyMMdd', - 'description' => 'date of birth (yyyyMMdd)'."\n" - ."\n", - 'type' => 'string', - 'example' => '20020301', - ], - 'type' => [ - 'title' => '乘客类型 0:通成人; 1:儿童; 8:婴儿', - 'description' => 'passenger type 0: adult; 1: child; 8: infant'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'mobile_phone_number' => [ - 'title' => '手机号', - 'description' => 'mobile phone number'."\n" - ."\n", - 'type' => 'string', - 'example' => '183******96', - ], - 'mobile_country_code' => [ - 'title' => '手机号-国家码', - 'description' => 'mobile country code'."\n" - ."\n", - 'type' => 'string', - 'example' => '86', + 'last_name' => ['title' => '', 'description' => 'The last name.', 'type' => 'string', 'example' => 'ZHANG'], + 'first_name' => ['title' => '', 'description' => 'The first name.', 'type' => 'string', 'example' => 'SAN'], + 'birthday' => ['title' => '', 'description' => 'The date of birth in the yyyyMMdd format.', 'type' => 'string', 'example' => '20020301'], + 'type' => ['title' => '', 'description' => 'The passenger type. Valid values:'."\n" + .'- 0: adult.'."\n" + .'- 1: child.'."\n" + .'- 8: infant.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'mobile_phone_number' => ['title' => '', 'description' => 'The mobile phone number.', 'type' => 'string', 'example' => '183******96'], + 'mobile_country_code' => ['title' => '', 'description' => 'The country code of the mobile phone number.', 'type' => 'string', 'example' => '86'], + 'gender' => ['title' => '', 'description' => 'The gender. Valid values:'."\n" + .'- 0: MALE.'."\n" + .'- 1: FEMALE.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'nationality' => ['title' => '', 'description' => 'The two-letter nationality code.', 'type' => 'string', 'example' => 'CN'], + 'credential' => [ + 'title' => '', + 'description' => 'The credential information.', + 'type' => 'object', + 'properties' => [ + 'cert_issue_place' => ['title' => '', 'description' => 'The place of issue, represented as a two-letter code.', 'type' => 'string', 'example' => 'CN'], + 'credential_num' => ['title' => '', 'description' => 'The credential number.', 'type' => 'string', 'example' => 'E1***5674'], + 'expire_date' => ['title' => '', 'description' => 'The credential expiration date.', 'type' => 'string', 'example' => '20290101'], + 'credential_type' => ['title' => '', 'description' => 'The credential type. Valid values:'."\n" + .'- 0: ID card.'."\n" + .'- 1: passport.'."\n" + .'- 2: student ID.'."\n" + .'- 3: military ID.'."\n" + .'- 4: Home Return Permit.'."\n" + .'- 5: Taiwan Compatriot Permit.'."\n" + .'- 6: Hong Kong and Macao Travel Permit.'."\n" + .'- 7: international seafarer certificate.'."\n" + .'- 8: Foreigner Permanent Residence Card.'."\n" + .'- 10: police officer ID.'."\n" + .'- 11: soldier ID.'."\n" + .'- 12: Taiwan Travel Permit.'."\n" + .'- 13: Taiwan Entry Permit.'."\n" + .'- 14: household register.'."\n" + .'- 15: birth certificate.'."\n" + .'- 16: driver license.'."\n" + .'- 17: Hong Kong and Macao Resident Residence Permit.'."\n" + .'- 18: Taiwan Resident Residence Permit.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'example' => '', ], - 'gender' => [ - 'title' => '性别 0:MALE; 1:FEMALE', - 'description' => 'gender 0: MALE; 1: FEMALE'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'session_nick' => ['title' => '', 'description' => 'The buyer nickname.', 'type' => 'string', 'example' => 'nick'], + 'pay_status' => ['title' => '', 'description' => 'The payment status. Valid values:'."\n" + .'- 0: initialized.'."\n" + .'- 1: creation succeeded.'."\n" + .'- 2: payment succeeded.'."\n" + .'- 4: transaction closed.', 'type' => 'string', 'example' => '2'], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'pagination' => [ + 'title' => '', + 'description' => 'The pagination information.', + 'type' => 'object', + 'properties' => [ + 'total_count' => ['title' => '', 'description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'total_page' => ['title' => '', 'description' => 'The total number of pages.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'current_page' => ['title' => '', 'description' => 'The current page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'page_size' => ['title' => '', 'description' => 'The number of records per page.', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + ], + 'example' => '', + ], + ], + 'example' => '', + ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"order_num\\": 0,\\n \\"out_order_num\\": \\"x091-2023-0220-j-0001\\",\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"order_status\\": \\"4\\",\\n \\"book_time\\": 1677210784000,\\n \\"succeed_time\\": 1677210786000,\\n \\"pay_time\\": 1677210788000,\\n \\"total_price\\": 3000,\\n \\"real_pay_price\\": 3000,\\n \\"promotion_price\\": 10,\\n \\"passenger_list\\": [\\n {\\n \\"last_name\\": \\"ZHANG\\",\\n \\"first_name\\": \\"SAN\\",\\n \\"birthday\\": \\"20020301\\",\\n \\"type\\": 0,\\n \\"mobile_phone_number\\": \\"183******96\\",\\n \\"mobile_country_code\\": \\"86\\",\\n \\"gender\\": 0,\\n \\"nationality\\": \\"CN\\",\\n \\"credential\\": {\\n \\"cert_issue_place\\": \\"CN\\",\\n \\"credential_num\\": \\"E1***5674\\",\\n \\"expire_date\\": \\"20290101\\",\\n \\"credential_type\\": 1\\n }\\n }\\n ],\\n \\"session_nick\\": \\"nick\\",\\n \\"pay_status\\": \\"2\\"\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'OrderList', + 'changeSet' => [], + ], + 'Pricing' => [ + 'summary' => 'Verifies seat availability and pricing. If the price has changed, the developer can proceed with Book at the updated price. If the price has not changed, the order is placed at the original price.', + 'path' => '/airticket/v1/trade/action-pricing', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ + [ + 'name' => 'solution_id', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'solution_id.', 'type' => 'string', 'required' => true, 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ'], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'PopBaseRes<PricingRes, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request was successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'solution' => [ + 'title' => '', + 'description' => 'solution', + 'type' => 'object', + 'properties' => [ + 'solution_id' => ['title' => '', 'description' => 'solution_id', 'type' => 'string', 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ'], + 'adult_price' => ['title' => '', 'description' => 'The unit price per adult.', 'type' => 'number', 'format' => 'double', 'example' => '300'], + 'adult_tax' => ['title' => '', 'description' => 'The tax per adult.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'child_price' => ['title' => '', 'description' => 'The unit price per child.', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'child_tax' => ['title' => '', 'description' => 'The tax per child.', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'infant_price' => ['title' => '', 'description' => 'The unit price per infant.', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'infant_tax' => ['title' => '', 'description' => 'The tax per infant.', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'refund_ticket_coupon_description' => ['title' => '', 'description' => 'The description of the refund ticket coupon.', 'type' => 'string', 'example' => 'description'], + 'product_type_description' => ['title' => '', 'description' => 'The product type description.', 'type' => 'string', 'example' => 'description'], + 'journey_list' => [ + 'title' => '', + 'description' => 'The journey list.', + 'type' => 'array', + 'items' => [ + 'description' => 'journey', + 'type' => 'object', + 'properties' => [ + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'segment_list' => [ + 'title' => '', + 'description' => 'The segment information.', + 'type' => 'array', + 'items' => [ + 'description' => 'segment', + 'type' => 'object', + 'properties' => [ + 'segment_id' => ['title' => '', 'description' => 'The segment ID in the format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (for example, KA5809).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (for example, 5809).', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline code (for example, KA).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (for example, CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline code (for example, CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The cabin code.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'ALL_CABIN'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This field has a value when stopQuantity is greater than 0. Multiple cities are separated by commas.', 'type' => 'string', 'example' => '""'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration in minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], + ], + 'title' => '', + 'example' => '', ], - 'nationality' => [ - 'title' => '国籍二字码', - 'description' => 'nationality (two-letter code)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'CN', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'segment_baggage_mapping_list' => [ + 'title' => '', + 'description' => 'The free baggage allowance rules.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'segment_id_list' => [ + 'title' => '', + 'description' => 'The list of segment IDs that share the same free baggage allowance rule.', + 'type' => 'array', + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'."\n", 'title' => ''], + 'example' => '', + ], + 'passenger_baggage_allowance_mapping' => [ + 'title' => '', + 'description' => 'The mapping between passenger types and free baggage allowances.', + 'type' => 'object', + 'additionalProperties' => [ + 'type' => 'object', + 'properties' => [ + 'baggage_amount' => ['title' => '', 'description' => '托运行李件数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'baggage_weight' => ['title' => '', 'description' => '托运行李重量', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'baggage_weight_unit' => ['title' => '', 'description' => '托运行李重量单位KG', 'type' => 'string', 'example' => 'KG'], + 'is_all_weight' => ['title' => '', 'description' => '是否所有托运行李重量', 'type' => 'boolean', 'example' => 'true'], + 'carry_on_amount' => ['title' => '', 'description' => '手提行李件数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'carry_on_weight' => ['title' => '', 'description' => '手提行李重量', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'carry_on_weight_unit' => ['title' => '', 'description' => '手提行李重量单位KG', 'type' => 'string', 'example' => 'KG'], + 'is_all_carry_on_weight' => ['title' => '', 'description' => '是否所有手提行李重量', 'type' => 'boolean', 'example' => 'true'], + ], + 'description' => '元素', + 'title' => '', + 'example' => '', ], - 'credential' => [ - 'title' => '证件', - 'description' => 'credential'."\n" - ."\n", + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'segment_refund_change_rule_mapping_list' => [ + 'title' => '', + 'description' => 'The refund and change rules.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'segment_id_list' => [ + 'title' => '', + 'description' => 'The list of segment IDs that share the same refund and change rule.', + 'type' => 'array', + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', + ], + 'refund_change_rule_map' => [ + 'title' => '', + 'description' => 'The mapping between passenger types and refund and change rules.', + 'type' => 'object', + 'additionalProperties' => [ 'type' => 'object', 'properties' => [ - 'cert_issue_place' => [ - 'title' => '签发地，二字码', - 'description' => 'issuing place (two-letter code)'."\n" - ."\n", - 'type' => 'string', - 'example' => 'CN', + 'refund_rule_all_unused_list' => [ + 'title' => '', + 'description' => '全程未使用退票规则', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'type' => ['title' => '', 'description' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否退票', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 退票手续费', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'can_return_all_tax' => ['title' => '', 'description' => '起飞前X-Y小时(天) 是否全额退税', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可部分退税金额', 'type' => 'number', 'format' => 'double', 'example' => '10'], + ], + 'description' => '元素', + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'credential_num' => [ - 'title' => '证件号', - 'description' => 'credential number'."\n" - ."\n", - 'type' => 'string', - 'example' => 'E1***5674', + 'refund_rule_part_unused_list' => [ + 'title' => '', + 'description' => '部分未使用退票规则', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'type' => ['title' => '', 'description' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否退票', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 退票手续费', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'can_return_all_tax' => ['title' => '', 'description' => '起飞前X-Y小时(天) 是否全额退税', 'type' => 'boolean', 'example' => 'false'], + 'return_part_tax_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可部分退税金额', 'type' => 'number', 'format' => 'double', 'example' => '30'], + ], + 'description' => '元素', + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'expire_date' => [ - 'title' => '证件过期时间', - 'description' => 'credential expiration date'."\n" - ."\n", - 'type' => 'string', - 'example' => '20290101', + 'change_rule_in_unused_list' => [ + 'title' => '', + 'description' => '回程未使用改签规则', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'type' => ['title' => '', 'description' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否可以改签', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 改签费', 'type' => 'number', 'format' => 'double', 'example' => '10'], + ], + 'description' => '元素', + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'credential_type' => [ - 'title' => '证件类型 0:身份证; 1:护照; 2:学生证; 3:军人证; 4:回乡证; 5:台胞证; 6:港澳通行证; 7:国际海员; 8:外国人永久居留证; 10:警官证; 11:士兵证; 12:台湾通行证; 13:入台证; 14:户口簿; 15:出生证明; 16:驾照; 17:港澳居民居住证; 18:台湾居民居住证', - 'description' => 'credential type , only support "1"(1 means passport) currently.'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', + 'change_rule_out_unused_list' => [ + 'title' => '', + 'description' => '去程未使用改签规则', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'type' => ['title' => '', 'description' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '3'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否可以改签', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 改签费', 'type' => 'number', 'format' => 'double', 'example' => '10'], + ], + 'description' => '元素', + 'title' => '', + 'example' => '', + ], + 'example' => '', ], ], + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], - 'session_nick' => [ - 'title' => '买家昵称', - 'description' => 'buyer nickname'."\n" - ."\n", - 'type' => 'string', - 'example' => 'nick', - ], - 'pay_status' => [ - 'title' => '支付状态 0:支付处理中; 1:扣款成功; 2:已打款给卖家; 3:关闭交易', - 'description' => 'payment status'."\n" - ."\n" - .'1: payment in process'."\n" - ."\n" - .'2: deduction successful'."\n" - ."\n" - .'3: paid to the seller'."\n" - ."\n" - .'4: transaction closed', - 'type' => 'string', - 'example' => '2', + 'example' => '', + ], + 'segment_baggage_check_in_info_list' => [ + 'title' => '', + 'description' => 'The baggage through-check rules.', + 'type' => 'array', + 'items' => [ + 'description' => 'The element.', + 'type' => 'object', + 'properties' => [ + 'segment_id_list' => [ + 'title' => '', + 'description' => 'The list of segment IDs that share the same baggage through-check rule.', + 'type' => 'array', + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'."\n", 'title' => ''], + 'example' => '', + ], + 'luggage_direct_info_type' => ['title' => '', 'description' => 'The baggage through-check rule type. Valid values: 1: baggage is checked through between segments. 2: baggage must be rechecked between segments. 3: baggage is checked through at stopover cities. 4: baggage must be rechecked at stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'example' => '', ], - 'pagination' => [ - 'title' => '分页信息', - 'description' => 'information of pagination'."\n" - ."\n", + 'is_changed' => ['title' => '', 'description' => 'Indicates whether the price has changed.', 'type' => 'boolean', 'example' => 'true'], + 'original_price_info' => [ + 'title' => '', + 'description' => 'The price information before the price change. This field has a value only when isChanged is true.', 'type' => 'object', 'properties' => [ - 'total_count' => [ - 'title' => '总数量', - 'description' => 'the number of total orders', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'total_page' => [ - 'title' => '共几页', - 'description' => 'the number of total pages', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'current_page' => [ - 'title' => '当前第几页', - 'description' => 'current page index', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'page_size' => [ - 'title' => '每页数量', - 'description' => 'page size', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], + 'adult_tax' => ['title' => '', 'description' => 'The tax per adult.', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'child_tax' => ['title' => '', 'description' => 'The tax per child.', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'infant_tax' => ['title' => '', 'description' => 'The tax per infant.', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'adult_price' => ['title' => '', 'description' => 'The unit price per adult.', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'child_price' => ['title' => '', 'description' => 'The unit price per child.', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'infant_price' => ['title' => '', 'description' => 'The unit price per infant.', 'type' => 'number', 'format' => 'double', 'example' => '200'], ], + 'example' => '', ], + 'changed_price_info' => [ + 'title' => '', + 'description' => 'The price information after the price change.', + 'type' => 'object', + 'properties' => [ + 'adult_tax' => ['title' => '', 'description' => 'The tax per adult.', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'child_tax' => ['title' => '', 'description' => 'The tax per child.', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'infant_tax' => ['title' => '', 'description' => 'The tax per infant.', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'adult_price' => ['title' => '', 'description' => 'The unit price per adult.', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'child_price' => ['title' => '', 'description' => 'The unit price per child.', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'infant_price' => ['title' => '', 'description' => 'The unit price per infant.', 'type' => 'number', 'format' => 'double', 'example' => '100'], + ], + 'example' => '', + ], + 'remain_seats' => ['title' => '', 'description' => 'The number of remaining seats. A indicates more than 9. Values 0 through 9 represent the exact number.', 'type' => 'string', 'example' => 'A'], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'error data'."\n" - ."\n", - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"order_num\\": 0,\\n \\"out_order_num\\": \\"x091-2023-0220-j-0001\\",\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"order_status\\": \\"4\\",\\n \\"book_time\\": 1677210784000,\\n \\"succeed_time\\": 1677210786000,\\n \\"pay_time\\": 1677210788000,\\n \\"total_price\\": 3000,\\n \\"real_pay_price\\": 3000,\\n \\"promotion_price\\": 10,\\n \\"passenger_list\\": [\\n {\\n \\"last_name\\": \\"ZHANG\\",\\n \\"first_name\\": \\"SAN\\",\\n \\"birthday\\": \\"20020301\\",\\n \\"type\\": 0,\\n \\"mobile_phone_number\\": \\"183******96\\",\\n \\"mobile_country_code\\": \\"86\\",\\n \\"gender\\": 0,\\n \\"nationality\\": \\"CN\\",\\n \\"credential\\": {\\n \\"cert_issue_place\\": \\"CN\\",\\n \\"credential_num\\": \\"E1***5674\\",\\n \\"expire_date\\": \\"20290101\\",\\n \\"credential_type\\": 1\\n }\\n }\\n ],\\n \\"session_nick\\": \\"nick\\",\\n \\"pay_status\\": \\"2\\"\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'OrderList', - 'description' => 'query order list', - 'translator' => 'machine', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"solution\\": {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ\\",\\n \\"adult_price\\": 300,\\n \\"adult_tax\\": 30,\\n \\"child_price\\": 200,\\n \\"child_tax\\": 20,\\n \\"infant_price\\": 200,\\n \\"infant_tax\\": 10,\\n \\"refund_ticket_coupon_description\\": \\"description\\",\\n \\"product_type_description\\": \\"description\\",\\n \\"journey_list\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"ALL_CABIN\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"\\\\\\"\\\\\\"\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"segment_baggage_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"passenger_baggage_allowance_mapping\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 1,\\n \\"baggage_weight\\": 10,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 10,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true\\n }\\n }\\n }\\n ],\\n \\"segment_refund_change_rule_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 1,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 10,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 10\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 20,\\n \\"can_return_all_tax\\": false,\\n \\"return_part_tax_fee\\": 30\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 10\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 3,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 10\\n }\\n ]\\n }\\n }\\n }\\n ],\\n \\"segment_baggage_check_in_info_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"luggage_direct_info_type\\": 1\\n }\\n ]\\n },\\n \\"is_changed\\": true,\\n \\"original_price_info\\": {\\n \\"adult_tax\\": 20,\\n \\"child_tax\\": 20,\\n \\"infant_tax\\": 20,\\n \\"adult_price\\": 200,\\n \\"child_price\\": 200,\\n \\"infant_price\\": 200\\n },\\n \\"changed_price_info\\": {\\n \\"adult_tax\\": 10,\\n \\"child_tax\\": 10,\\n \\"infant_tax\\": 10,\\n \\"adult_price\\": 100,\\n \\"child_price\\": 100,\\n \\"infant_price\\": 100\\n },\\n \\"remain_seats\\": \\"A\\"\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'Pricing', + 'changeSet' => [ + ['createdAt' => '2025-11-18T06:20:03.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-18T06:10:43.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-12T04:01:07.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-12T03:58:52.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-11-12T03:58:45.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-24T06:03:24.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-24T05:51:47.000Z', 'description' => 'OpenAPI offline'], + ], ], 'RefundApply' => [ - 'summary' => 'Ticket Refund - Application', + 'summary' => 'Submits a refund application for an air ticket.', 'path' => '/airticket/v1/refund/action-apply', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'methods' => ['post'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'accessTokenAuth' => [], @@ -6434,57 +3726,35 @@ [ 'name' => 'order_num', 'in' => 'formData', - 'schema' => [ - 'title' => '订单号', - 'description' => 'Order number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '4966***617111', - ], + 'schema' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '4966***617111'], ], [ 'name' => 'refund_type', 'in' => 'formData', 'style' => 'json', 'schema' => [ - 'title' => '退票类型 非自愿退票申请，要上传附件', - 'description' => 'Refund type - involuntary or voluntary. '."\n" - .'attachments are required for involuntary refund application.', + 'title' => '', + 'description' => 'The refund type. Attachments are required for involuntary refund applications.', 'type' => 'object', 'properties' => [ - 'refund_type_id' => [ - 'title' => '申请退票类型 0:自愿申请; 1:非自愿申请(不可抗力); 2:我要改变行程计划、我不想飞', - 'description' => '2: Voluntary (I want to change my travel plan/I don\'t want to fly). '."\n" - .'5: Involuntary, due to flight delay or cancellation, schedule changes, or other airline reasons. '."\n" - .'6: Involuntary, due to health reasons with a medical report from a hospital of at least secondary level A or above.', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '2', - ], + 'refund_type_id' => ['title' => '', 'description' => 'The refund type. Valid values:'."\n" + .'- 2: Voluntary refund (change of travel plans or decision not to fly).'."\n" + .'- 5: Involuntary refund due to airline reasons such as flight delay, cancellation, or schedule change.'."\n" + .'- 6: Involuntary refund due to medical reasons with a certificate from a Grade II Class A hospital or above.'."\n" + ."\n" + .'Note: Attachments are not mandatory, but providing attachments for involuntary refunds can improve the success rate of the refund application.', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '2'], 'file' => [ - 'title' => '附件文件地址数组 先要用单独的文件上传接口上传文件得到文件地址', - 'description' => 'Array of attachment file URLs. First, upload the files using a separate file upload interface to get the file URLs.', + 'title' => '', + 'description' => 'The array of attachment file URLs. Upload files first by using the dedicated file upload operation to obtain the file URLs.', 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'string', - 'required' => false, - 'example' => '["xxx","zzz"]', - ], + 'items' => ['description' => 'The element.', 'type' => 'string', 'required' => false, 'example' => '["xxx","zzz"]', 'title' => ''], 'required' => false, 'example' => '[xxx,yyy]', ], - 'remark' => [ - 'title' => '备注', - 'description' => 'Remark: detailed description about the refund application', - 'type' => 'string', - 'required' => false, - 'example' => 'remark desc', - ], + 'remark' => ['title' => '', 'description' => 'The remarks.', 'type' => 'string', 'example' => 'remark desc', 'required' => false], ], 'required' => true, + 'example' => '', ], ], [ @@ -6492,38 +3762,23 @@ 'in' => 'formData', 'style' => 'json', 'schema' => [ - 'title' => '申请退票的乘机人列表', - 'description' => 'List of passengers applying for a refund', + 'title' => '', + 'description' => 'The list of passengers for the refund application.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger\'s first name', - 'type' => 'string', - 'required' => true, - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger\'s last name', - 'type' => 'string', - 'required' => true, - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document number', - 'type' => 'string', - 'required' => false, - 'example' => '411***********4411', - ], + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'required' => true, 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'required' => true, 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number of the passenger.', 'type' => 'string', 'example' => '411***********4411', 'required' => false], ], 'required' => false, + 'title' => '', + 'example' => '', ], 'required' => true, + 'example' => '', ], ], [ @@ -6531,471 +3786,125 @@ 'in' => 'formData', 'style' => 'json', 'schema' => [ - 'title' => '申请提退的行程', - 'description' => 'Itinerary for which a refund is being requested', + 'title' => '', + 'description' => 'The journeys for the refund application.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'Flight segment information', + 'title' => '', + 'description' => 'The segment information.', 'type' => 'array', 'items' => [ - 'description' => 'Segment', + 'description' => 'segment', 'type' => 'object', 'properties' => [ - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Three-letter code of the departure airport (uppercase)', - 'type' => 'string', - 'required' => true, - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Three-letter code of the arrival airport (uppercase)', - 'type' => 'string', - 'required' => true, - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Three-letter code of the departure city (uppercase)', - 'type' => 'string', - 'required' => true, - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Three-letter code of the arrival city (uppercase)', - 'type' => 'string', - 'required' => true, - 'example' => 'MFM', - ], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'required' => true, 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'required' => true, 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'required' => true, 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'required' => true, 'example' => 'MFM'], ], 'required' => false, + 'title' => '', + 'example' => '', ], 'required' => true, + 'example' => '', ], ], 'required' => false, + 'title' => '', + 'example' => '', ], 'required' => true, + 'example' => '', ], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'Access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'Multi-language, default to buyer account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'The language setting. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<ApplyRefundRes, Object>', + 'title' => '', 'description' => 'PopBaseRes<ApplyRefundRes, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'HTTP request successful, status value is always 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'Error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'Whether the request was successful', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'Request RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'Correctly processed return data', + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ - 'order_num' => [ - 'title' => '订单号', - 'description' => 'Order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4966***617111', - ], + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617111'], 'refund_results' => [ - 'title' => '退票单申请结果列表', - 'description' => 'List of refund application results', + 'title' => '', + 'description' => 'The list of refund application results.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'refund_order_num' => [ - 'title' => '退票单号', - 'description' => 'Refund order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4966***617202', - ], - 'status' => [ - 'title' => '退票单状态 0:退票单创建成功; 1:退票单创建失败', - 'description' => 'Refund order status 0: Refund order created successfully; 1: Refund order creation failed', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'fail_reason' => [ - 'title' => '退票申请失败原因', - 'description' => 'Reason for refund application failure', - 'type' => 'string', - 'example' => 'desc reason', - ], + 'refund_order_num' => ['title' => '', 'description' => 'The refund order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617202'], + 'status' => ['title' => '', 'description' => 'The refund order status. Valid values:'."\n" + .'- 0: The refund order is created.'."\n" + .'- 1: The refund order failed to be created.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'fail_reason' => ['title' => '', 'description' => 'The reason for the refund application failure.', 'type' => 'string', 'example' => 'desc reason'], 'refund_passengers' => [ - 'title' => '该退票单下包含的退票乘机人列表', - 'description' => 'List of passengers for the refund order', + 'title' => '', + 'description' => 'The list of passengers included in the refund order.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger first name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger last name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document number', - 'type' => 'string', - 'example' => '411***********4411', - ], + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number of the passenger.', 'type' => 'string', 'example' => '411***********4411'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Data carried in error handling', - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_num\\": 0,\\n \\"refund_results\\": [\\n {\\n \\"refund_order_num\\": 0,\\n \\"status\\": 0,\\n \\"fail_reason\\": \\"desc reason\\",\\n \\"refund_passengers\\": [\\n {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n }\\n ]\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'Refund Application', - 'translator' => 'machine', - ], - 'RefundDetailList' => [ - 'summary' => 'Refund - Detail List', - 'path' => '/airticket/v1/refund/detail-list', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ - [ - 'name' => 'order_num', - 'in' => 'query', - 'schema' => [ - 'title' => '订单号', - 'description' => 'Order number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '49884*****950', - ], - ], - [ - 'name' => 'refund_create_begin_time', - 'in' => 'query', - 'schema' => [ - 'title' => '退票单创建开始时间，UTC时间戳', - 'description' => 'Refund order creation start time, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1677229002000', - ], - ], - [ - 'name' => 'refund_create_end_time', - 'in' => 'query', - 'schema' => [ - 'title' => '退票单创建结束时间，UTC时间戳', - 'description' => 'Refund order creation end time, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1677229005000', - ], - ], - [ - 'name' => 'page_index', - 'in' => 'query', - 'schema' => [ - 'title' => '页索引', - 'description' => 'Page index', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - ], - [ - 'name' => 'page_size', - 'in' => 'query', - 'schema' => [ - 'title' => '页大小', - 'description' => 'Page size', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '20', - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'Access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'Multi-language, default to buyer account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<PageData<RefundOrder>, Object>', - 'description' => 'PopBaseRes<PageData<RefundOrder>, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'HTTP request successful, status value is 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'Error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'Whether the operation was successful', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'Request RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'Properly processed return data', - 'type' => 'object', - 'properties' => [ - 'list' => [ - 'title' => '数据列表', - 'description' => 'Data list', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'refund_order_num' => [ - 'title' => '退票单号', - 'description' => 'Refund order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '49884*****950', - ], - 'order_num' => [ - 'title' => '订单号', - 'description' => 'Order number （ Ticketing Order Number）', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '49884*****2345', - ], - 'refund_order_status' => [ - 'title' => '退票单状态 0:申请退票; 1:退票受理中; 2:退票失败; 3:退票成功', - 'description' => 'Refund order status: 0: Refund application; 1: Refund in progress; 2: Refund failed; 3: Refund succeeded', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'transaction_no' => [ - 'title' => '交易流水号', - 'description' => 'Transaction serial number', - 'type' => 'string', - 'example' => '49884**tde-95za', - ], - 'utc_create_time' => [ - 'title' => '创建时间 UTC时间戳', - 'description' => 'Creation time, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677229002000', - ], - 'is_multi_refund' => [ - 'title' => '是否是补退单', - 'description' => 'Whether it is a supplementary refund', - 'type' => 'boolean', - 'example' => 'true', - ], - 'related_refund_order_num' => [ - 'title' => '该补退单号关联的原单退票单号 补退单才会有，表示关联原单的退票单ID', - 'description' => 'The original refund order number associated with this supplementary refund. Only present for supplementary refunds, indicating the ID of the original refund order.', - 'type' => 'string', - 'example' => '49884*****2387', - ], - ], - ], - ], - 'pagination' => [ - 'title' => '分页信息', - 'description' => 'Pagination information', - 'type' => 'object', - 'properties' => [ - 'total_count' => [ - 'title' => '总数量', - 'description' => 'Total count', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'total_page' => [ - 'title' => '共几页', - 'description' => 'Total pages', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'current_page' => [ - 'title' => '当前第几页', - 'description' => 'Current page number', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'page_size' => [ - 'title' => '每页数量', - 'description' => 'Number of items per page', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - ], - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Data carried in error handling', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"refund_order_num\\": 0,\\n \\"order_num\\": 0,\\n \\"refund_order_status\\": 1,\\n \\"transaction_no\\": \\"49884**tde-95za\\",\\n \\"utc_create_time\\": 1677229002000,\\n \\"is_multi_refund\\": true,\\n \\"related_refund_order_num\\": \\"49884*****2387\\"\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'Refund Detail List', - 'translator' => 'machine', + 'title' => 'RefundApply', + 'changeSet' => [], ], 'RefundDetail' => [ - 'summary' => 'Refund - Detail', + 'summary' => 'Retrieves the details of a refund order.', 'path' => '/airticket/v1/refund/detail', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'methods' => ['get'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'accessTokenAuth' => [], @@ -7007,643 +3916,214 @@ [ 'name' => 'refund_order_num', 'in' => 'query', - 'schema' => [ - 'title' => '退票单号', - 'description' => 'Refund order number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '4966***617732', - ], + 'schema' => ['title' => '', 'description' => 'The refund order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '4966***617732'], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'Multi-language, default to buyer account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'The language. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<RefundOrderDetail, Object>', + 'title' => '', 'description' => 'PopBaseRes<RefundOrderDetail, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'HTTP request successful, status value is 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'Error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'Whether the request was successful', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'Request RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request was successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'Correctly processed return data', + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ - 'refund_order_num' => [ - 'title' => '退票单号', - 'description' => 'Refund order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4966***617654', - ], - 'order_num' => [ - 'title' => '订单号', - 'description' => 'Order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4966***617111', - ], - 'status' => [ - 'title' => '退票单状态 0:申请退票; 1:退票受理中; 2:退票失败; 3:退票成功', - 'description' => 'Refund order status 0: Refund application; 1: Refund in progress; 2: Refund failed; 3: Refund successful', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'refund_type' => [ - 'title' => '申请退票类型 2:自愿申请; 5:航班延误或取消、航班时刻变更等航司原因; 6:身体原因且有二级甲等医院<含>以上的医院证明; 7:非自愿确定性应急引导; 100:非自愿非确定性应急', - 'description' => '2: Voluntary application; 5: Flight delay or cancellation, flight schedule change, etc., due to airline reasons; 6: Health reasons with a report from a hospital of at least secondary level A; 7: Involuntary emergency guidance; 100: Involuntary non-emergency', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'refund_reason' => [ - 'title' => '提退原因', - 'description' => 'Reason for refund', - 'type' => 'string', - 'example' => 'desc reason', - ], - 'refuse_reason' => [ - 'title' => '提退拒绝原因', - 'description' => 'Reason for refund rejection', - 'type' => 'string', - 'example' => 'refuse reason', - ], + 'refund_order_num' => ['title' => '', 'description' => 'The refund order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617654'], + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '4966***617111'], + 'status' => ['title' => '', 'description' => 'The refund order status. Valid values:'."\n" + .'- 0: refund requested.'."\n" + .'- 1: refund being processed.'."\n" + .'- 2: refund failed.'."\n" + .'- 3: refund succeeded.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'refund_type' => ['title' => '', 'description' => 'The refund request type. Valid values:'."\n" + .'- 2: voluntary request.'."\n" + .'- 5: airline-initiated reasons such as flight delay, cancellation, or schedule change.'."\n" + .'- 6: medical reasons with a certificate from a Grade II Class A hospital or above.'."\n" + .'- 7: involuntary definitive emergency guidance.'."\n" + .'- 100: involuntary non-definitive emergency.', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'refund_reason' => ['title' => '', 'description' => 'The reason for the refund request.', 'type' => 'string', 'example' => 'desc reason'], + 'refuse_reason' => ['title' => '', 'description' => 'The reason for rejecting the refund request.', 'type' => 'string', 'example' => 'refuse reason'], 'refund_attachment_urls' => [ - 'title' => '病退附件url列表', - 'description' => 'List of URLs for medical refund attachments', + 'title' => '', + 'description' => 'The list of attachment URLs for medical refund requests.', 'type' => 'array', - 'items' => [ - 'description' => 'Item', - 'type' => 'string', - 'example' => '["xxx","zzz"]', - ], + 'items' => ['description' => 'The element.', 'type' => 'string', 'example' => '["xxx","zzz"]', 'title' => ''], 'example' => '[zzz,yyy]', ], - 'utc_create_time' => [ - 'title' => '退票单创建时间, UTC时间戳', - 'description' => 'Refund order creation time, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677229002000', - ], - 'pay_success_utc_time' => [ - 'title' => '实际退款时间 UTC时间戳', - 'description' => 'Actual refund time, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677229005000', - ], - 'transaction_no' => [ - 'title' => '交易流水号', - 'description' => 'Transaction serial number', - 'type' => 'string', - 'example' => '1677229005000', - ], + 'utc_create_time' => ['title' => '', 'description' => 'The creation time of the refund order, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677229002000'], + 'pay_success_utc_time' => ['title' => '', 'description' => 'The actual refund time, in UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677229005000'], + 'transaction_no' => ['title' => '', 'description' => 'The transaction serial number.', 'type' => 'string', 'example' => '1677229005000'], 'passenger_refund_details' => [ - 'title' => '乘机人提退详情列表,乘机人纬度的提退信息', - 'description' => 'List of passenger refund details, refund information by passenger', + 'title' => '', + 'description' => 'The list of passenger-level refund details.', 'type' => 'array', 'items' => [ - 'description' => 'Item', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ 'passenger' => [ - 'title' => '提退的乘机人信息', - 'description' => 'Information of the passenger applying for a refund', + 'title' => '', + 'description' => 'The passenger information for the refund.', 'type' => 'object', 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger\'s first name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger\'s last name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document number', - 'type' => 'string', - 'example' => '411***********4411', - ], + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number.', 'type' => 'string', 'example' => '411***********4411'], ], + 'example' => '', ], 'refund_fee' => [ - 'title' => '退票费明细', - 'description' => 'Refund fee details', + 'title' => '', + 'description' => 'The refund fee breakdown.', 'type' => 'object', 'properties' => [ - 'non_refundable_ticket_fee' => [ - 'title' => '票不可退金额，即退票手续费', - 'description' => 'fare penalty', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'non_refundable_tax_fee' => [ - 'title' => '税不可退金额，即退税手续费', - 'description' => 'tax penalty', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'already_used_total_fee' => [ - 'title' => '已使用的机票总价格', - 'description' => 'Total price of the used segments', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'non_refundable_change_service_fee' => [ - 'title' => '不可退改签手续费', - 'description' => 'Non-refundable change penalty', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'non_refundable_change_upgrade_fee' => [ - 'title' => '不可退升舱手续费', - 'description' => 'Non-refundable fare difference', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'refund_to_buyer_money' => [ - 'title' => '原票可退给用户的金额(票价 + 税费 - 退票手续费 - 退税手续费 - 已使用的机票总价格 - 营销)', - 'description' => 'Amount refundable to the user (ticket price + taxes - fare penalty - tax penalty - total price of used segments)', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'modify_refund_to_buyer_money' => [ - 'title' => '改签退给用户的金额', - 'description' => 'Amount refunded to the user after a change', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], + 'non_refundable_ticket_fee' => ['title' => '', 'description' => 'The non-refundable ticket amount, which is the ticket refund service fee.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'non_refundable_tax_fee' => ['title' => '', 'description' => 'The non-refundable tax amount, which is the tax refund service fee.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'already_used_total_fee' => ['title' => '', 'description' => 'The total price of already used tickets.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'non_refundable_change_service_fee' => ['title' => '', 'description' => 'The non-refundable rebooking service fee.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'non_refundable_change_upgrade_fee' => ['title' => '', 'description' => 'The non-refundable cabin upgrade service fee.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'refund_to_buyer_money' => ['title' => '', 'description' => 'The refundable amount to the buyer from the original ticket (ticket price + taxes - ticket refund service fee - tax refund service fee - total price of already used tickets).', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'modify_refund_to_buyer_money' => ['title' => '', 'description' => 'The refundable amount to the buyer from rebooking.', 'type' => 'number', 'format' => 'double', 'example' => '30'], ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'contain_multi_refund' => [ - 'title' => '是否含有补退', - 'description' => 'Whether it contains additional refunds', - 'type' => 'boolean', - 'example' => 'false', - ], + 'contain_multi_refund' => ['title' => '', 'description' => 'Indicates whether the refund contains a supplementary refund.', 'type' => 'boolean', 'example' => 'false'], 'multi_refund_details' => [ - 'title' => '首次退关联的补退详情列表', - 'description' => 'List of additional refund details associated with the initial refund', + 'title' => '', + 'description' => 'The list of supplementary refund details associated with the initial refund.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'multi_refund_order_num' => [ - 'title' => '补退单退票单号', - 'description' => 'Additional refund order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '498843***6950', - ], - 'multi_refund_transaction_no' => [ - 'title' => '补退单流水号', - 'description' => 'Transaction number of the Additional Refund order', - 'type' => 'string', - 'example' => '498843***6950', - ], + 'multi_refund_order_num' => ['title' => '', 'description' => 'The refund order number of the supplementary refund.', 'type' => 'integer', 'format' => 'int64', 'example' => '498843***6950'], + 'multi_refund_transaction_no' => ['title' => '', 'description' => 'The transaction serial number of the supplementary refund.', 'type' => 'string', 'example' => '498843***6950'], 'passenger_multi_refund_details' => [ - 'title' => '乘机人纬度的补退详情', - 'description' => 'Additional refund details from the passenger\'s', + 'title' => '', + 'description' => 'The passenger-level supplementary refund details.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ 'passenger' => [ - 'title' => '提退的乘机人', - 'description' => 'Passenger for the refund', + 'title' => '', + 'description' => 'The passenger for the refund.', 'type' => 'object', 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger\'s first name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger\'s last name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document number', - 'type' => 'string', - 'example' => '411***********4411', - ], + 'first_name' => ['title' => '', 'description' => 'The first name of the passenger.', 'type' => 'string', 'example' => 'SAN'], + 'last_name' => ['title' => '', 'description' => 'The last name of the passenger.', 'type' => 'string', 'example' => 'ZHANG'], + 'document' => ['title' => '', 'description' => 'The document number.', 'type' => 'string', 'example' => '411***********4411'], ], + 'example' => '', ], - 'original_order_refund_fee' => [ - 'title' => '原单补退的金额', - 'description' => 'Amount refunded from the Ticketing order', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'change_order_refund_fee' => [ - 'title' => '改签单补退的金额', - 'description' => 'Amount refunded from the Change order', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], + 'original_order_refund_fee' => ['title' => '', 'description' => 'The supplementary refund amount from the original order.', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'change_order_refund_fee' => ['title' => '', 'description' => 'The supplementary refund amount from the rebooking order.', 'type' => 'number', 'format' => 'double', 'example' => '30'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'refund_journeys' => [ - 'title' => '提退的行程', - 'description' => 'Refund journey', + 'title' => '', + 'description' => 'The journeys included in the refund.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'Number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'Segment information', + 'title' => '', + 'description' => 'The segment information.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'Segment ID format: flight number + departure airport + arrival airport + departure date (MMdd)', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310'."\n", - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Three-letter code of the departure airport (in uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Three-letter code of the arrival airport (in uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Three-letter code of the departure city (in uppercase)', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Three-letter code of the arrival city (in uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'Marketing flight number (e.g., HO1295)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'Marketing flight number (numeric part, e.g., 1295)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'Marketing airline (e.g., HO)', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'Operating flight number (e.g., CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'Operating airline (e.g., CX)', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Departure date and time in string format (yyyy-mm-dd hh:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Arrival date and time in string format (yyyy-mm-dd hh:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'Indicates whether it is a codeshare flight', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'Departure terminal of the flight', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'Arrival terminal of the flight', - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'Aircraft type', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'service class ( compartment )', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数', - 'description' => 'Number of available seats', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'List of stop cities, present when stopQuantity > 0, multiple values separated by commas', - 'type' => 'string', - 'example' => 'SEL,HKG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'Number of stop cities', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'Flight duration in minutes', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], + 'segment_id' => ['title' => '', 'description' => 'The segment ID. Format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'."\n"], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter IATA code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (such as HO1295).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (such as 1295).', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline code (such as HO).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (such as CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline code (such as CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The cabin code.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This field has a value when stopQuantity is greater than 0. Multiple cities are separated by commas.', 'type' => 'string', 'example' => 'SEL,HKG'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration, in minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Error handling carries data', - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"refund_order_num\\": 0,\\n \\"order_num\\": 0,\\n \\"status\\": 1,\\n \\"refund_type\\": 5,\\n \\"refund_reason\\": \\"desc reason\\",\\n \\"refuse_reason\\": \\"refuse reason\\",\\n \\"refund_attachment_urls\\": [\\n \\"[\\\\\\"xxx\\\\\\",\\\\\\"zzz\\\\\\"]\\"\\n ],\\n \\"utc_create_time\\": 1677229002000,\\n \\"pay_success_utc_time\\": 1677229005000,\\n \\"transaction_no\\": \\"1677229005000\\",\\n \\"passenger_refund_details\\": [\\n {\\n \\"passenger\\": {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n },\\n \\"refund_fee\\": {\\n \\"non_refundable_ticket_fee\\": 30,\\n \\"non_refundable_tax_fee\\": 30,\\n \\"already_used_total_fee\\": 30,\\n \\"non_refundable_change_service_fee\\": 30,\\n \\"non_refundable_change_upgrade_fee\\": 30,\\n \\"refund_to_buyer_money\\": 30,\\n \\"modify_refund_to_buyer_money\\": 30\\n }\\n }\\n ],\\n \\"contain_multi_refund\\": false,\\n \\"multi_refund_details\\": [\\n {\\n \\"multi_refund_order_num\\": 0,\\n \\"multi_refund_transaction_no\\": \\"498843***6950\\",\\n \\"passenger_multi_refund_details\\": [\\n {\\n \\"passenger\\": {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n },\\n \\"original_order_refund_fee\\": 30,\\n \\"change_order_refund_fee\\": 30\\n }\\n ]\\n }\\n ],\\n \\"refund_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\\\n\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', 'title' => 'RefundDetail', - 'translator' => 'machine', - ], - 'ChangeConfirm' => [ - 'summary' => 'Change - Confirm', - 'path' => '/airticket/v1/change/action-confirm', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'parameters' => [ - [ - 'name' => 'change_order_num', - 'in' => 'formData', - 'schema' => [ - 'title' => '改签单号', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '4988430***950', - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<ConfirmChangeRes, Object>', - 'description' => 'PopBaseRes<ConfirmChangeRes, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'pay_amount' => [ - 'title' => '改签支付金额', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'transaction_no' => [ - 'title' => '改签支付流水号', - 'description' => '', - 'type' => 'string', - 'example' => 'hkduendkd-2023-dj0', - ], - 'pay_time' => [ - 'title' => '改签支付时间，13位时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1756797933000', - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"request_id\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"pay_amount\\": 30,\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\"\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'ChangeConfirm', - 'translator' => 'machine', + 'changeSet' => [], ], - 'ChangeCancel' => [ - 'summary' => 'Change-Cancel', - 'path' => '/airticket/v1/change/action-cancel', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'RefundDetailList' => [ + 'summary' => 'Queries the details of refund orders.', + 'path' => '/airticket/v1/refund/detail-list', + 'methods' => ['get'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'accessTokenAuth' => [], @@ -7653,3653 +4133,544 @@ 'systemTags' => [], 'parameters' => [ [ - 'name' => 'change_order_num', - 'in' => 'formData', - 'schema' => [ - 'title' => '改签单号', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '4988430***950', - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes', - 'description' => 'PopBaseRes', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"request_id\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": \\"null\\",\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'ChangeCancel', - 'translator' => 'machine', - ], - 'ChangeDetailListOfBuyer' => [ - 'summary' => 'Change Order List - Related to Buyer Account', - 'path' => '/airticket/v1/change/buyer/detail-list', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], + 'name' => 'order_num', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '49884*****950', 'required' => false], ], - ], - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ [ - 'name' => 'utc_create_begin', + 'name' => 'refund_create_begin_time', 'in' => 'query', - 'schema' => [ - 'title' => '改签单创建开始时间 UTC时间戳13位', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1677415276000', - ], + 'schema' => ['title' => '', 'description' => 'The start time for refund order creation. The value is a UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1677229002000'], ], [ - 'name' => 'utc_create_end', + 'name' => 'refund_create_end_time', 'in' => 'query', - 'schema' => [ - 'title' => '改签单创建结束时间 UTC时间戳13位', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1677415279000', - ], + 'schema' => ['title' => '', 'description' => 'The end time for refund order creation. The value is a UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1677229005000'], ], [ 'name' => 'page_index', 'in' => 'query', - 'schema' => [ - 'title' => '页索引', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['title' => '', 'description' => 'The page index.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], ], [ 'name' => 'page_size', 'in' => 'query', - 'schema' => [ - 'title' => '页大小', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '10', - ], + 'schema' => ['title' => '', 'description' => 'The page size.', 'type' => 'integer', 'format' => 'int32', 'example' => '20', 'required' => false], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'The access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'The language. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<PageData<ChangeOrderSearchResult>, Object>', - 'description' => 'PopBaseRes<PageData<ChangeOrderSearchResult>, Object>', + 'title' => '', + 'description' => 'PopBaseRes<PageData<RefundOrder>, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request was successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => '', + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ 'list' => [ - 'title' => '数据列表', - 'description' => '', + 'title' => '', + 'description' => 'The data list.', 'type' => 'array', 'items' => [ - 'description' => '', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'change_order_num' => [ - 'title' => '改签单号', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4988430***950', - ], - 'order_num' => [ - 'title' => '订单号', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4988430***971', - ], - 'order_status' => [ - 'title' => '申请单状态 0:初始状态; 1:待支付; 2:付款成功; 3:改签成功; 4:改签关闭', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'pay_status' => [ - 'title' => '支付状态 0:初始状态; 1:待支付; 2:支付成功; 3:转交易成功; 4:关闭已支付订单成功; 5:关闭未支付订单成功', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'transaction_no' => [ - 'title' => '交易流水号', - 'description' => '', - 'type' => 'string', - 'example' => 'hkduendkd-2023-dj0', - ], - 'utc_create_time' => [ - 'title' => '订单创建时间 UTC时间戳', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677415274000', - ], + 'refund_order_num' => ['title' => '', 'description' => 'The refund order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '49884*****950'], + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '49884*****2345'], + 'refund_order_status' => ['title' => '', 'description' => 'The refund order status. Valid values:'."\n" + .'- 0: refund requested.'."\n" + .'- 1: refund being processed.'."\n" + .'- 2: refund failed.'."\n" + .'- 3: refund succeeded.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'transaction_no' => ['title' => '', 'description' => 'The transaction number.', 'type' => 'string', 'example' => '49884**tde-95za'], + 'utc_create_time' => ['title' => '', 'description' => 'The creation time. The value is a UTC timestamp.', 'type' => 'integer', 'format' => 'int64', 'example' => '1677229002000'], + 'is_multi_refund' => ['title' => '', 'description' => 'Indicates whether this is a supplementary refund order.', 'type' => 'boolean', 'example' => 'true'], + 'related_refund_order_num' => ['title' => '', 'description' => 'The refund order number of the original order associated with this supplementary refund order. This field is returned only for supplementary refund orders and indicates the refund order ID of the associated original order.', 'type' => 'string', 'example' => '49884*****2387'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'pagination' => [ - 'title' => '分页信息', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'total_count' => [ - 'title' => '总数量', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'total_page' => [ - 'title' => '共几页', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'current_page' => [ - 'title' => '当前第几页', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'page_size' => [ - 'title' => '每页数量', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - ], - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"request_id\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"change_order_num\\": 0,\\n \\"order_num\\": 0,\\n \\"order_status\\": 2,\\n \\"pay_status\\": 2,\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"utc_create_time\\": 1677415274000\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'Change Detail List of Buyer', - 'translator' => 'machine', - ], - 'ChangeDetail' => [ - 'summary' => 'Change-Detail', - 'path' => '/airticket/v1/change/detail', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ - [ - 'name' => 'change_order_num', - 'in' => 'query', - 'schema' => [ - 'title' => '改签单号', - 'description' => 'Change order number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '4988430***950', - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'Multi-language, default to buyer\'s account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<ChangeOrderDetail, Object>', - 'description' => 'PopBaseRes<ChangeOrderDetail, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'HTTP request successful, status value is 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'Error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'Whether it is successful', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'Request RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'Correctly processed return data', - 'type' => 'object', - 'properties' => [ - 'change_order_num' => [ - 'title' => '改签单号', - 'description' => 'Change order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4988430***950', - ], - 'order_num' => [ - 'title' => '订单号', - 'description' => 'Ticketing Order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '5988430***541', - ], - 'change_passengers' => [ - 'title' => '改签的乘机人列表', - 'description' => 'List of passengers for the change', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger first name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger last name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document number', - 'type' => 'string', - 'example' => '411***********4411', - ], - ], - ], - ], - 'total_amount' => [ - 'title' => '改签单支付总金额', - 'description' => 'Total payment amount for the change order', - 'type' => 'number', - 'format' => 'double', - 'example' => '300', - ], - 'order_status' => [ - 'title' => '改签单状态 0:初始状态; 1:待支付; 2:付款成功; 3:改签成功; 4:改签关闭', - 'description' => 'Change order status 0: Initial state; 1: Pending payment; 2: Payment successful; 3: Change successful; 4: Change closed', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'close_reason' => [ - 'title' => '改签关单原因', - 'description' => 'Reason for closing the change order', - 'type' => 'string', - 'example' => 'reason desc', - ], - 'transaction_no' => [ - 'title' => '交易流水号', - 'description' => 'Transaction serial number', - 'type' => 'string', - 'example' => 'hkduendkd-2023-dj0', - ], - 'change_reason_type' => [ - 'title' => '改签原因类型 0:自愿改期; 1:航班变动/航班取消; 2:因疫情改签', - 'description' => 'Change reason type. '."\n" - .'0: Voluntary change; '."\n" - .'1: Involuntary change, due to flight delay or cancellation, schedule changes, or other airline reasons; '."\n" - .'2: Involuntary change, due to health reasons with a medical report', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'create_utc_time' => [ - 'title' => '改签单创建时间，UTC时间戳', - 'description' => 'Creation time of the change order, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677415276000', - ], - 'last_confirm_utc_time' => [ - 'title' => '买家最迟支付时间，UTC时间戳', - 'description' => 'Latest payment time for the buyer, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677415278000', - ], - 'pay_status' => [ - 'title' => '支付状态 0:初始状态; 1:待支付; 2:支付成功; 3:转交易成功; 4:关闭已支付订单成功; 5:关闭未支付订单成功', - 'description' => 'Payment status 0: initial state; 1: pending payment; 2: payment successful; 4: successfully closed paid order; 5: successfully closed unpaid order', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'pay_success_utc_time' => [ - 'title' => '买家支付成功时间，UTC时间戳', - 'description' => 'The time when the buyer successfully paid, in UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677415255000', - ], - 'close_utc_time' => [ - 'title' => '订单关闭时间，UTC时间戳', - 'description' => 'The time when the order was closed, in UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677415244000', - ], - 'contact' => [ - 'title' => '改签联系人信息', - 'description' => 'Contact information for the change request', + 'title' => '', + 'description' => 'The pagination information.', 'type' => 'object', 'properties' => [ - 'mobile_country_code' => [ - 'title' => '国家区位码', - 'description' => 'Country code', - 'type' => 'string', - 'example' => '86', - ], - 'mobile_phone_num' => [ - 'title' => '联系人用户手机号', - 'description' => 'Contact\'s mobile phone number', - 'type' => 'string', - 'example' => '183*****92', - ], - 'email' => [ - 'title' => '邮件地址', - 'description' => 'Email address', - 'type' => 'string', - 'example' => 'gao******@gmail.com', - ], - ], - ], - 'original_journeys' => [ - 'title' => '原始的行程', - 'description' => 'Original journeys', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'Number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'Segment information', - 'type' => 'array', - 'items' => [ - 'description' => 'Segment', - 'type' => 'object', - 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'Segment ID format: flight number + departure airport + arrival airport + departure date (yyyyMMdd)', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Departure airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Arrival airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Departure city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Arrival city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'Marketing flight number (e.g., HO1295)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'Marketing airline\'s numeric flight number (e.g., 1295)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'Marketing airline (e.g., HO)', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'Operating airline\'s flight number (e.g., CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'Operating airline (e.g., CX)', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight departure date and time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight arrival date and time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'Whether it is a codeshare flight', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'Departure terminal of the flight', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'Arrival terminal of the flight', - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'Aircraft type', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'service class ( compartment )', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数', - 'description' => 'Number of available seats', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'List of stop cities, with values when stopQuantity > 0, separated by commas', - 'type' => 'string', - 'example' => 'SEL,HKG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'Number of stop cities', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'Flight duration in minutes', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], - ], - ], - ], - ], - ], - ], - 'changed_journeys' => [ - 'title' => '改签后的行程', - 'description' => 'New journeys', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'Number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'Segment information', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'Segment ID format: flight number + departure airport + arrival airport + departure date (MMdd)', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Departure airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Arrival airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Departure city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Arrival city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'Marketing flight number (e.g., HO1295)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'Marketing flight number (e.g., 1295)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'Market airline (e.g., HO)', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'Operating flight number (e.g., CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'Operating airline (e.g., CX)', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight departure date and time, in the format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight arrival date and time, in the format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'Whether it is a code-share flight', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'Departure terminal of the flight', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'Arrival terminal of the flight', - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'Aircraft type', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'service class ( compartment )', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数', - 'description' => 'Number of available seats', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'List of stop cities, with values when stopQuantity > 0, separated by commas', - 'type' => 'string', - 'example' => 'SEL,HKG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'Number of stop cities', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'Flight duration in minutes', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], - ], - ], - ], - ], - ], - ], - 'last_journeys' => [ - 'title' => '上一次改签的行程', - 'description' => 'The itinerary of the last change', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'Number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'Segment information', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'Segment ID format: flight number + departure airport + arrival airport + departure date (MMdd)', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Departure airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Arrival airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Departure city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Arrival city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'Marketing flight number (e.g., HO1295)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'Marketing flight number (e.g., 1295)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'Marketing airline (e.g., HO)', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'Operating flight number (e.g., CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'Operating airline (e.g., CX)', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight departure date and time, in the format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight arrival date and time, in the format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'Whether it is a codeshare flight', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'Departure terminal of the flight', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'Arrival terminal of the flight', - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'Aircraft type', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'service class ( compartment )', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数', - 'description' => 'Number of available seats', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'List of stop cities, with values when stopQuantity > 0, separated by commas', - 'type' => 'string', - 'example' => 'SEL,HKG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'Number of stop cities', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'Flight duration in minutes', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], - ], - ], - ], - ], - ], - ], - 'change_fee_details' => [ - 'title' => '改签费用明细 乘机人纬度', - 'description' => 'Change fee details, per passenger', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'passenger' => [ - 'title' => '改签的乘机人信息', - 'description' => 'Information of the passenger for the change', - 'type' => 'object', - 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger\'s first name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger\'s last name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document number', - 'type' => 'string', - 'example' => '411***********4411', - ], - ], - ], - 'change_fee' => [ - 'title' => '乘机人的改签费明细', - 'description' => 'Change fee details for the passenger', - 'type' => 'object', - 'properties' => [ - 'upgrade_fee' => [ - 'title' => '升舱费', - 'description' => 'price difference', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'service_fee' => [ - 'title' => '服务费(手续费)', - 'description' => 'fare penalty', - 'type' => 'number', - 'format' => 'double', - 'example' => '50', - ], - 'tax_fee' => [ - 'title' => '改签税费', - 'description' => 'tax penalty', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - ], - ], - ], + 'total_count' => ['title' => '', 'description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'total_page' => ['title' => '', 'description' => 'The total number of pages.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'current_page' => ['title' => '', 'description' => 'The current page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'page_size' => ['title' => '', 'description' => 'The number of records per page.', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], ], + 'example' => '', ], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Data carried in error handling', - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"change_order_num\\": 0,\\n \\"order_num\\": 0,\\n \\"change_passengers\\": [\\n {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n }\\n ],\\n \\"total_amount\\": 300,\\n \\"order_status\\": 2,\\n \\"close_reason\\": \\"reason desc\\",\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"change_reason_type\\": 1,\\n \\"create_utc_time\\": 1677415276000,\\n \\"last_confirm_utc_time\\": 1677415278000,\\n \\"pay_status\\": 2,\\n \\"pay_success_utc_time\\": 1677415255000,\\n \\"close_utc_time\\": 1677415244000,\\n \\"contact\\": {\\n \\"mobile_country_code\\": \\"86\\",\\n \\"mobile_phone_num\\": \\"183*****92\\",\\n \\"email\\": \\"gao******@gmail.com\\"\\n },\\n \\"original_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"changed_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"last_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"change_fee_details\\": [\\n {\\n \\"passenger\\": {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n },\\n \\"change_fee\\": {\\n \\"upgrade_fee\\": 30,\\n \\"service_fee\\": 50,\\n \\"tax_fee\\": 20\\n }\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'ChangeDetail', - 'translator' => 'machine', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"refund_order_num\\": 0,\\n \\"order_num\\": 0,\\n \\"refund_order_status\\": 1,\\n \\"transaction_no\\": \\"49884**tde-95za\\",\\n \\"utc_create_time\\": 1677229002000,\\n \\"is_multi_refund\\": true,\\n \\"related_refund_order_num\\": \\"49884*****2387\\"\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'RefundDetailList', + 'changeSet' => [], ], - 'ChangeApply' => [ - 'summary' => 'Reschedule-Apply', - 'path' => '/airticket/v1/change/action-apply', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'Search' => [ + 'summary' => 'Searches for flight quotes and returns the lowest price across multiple flights. Note that the response of this operation does not include refund and change rules, free baggage allowance, or baggage through-check rules.', + 'path' => '/airticket/v1/trade/action-search', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'accessTokenAuth' => [], ], ], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ - 'name' => 'order_num', - 'in' => 'formData', - 'schema' => [ - 'title' => '订单号', - 'description' => 'Order number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '4988430***950', - ], - ], - [ - 'name' => 'type', + 'name' => 'cabin_class', 'in' => 'formData', - 'schema' => [ - 'title' => '改期类型0:自愿改期; 1:航班变动/航班取消', - 'description' => 'Change type 0: voluntary change; 1: involuntary change', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '0', - ], + 'schema' => ['title' => '', 'description' => 'The cabin class. Valid values: ALL_CABIN: all cabin classes. Y: economy class. FC: first class and business class. S: premium economy class. YS: economy class and premium economy class. YSC: economy class, premium economy class, and business class.', 'type' => 'string', 'example' => 'ALL_CABIN', 'required' => false], ], [ - 'name' => 'change_passenger_list', + 'name' => 'air_legs', 'in' => 'formData', 'style' => 'json', 'schema' => [ - 'title' => '改签乘机人列表', - 'description' => 'List of passengers for change', + 'title' => '', + 'description' => 'The journey array.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The journey.', 'type' => 'object', 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger\'s first name', - 'type' => 'string', - 'required' => true, - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger\'s last name', - 'type' => 'string', - 'required' => true, - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document number', - 'type' => 'string', + 'departure_city' => ['title' => '', 'description' => 'The three-letter code of the departure city.', 'type' => 'string', 'required' => true, 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter code of the arrival city.', 'type' => 'string', 'required' => true, 'example' => 'MFM'], + 'departure_airport_list' => [ + 'title' => '', + 'description' => 'The list of three-letter codes of departure airports.', + 'type' => 'array', + 'items' => ['description' => 'The three-letter code of the departure airport.', 'type' => 'string', 'required' => false, 'example' => 'PVG', 'title' => ''], 'required' => false, - 'example' => '411***********4411', + 'example' => 'PVG', ], - ], - 'required' => false, - ], - 'required' => true, - ], - ], - [ - 'name' => 'changed_journeys', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'title' => '改签目标航程', - 'description' => 'Proposed itinerary', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'segment_list' => [ - 'title' => '改签目标航段列表', - 'description' => 'List of proposed segments for change', + 'arrival_airport_list' => [ + 'title' => '', + 'description' => 'The list of three-letter codes of arrival airports.', 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'departure_airport' => [ - 'title' => '航班起飞机场三字码', - 'description' => 'Three-letter code of the departure airport', - 'type' => 'string', - 'required' => false, - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码', - 'description' => 'Three-letter code of the arrival airport', - 'type' => 'string', - 'required' => false, - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码', - 'description' => 'Three-letter code of the departure city', - 'type' => 'string', - 'required' => true, - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码', - 'description' => 'Three-letter code of the arrival city', - 'type' => 'string', - 'required' => true, - 'example' => 'MFM', - ], - 'departure_date' => [ - 'title' => '起飞日期 (eg: yyyyMMdd)', - 'description' => 'Departure date (e.g., yyyyMMdd)', - 'type' => 'string', - 'required' => true, - 'example' => '20230320', - ], - 'departure_time' => [ - 'title' => '航班起飞日期，utc时间戳', - 'description' => '(Deprecated) Departure date, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1677232998000', - ], - 'departure_time_str' => [ - 'title' => '航班起飞日期时间，以出发地时区传入，yyyy-MM-dd HH:mm:ss', - 'description' => '(Required) Departure date and time, in the format: yyyy-MM-dd HH:mm:ss', - 'type' => 'string', - 'required' => false, - 'example' => '2024-03-20 09:30:00', - ], - 'arrive_time' => [ - 'title' => '航班到达日期时间，utc时间戳', - 'description' => '(Deprecated) Arrival date and time, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1677232999000', - ], - 'arrive_time_str' => [ - 'title' => '航班到达日期时间，yyyy-MM-dd HH:mm:ss', - 'description' => '(Required) Arrival date and time, in the format: yyyy-MM-dd HH:mm:ss', - 'type' => 'string', - 'required' => false, - 'example' => '2024-03-20 12:30:00', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'Departure terminal', - 'type' => 'string', - 'required' => false, - 'example' => 'T2', - ], - 'arrive_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'Arrival terminal', - 'type' => 'string', - 'required' => false, - 'example' => 'T1', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：KA5809)', - 'description' => 'Marketing flight number (e.g., KA5809)', - 'type' => 'string', - 'required' => true, - 'example' => 'HO1295', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'Operating flight number (e.g., CX601)', - 'type' => 'string', - 'required' => false, - 'example' => 'HO1295', - ], - 'code_share' => [ - 'title' => '是否共享航班', - 'description' => 'Whether it is a codeshare flight', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - ], - 'required' => false, - ], + 'items' => ['description' => 'The three-letter code of the arrival airport.', 'type' => 'string', 'required' => false, 'example' => 'MFM', 'title' => ''], 'required' => false, + 'example' => 'MFM', ], + 'departure_date' => ['title' => '', 'description' => 'The departure date (for example, yyyyMMdd).', 'type' => 'string', 'required' => true, 'example' => '20230310'], ], 'required' => false, + 'title' => '', + 'example' => '', ], 'required' => true, + 'example' => '', ], ], [ - 'name' => 'contact', + 'name' => 'adults', 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'title' => '改签联系人信息', - 'description' => 'Contact information', - 'type' => 'object', - 'properties' => [ - 'mobile_country_code' => [ - 'title' => '国家区位码', - 'description' => 'Country code', - 'type' => 'string', - 'required' => false, - 'example' => '86', - ], - 'mobile_phone_num' => [ - 'title' => '联系人用户手机号', - 'description' => 'Contact\'s mobile phone number', - 'type' => 'string', - 'required' => false, - 'example' => '183*****92', - ], - 'email' => [ - 'title' => '邮件地址', - 'description' => 'Email address', - 'type' => 'string', - 'required' => false, - 'example' => 'gao******@gmail.com', - ], - ], - 'required' => true, - ], + 'schema' => ['title' => '', 'description' => 'The number of adult passengers. Valid values: 1 to 9.', 'type' => 'integer', 'format' => 'int32', 'example' => '2', 'required' => false], ], [ - 'name' => 'remark', + 'name' => 'children', 'in' => 'formData', - 'schema' => [ - 'title' => '买家备注', - 'description' => 'Buyer\'s remarks', - 'type' => 'string', - 'required' => false, - 'example' => 'remark desc', - ], + 'schema' => ['title' => '', 'description' => 'The number of child passengers. Valid values: 0 to 9.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], ], [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'name' => 'infants', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The number of infant passengers. Valid values: 0 to 9.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], ], [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'Multi-language, default to the buyer\'s account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ + 'name' => 'search_control_options', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'title' => 'PopBaseRes<ApplyChangeRes, Object>', - 'description' => 'PopBaseRes<ApplyChangeRes, Object>', + 'title' => '', + 'description' => 'The search control options. This parameter is optional.', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'HTTP request successful, status value is always 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'Business error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'Error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'Whether the operation was successful', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => 'Request RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'Correctly processed return data', - 'type' => 'object', - 'properties' => [ - 'order_num' => [ - 'title' => '订单号', - 'description' => 'Order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4988430***950', - ], - 'change_orders' => [ - 'title' => '改签单申请结果列表', - 'description' => 'List of change application results', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'change_order_num' => [ - 'title' => '改签单号', - 'description' => 'change order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '49884*****950', - ], - 'change_order_status' => [ - 'title' => '改签单状态。 0:改签单创建成功; 5:改签单创建失败', - 'description' => 'change order status. 0: change order created successfully; 5: change order creation failed', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'fail_reason' => [ - 'title' => '改签单创建失败的原因', - 'description' => 'Reason for the failure of the change order creation', - 'type' => 'string', - 'example' => 'desc reason', - ], - 'passengers' => [ - 'title' => '改签单乘机人信息', - 'description' => 'Passenger\'s information for the change order', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger\'s first name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger\'s last name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document number', - 'type' => 'string', - 'example' => '411***********4411', - ], - ], - ], - ], - ], - ], - ], - ], + 'airline_prefer_list' => [ + 'title' => '', + 'description' => 'The list of preferred airlines.', + 'type' => 'array', + 'items' => ['type' => 'string', 'example' => 'FD', 'description' => '', 'required' => false, 'title' => ''], + 'required' => false, + 'example' => 'FD', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Error handling carries data', - 'type' => 'any', - 'example' => 'null', + 'airline_excluded_list' => [ + 'title' => '', + 'description' => 'The list of excluded airlines.', + 'type' => 'array', + 'items' => ['type' => 'string', 'example' => 'AK', 'description' => '', 'required' => false, 'title' => ''], + 'required' => false, + 'example' => '7C', ], + 'service_quality' => ['title' => '', 'description' => 'The service quality identifier.', 'type' => 'string', 'example' => 'A1', 'required' => false], ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_num\\": 0,\\n \\"change_orders\\": [\\n {\\n \\"change_order_num\\": 0,\\n \\"change_order_status\\": 0,\\n \\"fail_reason\\": \\"desc reason\\",\\n \\"passengers\\": [\\n {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n }\\n ]\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => '改签申请', - 'translator' => 'machine', - ], - 'ChangeDetailListOfOrderNum' => [ - 'summary' => 'List of Change Orders - Regarding Forward Orders', - 'path' => '/airticket/v1/change/order-num/detail-list', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ - [ - 'name' => 'order_num', - 'in' => 'query', - 'schema' => [ - 'title' => '订单号', - 'description' => 'Order Number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '4988430***700', - ], - ], - [ - 'name' => 'page_index', - 'in' => 'query', - 'schema' => [ - 'title' => '页索引', - 'description' => 'Page Index', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - ], - [ - 'name' => 'page_size', - 'in' => 'query', - 'schema' => [ - 'title' => '页大小', - 'description' => 'Page Size', - 'type' => 'integer', - 'format' => 'int32', 'required' => false, - 'example' => '20', + 'example' => '', ], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'The access token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'Multi-language, default to buyer account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'The language. The default value is the language configured for the buyer account.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<PageData<ChangeOrderDetail>, Object>', - 'description' => 'PopBaseRes<PageData<ChangeOrderDetail>, Object>', + 'title' => '', + 'description' => 'PopBaseRes<SearchRes, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'HTTP request successful, status value is 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'Error Code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'Error Message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'Whether the request was successful', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '2236993B-7BE7-5F92-B179-21FF08570165'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'Correctly processed return data', + 'title' => '', + 'description' => 'The data returned for a successful request.', 'type' => 'object', 'properties' => [ - 'list' => [ - 'title' => '数据列表', - 'description' => 'Data List', + 'solution_list' => [ + 'title' => '', + 'description' => 'The search quote results.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'solution', 'type' => 'object', 'properties' => [ - 'change_order_num' => [ - 'title' => '改签单号', - 'description' => 'Change Order Number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4988430***950', - ], - 'order_num' => [ - 'title' => '订单号', - 'description' => 'Order Number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '5988430***541', - ], - 'change_passengers' => [ - 'title' => '改签的乘机人列表', - 'description' => 'List of Passengers for Change', - 'type' => 'array', - 'items' => [ - 'description' => 'Element', - 'type' => 'object', - 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger\'s First Name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger\'s Last Name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document Number', - 'type' => 'string', - 'example' => '411***********4411', - ], - ], - ], - ], - 'total_amount' => [ - 'title' => '改签单支付总金额', - 'description' => 'Total Payment Amount for Change Order', - 'type' => 'number', - 'format' => 'double', - 'example' => '300', - ], - 'order_status' => [ - 'title' => '改签单状态 0:初始状态; 1:待支付; 2:付款成功; 3:改签成功; 4:改签关闭', - 'description' => 'Change Order Status: 0: Initial State; 1: Pending Payment; 2: Payment Successful; 3: Change Successful; 4: Change Closed', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'close_reason' => [ - 'title' => '改签关单原因', - 'description' => 'Reason for Closing the Change Order', - 'type' => 'string', - 'example' => 'reason desc', - ], - 'transaction_no' => [ - 'title' => '交易流水号', - 'description' => 'Transaction number', - 'type' => 'string', - 'example' => 'hkduendkd-2023-dj0', - ], - 'change_reason_type' => [ - 'title' => '改签原因类型 0:自愿改期; 1:航班变动/航班取消; 2:因疫情改签', - 'description' => 'Change reason type 0: Voluntary change ; 1: Involuntary change due to irregular flight; 2: Involuntary change due to health reason', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'create_utc_time' => [ - 'title' => '改签单创建时间，UTC时间戳', - 'description' => 'Change order creation time, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677415276000', - ], - 'last_confirm_utc_time' => [ - 'title' => '买家最迟支付时间，UTC时间戳', - 'description' => 'Latest payment time for the buyer, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677415278000', - ], - 'pay_status' => [ - 'title' => '支付状态 0:初始状态; 1:待支付; 2:支付成功; 3:转交易成功; 4:关闭已支付订单成功; 5:关闭未支付订单成功', - 'description' => 'Payment status 0: Initial state; 1: Pending payment; 2: Payment successful; 3: Transaction successful; 4: Successfully closed paid order; 5: Successfully closed unpaid order', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'pay_success_utc_time' => [ - 'title' => '买家支付成功时间，UTC时间戳', - 'description' => 'Buyer\'s payment success time, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677415255000', - ], - 'close_utc_time' => [ - 'title' => '订单关闭时间，UTC时间戳', - 'description' => 'Order closure time, UTC timestamp', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1677415244000', - ], - 'contact' => [ - 'title' => '改签联系人信息', - 'description' => 'Contact information for the change', - 'type' => 'object', - 'properties' => [ - 'mobile_country_code' => [ - 'title' => '国家区位码', - 'description' => 'Country code', - 'type' => 'string', - 'example' => '86', - ], - 'mobile_phone_num' => [ - 'title' => '联系人用户手机号', - 'description' => 'Contact\'s mobile phone number', - 'type' => 'string', - 'example' => '183*****92', - ], - 'email' => [ - 'title' => '邮件地址', - 'description' => 'Email address', - 'type' => 'string', - 'example' => 'gao******@gmail.com', - ], - ], - ], - 'original_journeys' => [ - 'title' => '原始的行程', - 'description' => 'Original itinerary', + 'solution_id' => ['title' => '', 'description' => 'solution_id', 'type' => 'string', 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ'], + 'adult_price' => ['title' => '', 'description' => 'The unit price for an adult.', 'type' => 'number', 'format' => 'double', 'example' => '600'], + 'adult_tax' => ['title' => '', 'description' => 'The tax for an adult.', 'type' => 'number', 'format' => 'double', 'example' => '11'], + 'child_price' => ['title' => '', 'description' => 'The unit price for a child.', 'type' => 'number', 'format' => 'double', 'example' => '500'], + 'child_tax' => ['title' => '', 'description' => 'The tax for a child.', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'infant_price' => ['title' => '', 'description' => 'The unit price for an infant.', 'type' => 'number', 'format' => 'double', 'example' => '400'], + 'infant_tax' => ['title' => '', 'description' => 'The tax for an infant.', 'type' => 'number', 'format' => 'double', 'example' => '9'], + 'refund_ticket_coupon_description' => ['title' => '', 'type' => 'string', 'example' => 'description', 'description' => ''], + 'product_type_description' => ['title' => '', 'type' => 'string', 'example' => 'description', 'description' => ''], + 'journey_list' => [ + 'title' => '', + 'description' => 'The journey.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'journey', 'type' => 'object', 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'Number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], + 'transfer_count' => ['title' => '', 'description' => 'The number of transfers.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'Segment information', + 'title' => '', + 'description' => 'The segment information.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'segment', 'type' => 'object', 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'Segment ID format: flight number + departure airport + arrival airport + departure date (MMdd)', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Three-letter code of the departure airport (in uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Three-letter code of the arrival airport (in uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Three-letter code of the departure city (in uppercase)', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Three-letter code of the arrival city (in uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'Marketing flight number (e.g., HO1295)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'Marketing flight number (integer part, e.g., 1295)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'Marketing airline (e.g., HO)', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'Operating flight number (e.g., CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'Operating airline (e.g., CX)', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Departure date and time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Arrival date and time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'Whether it is a code-share flight', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'Departure terminal of the flight', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'Arrival terminal of the flight', - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'Aircraft type', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'service class ( compartment )', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数', - 'description' => 'Number of available seats', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'List of stop cities, with values when stopQuantity > 0, separated by commas', - 'type' => 'string', - 'example' => 'SEL,HKG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'Number of stop cities', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'Flight duration in minutes', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], + 'segment_id' => ['title' => '', 'description' => 'The segment ID. Format: flight number + departure airport + arrival airport + departure date (MMdd).', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'The three-letter code of the departure airport (uppercase).', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter code of the arrival airport (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'The three-letter code of the departure city (uppercase).', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'The three-letter code of the arrival city (uppercase).', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'The marketing flight number (such as KA5809).', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'The numeric marketing flight number (such as 5809).', 'type' => 'integer', 'format' => 'int32', 'example' => '1259'], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline (such as KA).', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'The operating flight number (such as CX601).', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline (such as CX).', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'The departure date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival date and time in string format (yyyy-MM-dd HH:mm:ss).', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'The aircraft type.', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'The booking class.', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'The cabin class.', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'The number of remaining seats. Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, and A. A indicates that more than 9 seats are available.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'The list of stopover cities. This parameter has a value when stopQuantity is greater than 0. Multiple values are separated by commas.', 'type' => 'string', 'example' => 'MFM,PVG'], + 'stop_quantity' => ['title' => '', 'description' => 'The number of stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'The flight duration. Unit: minutes.', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'changed_journeys' => [ - 'title' => '改签后的行程', - 'description' => 'Itinerary after change', + 'segment_baggage_mapping_list' => [ + 'title' => '', + 'description' => 'The free baggage rules.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'Number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'Segment Information', + 'segment_id_list' => [ + 'title' => '', + 'description' => 'The list of segment IDs. These segments share the same free baggage rule.', 'type' => 'array', - 'items' => [ - 'description' => 'Element', + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', + ], + 'passenger_baggage_allowance_mapping' => [ + 'title' => '', + 'description' => 'The mapping between passenger types and free baggage allowances.', + 'type' => 'object', + 'additionalProperties' => [ 'type' => 'object', 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'Segment ID format: Flight number + Departure airport + Arrival airport + Departure date (MMdd)', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Departure airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Arrival airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Departure city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Arrival city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'Marketing flight number (e.g., HO1295)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'Marketing flight number (e.g., 1295)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'Marketing airline (e.g., HO)', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'Operating flight number (e.g., CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'Operating airline (e.g., CX)', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight departure date and time, in the format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight arrival date and time, in the format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'Whether it is a codeshare flight', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'Departure terminal of the flight', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'Arrival terminal of the flight', - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'Aircraft type', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'Cabin class', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'Cabin grade', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数', - 'description' => 'Number of available seats', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'List of stop cities, present when stopQuantity > 0, multiple values separated by commas', - 'type' => 'string', - 'example' => 'SEL,HKG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'Number of stop cities', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'Flight duration in minutes', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], + 'baggage_amount' => ['title' => '', 'description' => '托运行李件数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'baggage_weight' => ['title' => '', 'description' => '托运行李重量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'baggage_weight_unit' => ['title' => '', 'description' => '托运行李重量单位KG', 'type' => 'string', 'example' => 'KG'], + 'is_all_weight' => ['title' => '', 'description' => '是否所有托运行李重量', 'type' => 'boolean', 'example' => 'true'], + 'carry_on_amount' => ['title' => '', 'description' => '手提行李件数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'carry_on_weight' => ['title' => '', 'description' => '手提行李重量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'carry_on_weight_unit' => ['title' => '', 'description' => '手提行李重量单位KG', 'type' => 'string', 'example' => 'KG'], + 'is_all_carry_on_weight' => ['title' => '', 'description' => '是否所有手提行李重量', 'type' => 'boolean', 'example' => 'true'], ], + 'description' => '免费行李额', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'last_journeys' => [ - 'title' => '上一次改签的行程', - 'description' => 'The itinerary of the last change', + 'segment_refund_change_rule_mapping_list' => [ + 'title' => '', + 'description' => 'The refund and change rules.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => 'Number of transfers', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'segment_list' => [ - 'title' => '航段信息', - 'description' => 'Segment information', + 'segment_id_list' => [ + 'title' => '', + 'description' => 'The list of segment IDs. These segments share the same refund and change rule.', 'type' => 'array', - 'items' => [ - 'description' => 'Element', + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', + ], + 'refund_change_rule_map' => [ + 'title' => '', + 'description' => 'The mapping between passenger types and refund and change rules.', + 'type' => 'object', + 'additionalProperties' => [ 'type' => 'object', 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => 'Segment ID format: flight number + departure airport + arrival airport + departure date (MMdd)', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => 'Departure airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => 'Arrival airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => 'Departure city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => 'Arrival city three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => 'Marketing flight number (e.g., HO1295)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => 'Marketing flight number (e.g., 1295)', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => 'Marketing airline (e.g., HO)', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => 'Operating flight number (e.g., CX601)', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => 'Operating airline (e.g., CX)', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight departure date and time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight arrival date and time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => 'Whether it is a codeshare flight', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => 'Departure terminal of the flight', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => 'Arrival terminal of the flight', - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => 'Aircraft type', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => 'RBD', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => 'service class ( compartment )', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数', - 'description' => 'Number of available seats', - 'type' => 'string', - 'example' => '7', + 'refund_rule_all_unused_list' => [ + 'title' => '', + 'description' => '全程未使用退票规则', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'type' => ['title' => '', 'description' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否退票', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 退票手续费', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'can_return_all_tax' => ['title' => '', 'description' => '起飞前X-Y小时(天) 是否全额退税', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可部分退税金额', 'type' => 'number', 'format' => 'double', 'example' => '100'], + ], + 'description' => '元素', + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => 'List of stop cities, present when stopQuantity > 0, multiple values separated by commas', - 'type' => 'string', - 'example' => 'SEL,HKG', + 'refund_rule_part_unused_list' => [ + 'title' => '', + 'description' => '部分未使用退票规则', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'type' => ['title' => '', 'description' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否退票', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 退票手续费', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'can_return_all_tax' => ['title' => '', 'description' => '起飞前X-Y小时(天) 是否全额退税', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可部分退税金额', 'type' => 'number', 'format' => 'double', 'example' => '20'], + ], + 'description' => '元素', + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => 'Number of stop cities', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', + 'change_rule_in_unused_list' => [ + 'title' => '', + 'description' => '回程未使用改签规则', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'type' => ['title' => '', 'description' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否可以改签', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 改签费', 'type' => 'number', 'format' => 'double', 'example' => '200'], + ], + 'description' => '元素', + 'title' => '', + 'example' => '', + ], + 'example' => '', ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => 'Flight duration in minutes', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', + 'change_rule_out_unused_list' => [ + 'title' => '', + 'description' => '去程未使用改签规则', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'type' => ['title' => '', 'description' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => '时间单位：day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => '起飞前X-Y小时(天) 可否可以改签', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => '起飞前X-Y小时(天) 改签费', 'type' => 'number', 'format' => 'double', 'example' => '200'], + ], + 'description' => '元素', + 'title' => '', + 'example' => '', + ], + 'example' => '', ], ], + 'description' => '元素', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - 'change_fee_details' => [ - 'title' => '改签费用明细 乘机人纬度', - 'description' => 'Change fee details by passenger', + 'segment_baggage_check_in_info_list' => [ + 'title' => '', + 'description' => 'The baggage through-check rules.', 'type' => 'array', 'items' => [ - 'description' => 'Element', + 'description' => 'The element.', 'type' => 'object', 'properties' => [ - 'passenger' => [ - 'title' => '改签的乘机人信息', - 'description' => 'Information of the passenger for change', - 'type' => 'object', - 'properties' => [ - 'first_name' => [ - 'title' => '乘机人名', - 'description' => 'Passenger\'s first name', - 'type' => 'string', - 'example' => 'SAN', - ], - 'last_name' => [ - 'title' => '乘机人姓', - 'description' => 'Passenger\'s last name', - 'type' => 'string', - 'example' => 'ZHANG', - ], - 'document' => [ - 'title' => '证件号', - 'description' => 'Document number', - 'type' => 'string', - 'example' => '411***********4411', - ], - ], - ], - 'change_fee' => [ - 'title' => '乘机人的改签费明细', - 'description' => 'Change fee details for the passenger', - 'type' => 'object', - 'properties' => [ - 'upgrade_fee' => [ - 'title' => '升舱费', - 'description' => 'price difference', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'service_fee' => [ - 'title' => '服务费(手续费)', - 'description' => 'fare penalty', - 'type' => 'number', - 'format' => 'double', - 'example' => '50', - ], - 'tax_fee' => [ - 'title' => '改签税费', - 'description' => 'tax difference', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - ], + 'segment_id_list' => [ + 'title' => '', + 'description' => 'The list of segment IDs. These segments share the same baggage through-check rule.', + 'type' => 'array', + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'."\n", 'title' => ''], + 'example' => '', ], + 'luggage_direct_info_type' => ['title' => '', 'description' => 'The baggage through-check rule type. Valid values: 1: baggage is checked through between segments. 2: baggage must be rechecked between segments. 3: baggage is checked through at stopover cities. 4: baggage must be rechecked at stopover cities.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], - ], - ], - ], - 'pagination' => [ - 'title' => '分页信息', - 'description' => 'Pagination information', - 'type' => 'object', - 'properties' => [ - 'total_count' => [ - 'title' => '总数量', - 'description' => 'Total count', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'total_page' => [ - 'title' => '共几页', - 'description' => 'Total pages', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'current_page' => [ - 'title' => '当前第几页', - 'description' => 'Current page number', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'page_size' => [ - 'title' => '每页数量', - 'description' => 'Number of items per page', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - ], - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Data carried in error handling', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"request_id\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"change_order_num\\": 0,\\n \\"order_num\\": 0,\\n \\"change_passengers\\": [\\n {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n }\\n ],\\n \\"total_amount\\": 300,\\n \\"order_status\\": 2,\\n \\"close_reason\\": \\"reason desc\\",\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\",\\n \\"change_reason_type\\": 1,\\n \\"create_utc_time\\": 1677415276000,\\n \\"last_confirm_utc_time\\": 1677415278000,\\n \\"pay_status\\": 2,\\n \\"pay_success_utc_time\\": 1677415255000,\\n \\"close_utc_time\\": 1677415244000,\\n \\"contact\\": {\\n \\"mobile_country_code\\": \\"86\\",\\n \\"mobile_phone_num\\": \\"183*****92\\",\\n \\"email\\": \\"gao******@gmail.com\\"\\n },\\n \\"original_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"changed_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"last_journeys\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"change_fee_details\\": [\\n {\\n \\"passenger\\": {\\n \\"first_name\\": \\"SAN\\",\\n \\"last_name\\": \\"ZHANG\\",\\n \\"document\\": \\"411***********4411\\"\\n },\\n \\"change_fee\\": {\\n \\"upgrade_fee\\": 30,\\n \\"service_fee\\": 50,\\n \\"tax_fee\\": 20\\n }\\n }\\n ]\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => '改签单列表', - 'translator' => 'machine', - ], - 'FlightChangeOfOrder' => [ - 'summary' => 'Flight Change Information - Regarding Orders', - 'path' => '/airticket/v1/flightchange/of-order', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ - [ - 'name' => 'order_num', - 'in' => 'query', - 'schema' => [ - 'title' => '订单号', - 'description' => 'Order Number', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '4966***617111', - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => 'Multi-language, default to buyer account configuration', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<List<FlightChangeOrderDTO>, Object>', - 'description' => 'PopBaseRes<List<FlightChangeOrderDTO>, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => 'HTTP request successful, status value is 200', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => 'Business error code', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => 'Error message', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => 'Whether the operation was successful', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => 'Correctly processed return data', - 'type' => 'array', - 'items' => [ - 'description' => 'Data elements', - 'type' => 'object', - 'properties' => [ - 'flight_change_detail' => [ - 'title' => '航变信息', - 'description' => 'irregular flight information', - 'type' => 'object', - 'properties' => [ - 'old_flight_no' => [ - 'title' => '原航班号', - 'description' => 'Original flight number', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'old_departure_airport' => [ - 'title' => '原航班起飞机场三字码(大写)', - 'description' => 'Original departure airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'old_arrival_airport' => [ - 'title' => '原航班到达机场三字码(大写)', - 'description' => 'Original arrival airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'old_departure_time' => [ - 'title' => '原航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Original departure date and time, string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-02-01 12:01:00', - ], - 'old_arrival_time' => [ - 'title' => '原航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Original arrival date and time, string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '023-02-01 14:01:00', - ], - 'new_flight_no' => [ - 'title' => '新航班号', - 'description' => 'New flight number', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'new_departure_airport' => [ - 'title' => '新航班起飞机场三字码(大写)', - 'description' => 'New departure airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'PVG', - ], - 'new_arrival_airport' => [ - 'title' => '新航班到达机场三字码(大写)', - 'description' => 'New arrival airport three-letter code (uppercase)', - 'type' => 'string', - 'example' => 'MFM', - ], - 'new_departure_time' => [ - 'title' => '新航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'New departure date and time, string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-02-01 13:01:00', - ], - 'new_arrival_time' => [ - 'title' => '新航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'New flight arrival date and time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-02-01 15:01:00', - ], - 'change_time' => [ - 'title' => '航变时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => 'Flight change time in string format (yyyy-MM-dd HH:mm:ss)', - 'type' => 'string', - 'example' => '2023-02-01 10:01:00', - ], - 'change_type' => [ - 'title' => '航变类型 1:取消; 2:变更', - 'description' => 'Type of irregular flight 1: Cancellation; 2: delay, schedule change, or other airline reasons', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'change_reason' => [ - 'title' => '航变原因', - 'description' => 'Reason for the irregular flight', - 'type' => 'string', - 'example' => 'weather', - ], - ], - ], - 'order_num' => [ - 'title' => '订单号', - 'description' => 'Order number', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4966***617111', - ], - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => 'Data carried with error handling', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"request_id\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": [\\n {\\n \\"flight_change_detail\\": {\\n \\"old_flight_no\\": \\"HO1295\\",\\n \\"old_departure_airport\\": \\"PVG\\",\\n \\"old_arrival_airport\\": \\"MFM\\",\\n \\"old_departure_time\\": \\"2023-02-01 12:01:00\\",\\n \\"old_arrival_time\\": \\"023-02-01 14:01:00\\",\\n \\"new_flight_no\\": \\"HO1295\\",\\n \\"new_departure_airport\\": \\"PVG\\",\\n \\"new_arrival_airport\\": \\"MFM\\",\\n \\"new_departure_time\\": \\"2023-02-01 13:01:00\\",\\n \\"new_arrival_time\\": \\"2023-02-01 15:01:00\\",\\n \\"change_time\\": \\"2023-02-01 10:01:00\\",\\n \\"change_type\\": 1,\\n \\"change_reason\\": \\"天气\\"\\n },\\n \\"order_num\\": 0\\n }\\n ],\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'FlightChangeOfOrder', - 'translator' => 'machine', - ], - 'AccountFlowList' => [ - 'summary' => 'Account Fund Flow', - 'path' => '/airticket/v1/account/flow-list', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'parameters' => [ - [ - 'name' => 'utc_begin_time', - 'in' => 'query', - 'schema' => [ - 'title' => '开始搜索时间戳具体生效到天，UTC 13位时间戳', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1677427200000', - ], - ], - [ - 'name' => 'day_num', - 'in' => 'query', - 'schema' => [ - 'title' => '搜索多少天 最大30天 取值范围[0,30]', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '0', - ], - ], - [ - 'name' => 'page_index', - 'in' => 'query', - 'schema' => [ - 'title' => '页索引', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - ], - [ - 'name' => 'page_size', - 'in' => 'query', - 'schema' => [ - 'title' => '页大小', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '20', - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<PageData<AccountFlow>, Object>', - 'description' => 'PopBaseRes<PageData<AccountFlow>, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'list' => [ - 'title' => '数据列表', - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'flow_id' => [ - 'title' => '流水ID', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1627239841225842666', - ], - 'gmt_create' => [ - 'title' => '创建时间', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1676799185000', - ], - 'gmt_modified' => [ - 'title' => '修改时间', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1676966530000', - ], - 'op_type' => [ - 'title' => '操作类型 详见BalanceOpTypeEnum， 1:付款; 2:退款; 3:充值', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'op_amount' => [ - 'title' => '操作金额(元)', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '950.5', - ], - 'before_available_amount' => [ - 'title' => '操作前可用余额(元)', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '1950.5', - ], - 'after_available_amount' => [ - 'title' => '操作后可用余额(元)', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '1000', - ], - 'order_num' => [ - 'title' => '正向订单号', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4988430***971', - ], - 'out_order_num' => [ - 'title' => '正向外部订单号', - 'type' => 'string', - 'example' => '4988430***971', - ], - 'change_order_num' => [ - 'title' => '改签单号，如果是改签的流水，这个值不为空', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '49880***971', - ], - 'refund_order_num' => [ - 'title' => '退票单号。如果是退款的流水，这个值不为空', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '48430***971', - ], - 'order_type' => [ - 'title' => '订单类型', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', + 'solution_attribute' => [ + 'title' => '', + 'description' => 'The quote attributes.', + 'type' => 'object', + 'properties' => [ + 'supply_source_type' => ['title' => '', 'description' => 'The supply source type. Valid values: 1: self-operated. 2: agent. 3: flagship store.', 'type' => 'string', 'deprecated' => false, 'example' => '1'], + ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], - ], - 'pagination' => [ - 'title' => '分页信息', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'total_count' => [ - 'title' => '总数量', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'total_page' => [ - 'title' => '共几页', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'current_page' => [ - 'title' => '当前第几页', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'page_size' => [ - 'title' => '每页数量', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - ], - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"list\\": [\\n {\\n \\"flow_id\\": 1627239841225842700,\\n \\"gmt_create\\": 1676799185000,\\n \\"gmt_modified\\": 1676966530000,\\n \\"op_type\\": 2,\\n \\"op_amount\\": 950.5,\\n \\"before_available_amount\\": 1950.5,\\n \\"after_available_amount\\": 1000,\\n \\"order_num\\": 0,\\n \\"out_order_num\\": \\"4988430***971\\",\\n \\"change_order_num\\": 0,\\n \\"refund_order_num\\": 0,\\n \\"order_type\\": 1\\n }\\n ],\\n \\"pagination\\": {\\n \\"total_count\\": 5,\\n \\"total_page\\": 1,\\n \\"current_page\\": 1,\\n \\"page_size\\": 10\\n }\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'AccountFlowList', - 'translator' => 'machine', - ], - 'FileUpload' => [ - 'summary' => 'Attachment Upload', - 'path' => '/airticket/v1/attachment/action-upload', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ - [ - 'name' => 'order_num', - 'in' => 'formData', - 'schema' => [ - 'title' => '正向订单号', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '496***2617111', - ], - ], - [ - 'name' => 'file_content', - 'in' => 'formData', - 'schema' => [ - 'title' => '附件baseRs64字符串', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => '0r2LSuIsHlxEoGZcnGe34U1njBOR83Q4HNSvMDGrDPK5J71VjcGdRIWz2x3+tFxvQaduwHB46Z9K'."\n" - .'dbIoDN8xPQ5PWlky8rKOPmAqSZfIRyPmAwvPvTJFwr8bRgHPPaq2VO8kHJ6jFIpJJ5I7Zqd1BjGS'."\n" - .'SR/kULQZHsDDd2zgA9RRTsEQF2OSxFFFx2P/2Q==', - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<UploadAttachmentRes, Object>', - 'description' => 'PopBaseRes<UploadAttachmentRes, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => '', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'uploaded_file_url' => [ - 'title' => '上传后文件名称', - 'description' => '', - 'type' => 'string', - 'example' => 'https://fliggy-flight-jinghang-bucket.oss-cn-zhangjiakou.aliyuncs.com/suez/flight_suez_9a634376****47.jpeg', - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"uploaded_file_url\\": \\"https://fliggy-flight-jinghang-bucket.oss-cn-zhangjiakou.aliyuncs.com/suez/flight_suez_9a634376****47.jpeg\\"\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'FileUpload', - 'translator' => 'machine', - ], - 'LuggageDirect' => [ - 'summary' => 'Journey Luggage Direct', - 'path' => '/airticket/v1/flight-data/luggage-direct', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'parameters' => [ - [ - 'name' => 'flight_segment_param_list', - 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'title' => '航段列表，列表中航段构成一个航程', - 'description' => '', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'departure_airport' => [ - 'title' => '出发机场三字码', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'HGH', - ], - 'arrival_airport' => [ - 'title' => '到达机场三字码', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'SIN', - ], - 'departure_terminal' => [ - 'title' => '出发航站楼', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'T1', - ], - 'arrival_terminal' => [ - 'title' => '到达航站楼', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'T1', - ], - 'departure_time' => [ - 'title' => '出发时间，13位时间戳', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1705285430445', - ], - 'arrival_time' => [ - 'title' => '到达时间，13位时间戳', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1705285430445', - ], - 'stop_city_list' => [ - 'title' => '经停城市三字码', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'SEL,HKG', - ], - 'marketing_airline' => [ - 'title' => '市场方航司', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'CZ', - ], - 'operating_airline' => [ - 'title' => '承运方航司', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'CZ', - ], - 'ticketing_airline' => [ - 'title' => '出票方航司', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'CZ', - ], - 'marketing_flight_no' => [ - 'title' => '航班号', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'CZ616', - ], - 'code_share' => [ - 'title' => '是否共享', - 'description' => '', - 'type' => 'boolean', - 'required' => true, - 'example' => 'true', - 'default' => 'false', - ], - ], - 'required' => false, - ], - 'required' => false, - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<List<LuggageDirect>, Object>', - 'description' => 'PopBaseRes<List<LuggageDirect>, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => '', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => '', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'city_code' => [ - 'title' => '城市三字码', - 'description' => '', - 'type' => 'string', - 'example' => 'BJS', - ], - 'direct_type' => [ - 'title' => '行李直挂规则类型 1:航段之间行李直达; 2:航段之间行李重新托运; 3:经停城市行李直达; 4:经停城市行李重新托运', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], - ], - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": [\\n {\\n \\"city_code\\": \\"BJS\\",\\n \\"direct_type\\": 1\\n }\\n ],\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'LuggageDirect', - 'translator' => 'machine', - ], - 'TransitVisa' => [ - 'summary' => 'Transit Visa for Journey', - 'path' => '/airticket/v1/flight-data/transit-visa', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'parameters' => [ - [ - 'name' => 'flight_segment_param_list', - 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'title' => '航段列表，列表中航段构成一个航程', - 'description' => '', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'departure_airport' => [ - 'title' => '出发机场三字码', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'HGH', - ], - 'arrival_airport' => [ - 'title' => '到达机场三字码', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'SIN', - ], - 'departure_terminal' => [ - 'title' => '出发航站楼', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'T1', - ], - 'arrival_terminal' => [ - 'title' => '到达航站楼', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'T1', - ], - 'departure_time' => [ - 'title' => '出发时间，13位时间戳', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1705285430445', - ], - 'arrival_time' => [ - 'title' => '到达时间，13位时间戳', - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1705285430445', - ], - 'stop_city_list' => [ - 'title' => '经停城市三字码', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'SEL,HKG', - ], - 'marketing_airline' => [ - 'title' => '市场方航司', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'CZ', - ], - 'operating_airline' => [ - 'title' => '承运方航司', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'CZ', - ], - 'ticketing_airline' => [ - 'title' => '出票方航司', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'CZ', - ], - 'marketing_flight_no' => [ - 'title' => '航班号', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'CZ616', - ], - 'code_share' => [ - 'title' => '是否共享', - 'description' => '', - 'type' => 'boolean', - 'required' => true, - 'example' => 'true', - 'default' => 'false', - ], - ], - 'required' => false, - ], - 'required' => false, - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<List<VisaRemark>, Object>', - 'description' => 'PopBaseRes<List<VisaRemark>, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => '', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => '', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'city_code' => [ - 'title' => '经停/中转城市三字码', - 'description' => '', - 'type' => 'string', - 'example' => 'HGH', - ], - 'visa_type' => [ - 'title' => '过境签类型，0：无需过境签，1：需要过境签', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], + 'example' => '', ], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'The data returned with the error.', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": [\\n {\\n \\"city_code\\": \\"HGH\\",\\n \\"visa_type\\": 1\\n }\\n ],\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'Transit Visa', - 'translator' => 'machine', - ], - 'CollectFlightLowestPrice' => [ - 'summary' => 'Data collection - low price flight information', - 'path' => '/airticket/v1/data-collect/flight-lowest-price', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'security' => [ - [ - 'accessTokenAuth' => [], - ], - ], - 'deprecated' => false, - 'parameters' => [ - [ - 'name' => 'lowest_price_flight_info_list', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'title' => '低价的航班信息', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'request_id' => [ - 'title' => '请求id', - 'type' => 'string', - 'example' => '123456789dacd', - ], - 'departure_city' => [ - 'title' => '出发城市', - 'type' => 'string', - 'required' => true, - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '到达城市', - 'type' => 'string', - 'required' => true, - 'example' => 'MFM', - ], - 'trip_type' => [ - 'title' => '航程类型:1表示单程；2表示往返', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '1', - ], - 'departure_date' => [ - 'title' => '出发日期 格式：yyyy-MM-dd', - 'type' => 'string', - 'required' => true, - 'example' => '2024-11-11', - ], - 'return_date' => [ - 'title' => '往返场景下，返程日期，格式：yyyy-MM-dd', - 'type' => 'string', - 'example' => '2024-11-11', - ], - 'departure_flight_number' => [ - 'title' => '去程的航班号列表，多航段用,分割', - 'type' => 'string', - 'required' => true, - 'example' => 'CA123,CA456', - ], - 'return_flight_number' => [ - 'title' => '返程的航班号列表，多航段用,分割', - 'type' => 'string', - 'example' => 'CA123,CA456', - ], - 'suez_total_price' => [ - 'title' => 'Suez 的报价,价格+税费(币种为美元)', - 'type' => 'number', - 'format' => 'double', - 'required' => true, - 'example' => '100.1', - ], - 'market_total_price' => [ - 'title' => '市场上竞品最低价,价格+税费(币种为美元)', - 'type' => 'number', - 'format' => 'double', - 'required' => true, - 'example' => '100.0', - ], - 'solution_id' => [ - 'title' => 'Search/Enrich 返回的solution_id', - 'type' => 'string', - 'required' => true, - 'example' => 'eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ', - ], - ], - ], - 'required' => true, - ], - ], - [ - 'name' => 'x-acs-airticket-access-token', - 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], - ], - [ - 'name' => 'x-acs-airticket-language', - 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PopBaseRes<LowestPriceFlightSyncRes, Object>', - 'description' => 'PopBaseRes<LowestPriceFlightSyncRes, Object>', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => '', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], - 'data' => [ - 'title' => '正确处理返回数据', - 'description' => '', - 'type' => 'object', - 'example' => 'null', - ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], - ], - ], - ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"2236993B-7BE7-5F92-B179-21FF08570165\\",\\n \\"data\\": {\\n \\"solution_list\\": [\\n {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TU7TNTFINNO1SE5O0jVKM0hKNjEwTElLNYwz0A32cNT1dfPVNTIwMjYwNjRQ8/A3NLI01Q0Ic0cRBwBVFxJJ\\",\\n \\"adult_price\\": 600,\\n \\"adult_tax\\": 11,\\n \\"child_price\\": 500,\\n \\"child_tax\\": 10,\\n \\"infant_price\\": 400,\\n \\"infant_tax\\": 9,\\n \\"refund_ticket_coupon_description\\": \\"description\\",\\n \\"product_type_description\\": \\"description\\",\\n \\"journey_list\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1259,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"MFM,PVG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"segment_baggage_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"passenger_baggage_allowance_mapping\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 1,\\n \\"baggage_weight\\": 1,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 1,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true\\n }\\n }\\n }\\n ],\\n \\"segment_refund_change_rule_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 100,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 20\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 200\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 200\\n }\\n ]\\n }\\n }\\n }\\n ],\\n \\"segment_baggage_check_in_info_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\\\n\\"\\n ],\\n \\"luggage_direct_info_type\\": 1\\n }\\n ],\\n \\"solution_attribute\\": {\\n \\"supply_source_type\\": \\"1\\"\\n }\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'Search', + 'changeSet' => [ + ['createdAt' => '2026-04-27T05:48:52.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2026-04-22T03:46:26.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2026-04-22T03:45:57.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-24T06:03:24.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-24T05:51:47.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-23T09:38:47.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-15T03:23:12.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-10-15T03:22:26.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T13:47:34.000Z', 'description' => 'Response parameters changed'], + ['createdAt' => '2025-06-16T13:45:19.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T13:20:00.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T06:40:49.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T04:09:49.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T04:09:45.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T04:09:44.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T03:47:56.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-16T01:54:11.000Z', 'description' => 'OpenAPI offline'], + ['createdAt' => '2025-06-13T06:12:56.000Z', 'description' => 'OpenAPI offline'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": null,\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', - 'title' => 'CollectFlightLowestPrice', - 'translator' => 'machine', ], 'StandardSearch' => [ - 'summary' => '标准搜索', + 'summary' => 'Search and quote prices, currently providing the lowest price across multiple flights. Note that this API response includes refund/change rules, free baggage allowance, and baggage through-check rules.', 'path' => '/airticket/v1/trade/action-standardsearch', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'accessTokenAuth' => [], @@ -11310,920 +4681,919 @@ [ 'name' => 'cabin_class', 'in' => 'formData', - 'schema' => [ - 'title' => '不填写默认为 ALL_CABIN。舱等 ALL_CABIN:不限舱等; Y:经济舱; FC:头等舱和商务舱; S:超级经济舱; YS:经济舱和超级经济舱; YSC:经济舱、超级经济舱和商务舱;', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'ALL_CABIN', - ], + 'schema' => ['title' => '', 'description' => 'Defaults to ALL_CABIN if not specified. Cabin class ALL_CABIN: All cabin classes; Y: Economy class; FC: First class and Business class; S: Premium Economy class; YS: Economy class and Premium Economy class; YSC: Economy class, Premium Economy class, and Business class;', 'type' => 'string', 'example' => 'ALL_CABIN', 'required' => false], ], [ 'name' => 'air_legs', 'in' => 'formData', 'style' => 'json', 'schema' => [ - 'title' => '行程数组 departure_city,departure_airport_list 二者至少一个不为空,departure_airport_list 有值时必须属于同一个城市; arrival_city,arrival_airport_list 二者至少一个不为空,arrival_airport_list 有值时必须属于同一个城市', - 'description' => '', + 'title' => '', + 'description' => 'Journey array. At least one of departure_city and departure_airport_list must be non-empty; when departure_airport_list has values, they must belong to the same city. At least one of arrival_city and arrival_airport_list must be non-empty; when arrival_airport_list has values, they must belong to the same city.', 'type' => 'array', 'items' => [ - 'description' => '', + 'description' => 'Journey array', 'type' => 'object', 'properties' => [ - 'departure_city' => [ - 'title' => '出发城市三字码', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '到达城市三字码', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'MFM', - ], + 'departure_city' => ['title' => '', 'description' => 'Departure city three-letter code', 'type' => 'string', 'example' => 'SHA', 'required' => false], + 'arrival_city' => ['title' => '', 'description' => 'Arrival city three-letter code', 'type' => 'string', 'example' => 'MFM', 'required' => false], 'departure_airport_list' => [ - 'title' => '出发机场三字码', - 'description' => '', + 'title' => '', + 'description' => 'Departure airport three-letter code', 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'PVG', - ], + 'items' => ['description' => 'Departure airport three-letter code', 'type' => 'string', 'required' => false, 'example' => 'PVG', 'title' => ''], 'required' => false, 'example' => 'PVG', ], 'arrival_airport_list' => [ - 'title' => '到达机场三字码', - 'description' => '', + 'title' => '', + 'description' => 'Arrival airport three-letter code', 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'MFM', - ], + 'items' => ['description' => 'Arrival airport three-letter code', 'type' => 'string', 'required' => false, 'example' => 'MFM', 'title' => ''], 'required' => false, 'example' => 'MFM', ], - 'departure_date' => [ - 'title' => '起飞日期 (eg: yyyyMMdd)', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => '20230320', - ], + 'departure_date' => ['title' => '', 'description' => 'Departure date (e.g.: yyyyMMdd)', 'type' => 'string', 'required' => true, 'example' => '20230320'], ], 'required' => false, + 'title' => '', + 'example' => '', ], 'required' => true, + 'example' => '', ], ], [ 'name' => 'adults', 'in' => 'formData', - 'schema' => [ - 'title' => '成人乘客数 1-9', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '2', - ], + 'schema' => ['title' => '', 'description' => 'Number of adult passengers, range 1-9', 'type' => 'integer', 'format' => 'int32', 'example' => '2', 'required' => false], ], [ 'name' => 'children', 'in' => 'formData', - 'schema' => [ - 'title' => '儿童乘客数 0-9', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['title' => '', 'description' => 'Number of child passengers, range 0-9', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], ], [ 'name' => 'infants', 'in' => 'formData', - 'schema' => [ - 'title' => '婴儿乘客数 0-9', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['title' => '', 'description' => 'Number of infant passengers, range 0-9', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'required' => false], ], [ 'name' => 'search_control_options', 'in' => 'formData', 'style' => 'json', 'schema' => [ - 'title' => '搜索控制项，可选', - 'description' => '', + 'title' => '', + 'description' => 'Search control options, optional', 'type' => 'object', 'properties' => [ 'airline_prefer_list' => [ - 'title' => '优选航司', - 'description' => '', + 'title' => '', + 'description' => 'Preferred airlines list', 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'required' => false, - 'example' => 'FD', - ], + 'items' => ['description' => 'Preferred airlines list', 'type' => 'string', 'required' => false, 'example' => 'FD', 'title' => ''], 'required' => false, 'example' => 'FD', ], 'airline_excluded_list' => [ - 'title' => '航司排除列表', - 'description' => '', + 'title' => '', + 'description' => 'Excluded airlines list', 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'required' => false, - 'example' => 'AK', - ], + 'items' => ['description' => 'Excluded airlines list', 'type' => 'string', 'required' => false, 'example' => 'AK', 'title' => ''], 'required' => false, 'example' => '7C', ], - 'service_quality' => [ - 'title' => '出票服务质量', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'A1', - ], + 'service_quality' => ['title' => '', 'description' => 'Ticketing service quality', 'type' => 'string', 'example' => 'A1', 'required' => false], ], 'required' => false, + 'example' => '', ], ], [ 'name' => 'x-acs-airticket-access-token', 'in' => 'header', - 'schema' => [ - 'title' => 'access_token', - 'description' => 'access_token', - 'type' => 'string', - 'required' => true, - 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii', - ], + 'schema' => ['title' => '', 'description' => 'access_token', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], ], [ 'name' => 'x-acs-airticket-language', 'in' => 'header', - 'schema' => [ - 'title' => '多语言 默认取买家账号配置', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'en_US', - ], + 'schema' => ['title' => '', 'description' => 'Language setting, defaults to buyer account configuration', 'type' => 'string', 'required' => false, 'example' => 'en_US'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PopBaseRes<StandardSearchRes, Object>', + 'title' => '', 'description' => 'PopBaseRes<StandardSearchRes, Object>', 'type' => 'object', 'properties' => [ - 'status' => [ - 'title' => 'http 请求成功，status 值均为 200', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'error_code' => [ - 'title' => '业务错误码', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'error_msg' => [ - 'title' => '错误信息', - 'description' => '', - 'type' => 'string', - 'example' => 'null', - ], - 'success' => [ - 'title' => '是否正确', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'title' => '请求 RequestId', - 'description' => '', - 'type' => 'string', - 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B', - ], + 'status' => ['title' => '', 'description' => 'When HTTP request is successful, status value is always 200', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'Business error code', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'Error message', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Whether the request is successful', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'Request ID', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], 'data' => [ - 'title' => '正确处理返回数据', - 'description' => '', + 'title' => '', + 'description' => 'Data returned on successful processing', 'type' => 'object', 'properties' => [ 'solution_list' => [ - 'title' => '搜索询价结果', - 'description' => '', + 'title' => '', + 'description' => 'Search and quote results', 'type' => 'array', 'items' => [ 'description' => 'solution', 'type' => 'object', 'properties' => [ - 'solution_id' => [ - 'title' => 'solution_id', - 'description' => 'solution_id', - 'type' => 'string', - 'example' => 'eJwz8DeySEo0NjQ01TU3TUxxx', - ], - 'adult_price' => [ - 'title' => '成人单价', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '300', - ], - 'adult_tax' => [ - 'title' => '成人税', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '30', - ], - 'child_price' => [ - 'title' => '儿童单价', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'child_tax' => [ - 'title' => '儿童税', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '20', - ], - 'infant_price' => [ - 'title' => '婴儿单价', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - 'infant_tax' => [ - 'title' => '婴儿税', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], + 'solution_id' => ['title' => '', 'description' => 'solution_id', 'type' => 'string', 'example' => 'eJwz8DeySEo0NjQ01TU3TUxxx'], + 'adult_price' => ['title' => '', 'description' => 'Adult unit price', 'type' => 'number', 'format' => 'double', 'example' => '300'], + 'adult_tax' => ['title' => '', 'description' => 'Adult tax', 'type' => 'number', 'format' => 'double', 'example' => '30'], + 'child_price' => ['title' => '', 'description' => 'Child unit price', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'child_tax' => ['title' => '', 'description' => 'Child tax', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'infant_price' => ['title' => '', 'description' => 'Infant unit price', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'infant_tax' => ['title' => '', 'description' => 'Infant tax', 'type' => 'number', 'format' => 'double', 'example' => '10'], 'journey_list' => [ - 'title' => '行程', - 'description' => '', + 'title' => '', + 'description' => 'Journey', 'type' => 'array', 'items' => [ 'description' => 'journey', 'type' => 'object', 'properties' => [ - 'transfer_count' => [ - 'title' => '中转次数', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], + 'transfer_count' => ['title' => '', 'description' => 'Number of transfers', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], 'segment_list' => [ - 'title' => '航段信息', - 'description' => '', + 'title' => '', + 'description' => 'Segment information', 'type' => 'array', 'items' => [ 'description' => 'segment', 'type' => 'object', 'properties' => [ - 'segment_id' => [ - 'title' => '航段ID 组成格式:航班号+出发机场+达到机场+起飞日期（MMdd）', - 'description' => '', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - 'departure_airport' => [ - 'title' => '航班起飞机场三字码(大写)', - 'description' => '', - 'type' => 'string', - 'example' => 'PVG', - ], - 'arrival_airport' => [ - 'title' => '航班到达机场三字码(大写)', - 'description' => '', - 'type' => 'string', - 'example' => 'MFM', - ], - 'departure_city' => [ - 'title' => '航班起飞城市三字码(大写)', - 'description' => '', - 'type' => 'string', - 'example' => 'SHA', - ], - 'arrival_city' => [ - 'title' => '航班到达城市三字码(大写)', - 'description' => '', - 'type' => 'string', - 'example' => 'MFM', - ], - 'marketing_flight_no' => [ - 'title' => '市场方航班号(如：HO1295)', - 'description' => '', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'marketing_flight_no_int' => [ - 'title' => '市场方数字航班号（如：1295）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1295', - ], - 'marketing_airline' => [ - 'title' => '市场方航司(如：HO)', - 'description' => '', - 'type' => 'string', - 'example' => 'HO', - ], - 'operating_flight_no' => [ - 'title' => '承运方航班号(如：CX601)', - 'description' => '', - 'type' => 'string', - 'example' => 'HO1295', - ], - 'operating_airline' => [ - 'title' => '承运方航司(如：CX)', - 'description' => '', - 'type' => 'string', - 'example' => 'HO', - ], - 'departure_time' => [ - 'title' => '航班起飞日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => '', - 'type' => 'string', - 'example' => '2023-03-10 07:55:00', - ], - 'arrival_time' => [ - 'title' => '航班到达日期时间 字符串格式(yyyy-MM-dd HH:mm:ss)', - 'description' => '', - 'type' => 'string', - 'example' => '2023-03-10 10:40:00', - ], - 'code_share' => [ - 'title' => '是否为共享航班', - 'description' => '', - 'type' => 'boolean', - 'example' => 'false', - ], - 'departure_terminal' => [ - 'title' => '航班出发航站楼', - 'description' => '', - 'type' => 'string', - 'example' => 'T2', - ], - 'arrival_terminal' => [ - 'title' => '航班到达航站楼', - 'description' => '', - 'type' => 'string', - 'example' => 'T1', - ], - 'equip_type' => [ - 'title' => '机型', - 'description' => '', - 'type' => 'string', - 'example' => '32Q', - ], - 'cabin' => [ - 'title' => '舱位', - 'description' => '', - 'type' => 'string', - 'example' => 'V', - ], - 'cabin_class' => [ - 'title' => '舱等', - 'description' => '', - 'type' => 'string', - 'example' => 'Y', - ], - 'availability' => [ - 'title' => '剩余座位数。取值范围 1,2,3,4,5,6,7,8,9,A；A 表示余座大于9。', - 'description' => '', - 'type' => 'string', - 'example' => '7', - ], - 'stop_city_list' => [ - 'title' => '经停城市列表，stopQuantity > 0 时有值，多个用逗号分割', - 'description' => '', - 'type' => 'string', - 'example' => 'SEL,HKG', - ], - 'stop_quantity' => [ - 'title' => '经停城市数目', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'flight_duration' => [ - 'title' => '飞行时间 单位：分钟', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '165', - ], + 'segment_id' => ['title' => '', 'description' => 'Segment ID, format: flight number + departure airport + arrival airport + departure date (MMdd)', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310'], + 'departure_airport' => ['title' => '', 'description' => 'Flight departure airport three-letter code (uppercase)', 'type' => 'string', 'example' => 'PVG'], + 'arrival_airport' => ['title' => '', 'description' => 'Flight arrival airport three-letter code (uppercase)', 'type' => 'string', 'example' => 'MFM'], + 'departure_city' => ['title' => '', 'description' => 'Flight departure city three-letter code (uppercase)', 'type' => 'string', 'example' => 'SHA'], + 'arrival_city' => ['title' => '', 'description' => 'Flight arrival city three-letter code (uppercase)', 'type' => 'string', 'example' => 'MFM'], + 'marketing_flight_no' => ['title' => '', 'description' => 'Marketing flight number (e.g.: HO1295)', 'type' => 'string', 'example' => 'HO1295'], + 'marketing_flight_no_int' => ['title' => '', 'description' => 'Marketing flight number in integer format (e.g.: 1295)', 'type' => 'integer', 'format' => 'int32', 'example' => '1295'], + 'marketing_airline' => ['title' => '', 'description' => 'Marketing airline (e.g.: HO)', 'type' => 'string', 'example' => 'HO'], + 'operating_flight_no' => ['title' => '', 'description' => 'Operating flight number (e.g.: CX601)', 'type' => 'string', 'example' => 'HO1295'], + 'operating_airline' => ['title' => '', 'description' => 'Operating airline (e.g.: CX)', 'type' => 'string', 'example' => 'HO'], + 'departure_time' => ['title' => '', 'description' => 'Flight departure date and time, string format (yyyy-MM-dd HH:mm:ss)', 'type' => 'string', 'example' => '2023-03-10 07:55:00'], + 'arrival_time' => ['title' => '', 'description' => 'Flight arrival date and time, string format (yyyy-MM-dd HH:mm:ss)', 'type' => 'string', 'example' => '2023-03-10 10:40:00'], + 'code_share' => ['title' => '', 'description' => 'Whether it is a codeshare flight', 'type' => 'boolean', 'example' => 'false'], + 'departure_terminal' => ['title' => '', 'description' => 'Flight departure terminal', 'type' => 'string', 'example' => 'T2'], + 'arrival_terminal' => ['title' => '', 'description' => 'Flight arrival terminal', 'type' => 'string', 'example' => 'T1'], + 'equip_type' => ['title' => '', 'description' => 'Aircraft type', 'type' => 'string', 'example' => '32Q'], + 'cabin' => ['title' => '', 'description' => 'Cabin', 'type' => 'string', 'example' => 'V'], + 'cabin_class' => ['title' => '', 'description' => 'Cabin class', 'type' => 'string', 'example' => 'Y'], + 'availability' => ['title' => '', 'description' => 'Remaining seat count. Value range: 1,2,3,4,5,6,7,8,9,A; A indicates more than 9 seats available.', 'type' => 'string', 'example' => '7'], + 'stop_city_list' => ['title' => '', 'description' => 'Stopover city list, has values when stopQuantity > 0, multiple values separated by commas', 'type' => 'string', 'example' => 'SEL,HKG'], + 'stop_quantity' => ['title' => '', 'description' => 'Number of stopover cities', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'flight_duration' => ['title' => '', 'description' => 'Flight duration, unit: minutes', 'type' => 'integer', 'format' => 'int32', 'example' => '165'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'segment_baggage_mapping_list' => [ - 'title' => '免费行李规则', - 'description' => '', + 'title' => '', + 'description' => 'Free baggage allowance rules', 'type' => 'array', 'items' => [ - 'description' => '', + 'description' => 'Element', 'type' => 'object', 'properties' => [ 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个免费行李规则', - 'description' => '', + 'title' => '', + 'description' => 'Segment ID list. These segment IDs share the same free baggage allowance rule', 'type' => 'array', - 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', ], 'passenger_baggage_allowance_mapping' => [ - 'title' => '乘客类型-免费行李额映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => '', + 'title' => '', + 'description' => 'Passenger type to free baggage allowance mapping. Key values: ADT: Adult; CHD: Child; INF: Infant', 'type' => 'object', 'additionalProperties' => [ 'type' => 'object', 'properties' => [ - 'baggage_amount' => [ - 'title' => '托运行李件数', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'baggage_weight' => [ - 'title' => '托运行李重量', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'baggage_weight_unit' => [ - 'title' => '托运行李重量单位 KG', - 'description' => '', - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_weight' => [ - 'title' => '是否所有托运行李重量', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_on_amount' => [ - 'title' => '手提行李件数', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'carry_on_weight' => [ - 'title' => '手提行李重量', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'carry_on_weight_unit' => [ - 'title' => '手提行李重量单位 KG', - 'description' => '', - 'type' => 'string', - 'example' => 'KG', - ], - 'is_all_carry_on_weight' => [ - 'title' => '是否所有手提行李重量', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'carry_length' => [ - 'title' => '手提长（单位：厘米）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '55', - ], - 'carry_width' => [ - 'title' => '手提宽（单位：厘米）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'carry_height' => [ - 'title' => '手提高（单位：厘米）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'carry_sum_of_length_width_height' => [ - 'title' => '手提三边之和（单位：厘米）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '115', - ], - 'length' => [ - 'title' => '托运长（单位：厘米）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'width' => [ - 'title' => '托运宽（单位：厘米）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '40', - ], - 'height' => [ - 'title' => '托运高（单位：厘米）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '60', - ], - 'sum_of_length_width_height' => [ - 'title' => '托运三边之和（单位：厘米）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], + 'baggage_amount' => ['title' => '', 'description' => 'Number of checked baggage pieces', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'baggage_weight' => ['title' => '', 'description' => 'Checked baggage weight', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'baggage_weight_unit' => ['title' => '', 'description' => 'Checked baggage weight unit: KG', 'type' => 'string', 'example' => 'KG'], + 'is_all_weight' => ['title' => '', 'description' => 'Whether it is the total checked baggage weight', 'type' => 'boolean', 'example' => 'true'], + 'carry_on_amount' => ['title' => '', 'description' => 'Number of carry-on baggage pieces', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'carry_on_weight' => ['title' => '', 'description' => 'Carry-on baggage weight', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'carry_on_weight_unit' => ['title' => '', 'description' => 'Carry-on baggage weight unit: KG', 'type' => 'string', 'example' => 'KG'], + 'is_all_carry_on_weight' => ['title' => '', 'description' => 'Whether it is the total carry-on baggage weight', 'type' => 'boolean', 'example' => 'true'], + 'carry_length' => ['title' => '', 'description' => 'Carry-on length (unit: cm)', 'type' => 'integer', 'format' => 'int32', 'example' => '55'], + 'carry_width' => ['title' => '', 'description' => 'Carry-on width (unit: cm)', 'type' => 'integer', 'format' => 'int32', 'example' => '40'], + 'carry_height' => ['title' => '', 'description' => 'Carry-on height (unit: cm)', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'carry_sum_of_length_width_height' => ['title' => '', 'description' => 'Carry-on sum of three dimensions (unit: cm)', 'type' => 'integer', 'format' => 'int32', 'example' => '115'], + 'length' => ['title' => '', 'description' => 'Checked baggage length (unit: cm)', 'type' => 'integer', 'format' => 'int32', 'example' => '60'], + 'width' => ['title' => '', 'description' => 'Checked baggage width (unit: cm)', 'type' => 'integer', 'format' => 'int32', 'example' => '40'], + 'height' => ['title' => '', 'description' => 'Checked baggage height (unit: cm)', 'type' => 'integer', 'format' => 'int32', 'example' => '60'], + 'sum_of_length_width_height' => ['title' => '', 'description' => 'Checked baggage sum of three dimensions (unit: cm)', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], ], - 'description' => '', + 'description' => 'Passenger type to free baggage allowance mapping', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'segment_refund_change_rule_mapping_list' => [ - 'title' => '退改签规则', - 'description' => '', + 'title' => '', + 'description' => 'Refund and change rules', 'type' => 'array', 'items' => [ - 'description' => '', + 'description' => 'Element', 'type' => 'object', 'properties' => [ 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个退改签规则', - 'description' => '', + 'title' => '', + 'description' => 'Segment ID list. These segment IDs share the same refund and change rule', 'type' => 'array', - 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', ], 'refund_change_rule_map' => [ - 'title' => '乘机人类型-退改签规则映射关系 key 取值描述 ADT:普通成人; CHD:儿童; INF:婴儿', - 'description' => '', + 'title' => '', + 'description' => 'Passenger type to refund and change rule mapping. Key values: ADT: Adult; CHD: Child; INF: Infant', 'type' => 'object', 'additionalProperties' => [ 'type' => 'object', 'properties' => [ 'refund_rule_all_unused_list' => [ - 'title' => '全程未使用退票规则', - 'description' => '', + 'title' => '', + 'description' => 'Refund rules for entirely unused tickets', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => '', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => 'Usage type applicable to this refund rule. 0: Entirely unused; 1: Partially unused', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => 'Time unit: day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => 'Start time of the refund time range applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => 'End time of the refund time range applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => 'Whether refund is allowed X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => 'Refund fee X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'can_return_all_tax' => ['title' => '', 'description' => 'Whether full tax refund is available X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => 'Partial tax refund amount X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'refund_rule_part_unused_list' => [ - 'title' => '部分未使用退票规则', - 'description' => '', + 'title' => '', + 'description' => 'Refund rules for partially unused tickets', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该退票规则适用航程使用类型 0:全程未使用; 1:部分未使用', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => '', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_refund' => [ - 'title' => '起飞前X-Y小时(天) 可否退票', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'refund_fee' => [ - 'title' => '起飞前X-Y小时(天) 退票手续费', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '200', - ], - 'can_return_all_tax' => [ - 'title' => '起飞前X-Y小时(天) 是否全额退税', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'return_part_tax_fee' => [ - 'title' => '起飞前X-Y小时(天) 可部分退税金额', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => 'Usage type applicable to this refund rule. 0: Entirely unused; 1: Partially unused', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'time_unit' => ['title' => '', 'description' => 'Time unit: day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => 'Start time of the refund time range applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => 'End time of the refund time range applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_refund' => ['title' => '', 'description' => 'Whether refund is allowed X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'refund_fee' => ['title' => '', 'description' => 'Refund fee X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '200'], + 'can_return_all_tax' => ['title' => '', 'description' => 'Whether full tax refund is available X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'return_part_tax_fee' => ['title' => '', 'description' => 'Partial tax refund amount X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'change_rule_in_unused_list' => [ - 'title' => '回程未使用改签规则', - 'description' => '', + 'title' => '', + 'description' => 'Change rules for unused return trip', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => '', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => 'Usage type applicable to this change rule. 2: Outbound unused; 3: Return unused', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => 'Time unit: day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => 'Start time of the refund time range applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => 'End time of the refund time range applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => 'Whether change is allowed X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => 'Change fee X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'change_rule_out_unused_list' => [ - 'title' => '去程未使用改签规则', - 'description' => '', + 'title' => '', + 'description' => 'Change rules for unused outbound trip', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'type' => [ - 'title' => '该改签规则适用航程使用类型 2:去程未使用; 3:回程未使用', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'time_unit' => [ - 'title' => '时间单位：day/hour', - 'description' => '', - 'type' => 'string', - 'example' => 'hour', - ], - 'rule_start_time' => [ - 'title' => '该退票规则适用于的退票时间区间开始时间，单位（天/小时）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '36', - ], - 'rule_end_time' => [ - 'title' => '该退票规则适用于的退票时间区间结束时间，单位（天/小时）', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - ], - 'can_change' => [ - 'title' => '起飞前X-Y小时(天) 可否可以改签', - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - 'change_fee' => [ - 'title' => '起飞前X-Y小时(天) 改签费', - 'description' => '', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], + 'type' => ['title' => '', 'description' => 'Usage type applicable to this change rule. 2: Outbound unused; 3: Return unused', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'time_unit' => ['title' => '', 'description' => 'Time unit: day/hour', 'type' => 'string', 'example' => 'hour'], + 'rule_start_time' => ['title' => '', 'description' => 'Start time of the refund time range applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '36'], + 'rule_end_time' => ['title' => '', 'description' => 'End time of the refund time range applicable to this refund rule, unit (day/hour)', 'type' => 'integer', 'format' => 'int32', 'example' => '12'], + 'can_change' => ['title' => '', 'description' => 'Whether change is allowed X-Y hours (days) before departure', 'type' => 'boolean', 'example' => 'true'], + 'change_fee' => ['title' => '', 'description' => 'Change fee X-Y hours (days) before departure', 'type' => 'number', 'format' => 'double', 'example' => '100'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], - 'description' => '', + 'description' => 'Passenger type to refund and change rule mapping', + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'segment_baggage_check_in_info_list' => [ - 'title' => '行李直挂规则', - 'description' => '', + 'title' => '', + 'description' => 'Baggage through-check rules', 'type' => 'array', 'items' => [ - 'description' => '', + 'description' => 'Element', 'type' => 'object', 'properties' => [ 'segment_id_list' => [ - 'title' => '航段ID列表 这些航段ID使用同一个行李直挂规则', - 'description' => '', + 'title' => '', + 'description' => 'Segment ID list. These segment IDs share the same baggage through-check rule', 'type' => 'array', - 'items' => [ - 'description' => 'segment_id', - 'type' => 'string', - 'example' => 'HO1295-PVG-MFM-20230310', - ], - ], - 'luggage_direct_info_type' => [ - 'title' => '行李直挂规则类型 1:航段之间行李直达; 2:航段之间行李重新托运; 3:经停城市行李直达; 4:经停城市行李重新托运', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', + 'items' => ['description' => 'segment_id', 'type' => 'string', 'example' => 'HO1295-PVG-MFM-20230310', 'title' => ''], + 'example' => '', ], + 'luggage_direct_info_type' => ['title' => '', 'description' => 'Baggage through-check rule type. 1: Baggage direct transfer between segments; 2: Baggage re-check between segments; 3: Baggage direct transfer at stopover city; 4: Baggage re-check at stopover city', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], 'solution_attribute' => [ - 'title' => '报价属性', - 'description' => '', + 'title' => '', + 'description' => 'Quote attributes', 'type' => 'object', 'properties' => [ - 'supply_source_type' => [ - 'title' => '供给来源类型 1:自营;2:代理人;3:旗舰店', - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], + 'supply_source_type' => ['title' => '', 'description' => 'Supply source type. 1: Self-operated; 2: Agent; 3: Flagship store', 'type' => 'string', 'example' => '1'], 'issue_time_info' => [ - 'title' => '出票时效相关', - 'description' => '', + 'title' => '', + 'description' => 'Ticketing time information', 'type' => 'object', 'properties' => [ - 'issue_time_limit' => [ - 'title' => '预计出票时长，单位：分钟', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - ], - 'issue_ticket_type' => [ - 'title' => '出票类型 1:支付后; 2起飞前；-1未知', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - ], + 'issue_time_limit' => ['title' => '', 'description' => 'Estimated ticketing duration, unit: minutes', 'type' => 'integer', 'format' => 'int32', 'example' => '60'], + 'issue_ticket_type' => ['title' => '', 'description' => 'Ticketing type. 1: After payment; 2: Before departure; -1: Unknown', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], + 'example' => '', ], ], + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'example' => '', ], ], + 'example' => '', ], - 'error_data' => [ - 'title' => '错误处理携带数据', - 'description' => '', - 'type' => 'any', - 'example' => 'null', - ], + 'error_data' => ['title' => '', 'description' => 'Data carried with error handling', 'type' => 'any', 'example' => 'null'], ], + 'example' => '', ], ], ], + 'title' => 'StandardSearch', + 'changeSet' => [], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"solution_list\\": [\\n {\\n \\"solution_id\\": \\"eJwz8DeySEo0NjQ01TU3TUxxx\\",\\n \\"adult_price\\": 300,\\n \\"adult_tax\\": 30,\\n \\"child_price\\": 200,\\n \\"child_tax\\": 20,\\n \\"infant_price\\": 100,\\n \\"infant_tax\\": 10,\\n \\"journey_list\\": [\\n {\\n \\"transfer_count\\": 0,\\n \\"segment_list\\": [\\n {\\n \\"segment_id\\": \\"HO1295-PVG-MFM-20230310\\",\\n \\"departure_airport\\": \\"PVG\\",\\n \\"arrival_airport\\": \\"MFM\\",\\n \\"departure_city\\": \\"SHA\\",\\n \\"arrival_city\\": \\"MFM\\",\\n \\"marketing_flight_no\\": \\"HO1295\\",\\n \\"marketing_flight_no_int\\": 1295,\\n \\"marketing_airline\\": \\"HO\\",\\n \\"operating_flight_no\\": \\"HO1295\\",\\n \\"operating_airline\\": \\"HO\\",\\n \\"departure_time\\": \\"2023-03-10 07:55:00\\",\\n \\"arrival_time\\": \\"2023-03-10 10:40:00\\",\\n \\"code_share\\": false,\\n \\"departure_terminal\\": \\"T2\\",\\n \\"arrival_terminal\\": \\"T1\\",\\n \\"equip_type\\": \\"32Q\\",\\n \\"cabin\\": \\"V\\",\\n \\"cabin_class\\": \\"Y\\",\\n \\"availability\\": \\"7\\",\\n \\"stop_city_list\\": \\"SEL,HKG\\",\\n \\"stop_quantity\\": 0,\\n \\"flight_duration\\": 165\\n }\\n ]\\n }\\n ],\\n \\"segment_baggage_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"passenger_baggage_allowance_mapping\\": {\\n \\"key\\": {\\n \\"baggage_amount\\": 1,\\n \\"baggage_weight\\": 10,\\n \\"baggage_weight_unit\\": \\"KG\\",\\n \\"is_all_weight\\": true,\\n \\"carry_on_amount\\": 1,\\n \\"carry_on_weight\\": 5,\\n \\"carry_on_weight_unit\\": \\"KG\\",\\n \\"is_all_carry_on_weight\\": true,\\n \\"carry_length\\": 55,\\n \\"carry_width\\": 40,\\n \\"carry_height\\": 20,\\n \\"carry_sum_of_length_width_height\\": 115,\\n \\"length\\": 60,\\n \\"width\\": 40,\\n \\"height\\": 60,\\n \\"sum_of_length_width_height\\": 200\\n }\\n }\\n }\\n ],\\n \\"segment_refund_change_rule_mapping_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"refund_change_rule_map\\": {\\n \\"key\\": {\\n \\"refund_rule_all_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"refund_rule_part_unused_list\\": [\\n {\\n \\"type\\": 0,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_refund\\": true,\\n \\"refund_fee\\": 200,\\n \\"can_return_all_tax\\": true,\\n \\"return_part_tax_fee\\": 100\\n }\\n ],\\n \\"change_rule_in_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ],\\n \\"change_rule_out_unused_list\\": [\\n {\\n \\"type\\": 2,\\n \\"time_unit\\": \\"hour\\",\\n \\"rule_start_time\\": 36,\\n \\"rule_end_time\\": 12,\\n \\"can_change\\": true,\\n \\"change_fee\\": 100\\n }\\n ]\\n }\\n }\\n }\\n ],\\n \\"segment_baggage_check_in_info_list\\": [\\n {\\n \\"segment_id_list\\": [\\n \\"HO1295-PVG-MFM-20230310\\"\\n ],\\n \\"luggage_direct_info_type\\": 1\\n }\\n ],\\n \\"solution_attribute\\": {\\n \\"supply_source_type\\": \\"1\\",\\n \\"issue_time_info\\": {\\n \\"issue_time_limit\\": 60,\\n \\"issue_ticket_type\\": 1\\n }\\n }\\n }\\n ]\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', ], + 'Ticketing' => [ + 'summary' => 'Pays for and issues a ticket.', + 'path' => '/airticket/v1/trade/action-ticketing', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'parameters' => [ + [ + 'name' => 'order_num', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '496***2617111'], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. The buyer account configuration is used by default.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'PopBaseRes<TicketingRes, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '496***2617111'."\n"], + 'transaction_no' => ['title' => '', 'description' => 'The transaction number.', 'type' => 'string', 'example' => 'hkduendkd-2023-dj0'], + ], + 'example' => '', + ], + 'error_data' => ['title' => '', 'description' => 'The data returned for a failed request.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_num\\": 0,\\n \\"transaction_no\\": \\"hkduendkd-2023-dj0\\"\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'Ticketing', + 'changeSet' => [ + ['createdAt' => '2025-09-29T07:26:39.000Z', 'description' => 'OpenAPI offline'], + ], + ], + 'TicketingCheck' => [ + 'summary' => 'Performs a pre-ticketing check. This operation is optional.', + 'path' => '/airticket/v1/trade/action-ticketing-check', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'parameters' => [ + [ + 'name' => 'order_num', + 'in' => 'formData', + 'schema' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '496***2617111'], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'access_token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'PopBaseRes<TicketingCheckRes, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request is successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'object', + 'properties' => [ + 'order_num' => ['title' => '', 'description' => 'The order number.', 'type' => 'integer', 'format' => 'int64', 'example' => '496***2617111'], + ], + 'example' => '', + ], + 'error_data' => ['title' => '', 'description' => 'The data returned for a failed request.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": {\\n \\"order_num\\": 0\\n },\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'TicketingCheck', + 'description' => 'Performs a pre-ticketing check. This operation is optional.', + 'changeSet' => [], + ], + 'TransitVisa' => [ + 'summary' => 'Queries transit visa requirements for a flight itinerary. You provide flight information, and the API returns whether a transit visa is required for the itinerary. Only transfer or stopover segments are valid input parameters (transfers or stopovers passing through a third country). The supported passenger type defaults to Chinese mainland travelers.', + 'path' => '/airticket/v1/flight-data/transit-visa', + 'methods' => ['get'], + 'schemes' => ['https', 'http'], + 'security' => [ + [ + 'accessTokenAuth' => [], + ], + ], + 'deprecated' => false, + 'parameters' => [ + [ + 'name' => 'flight_segment_param_list', + 'in' => 'query', + 'style' => 'json', + 'schema' => [ + 'title' => '', + 'description' => 'The list of flight segments that constitute an itinerary. Maximum size: 2.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'departure_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the departure airport.', 'type' => 'string', 'required' => true, 'example' => 'HGH'], + 'arrival_airport' => ['title' => '', 'description' => 'The three-letter IATA code of the arrival airport.', 'type' => 'string', 'required' => true, 'example' => 'SIN'], + 'departure_terminal' => ['title' => '', 'description' => 'The departure terminal.', 'type' => 'string', 'example' => 'T1', 'required' => false], + 'arrival_terminal' => ['title' => '', 'description' => 'The arrival terminal.', 'type' => 'string', 'example' => 'T1', 'required' => false], + 'departure_time' => ['title' => '', 'description' => 'The departure time. A 13-digit UNIX timestamp.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1705285430445'], + 'arrival_time' => ['title' => '', 'description' => 'The arrival time. A 13-digit UNIX timestamp.', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1705285430445'], + 'stop_city_list' => ['title' => '', 'description' => 'The three-letter IATA codes of stopover cities.', 'type' => 'string', 'example' => 'SEL,HKG', 'required' => false], + 'marketing_airline' => ['title' => '', 'description' => 'The marketing airline.', 'type' => 'string', 'required' => true, 'example' => 'CZ'], + 'operating_airline' => ['title' => '', 'description' => 'The operating airline.', 'type' => 'string', 'example' => 'CZ', 'required' => false], + 'ticketing_airline' => ['title' => '', 'description' => 'The ticketing airline.', 'type' => 'string', 'example' => 'CZ', 'required' => false], + 'marketing_flight_no' => ['title' => '', 'description' => 'The flight number.', 'type' => 'string', 'required' => true, 'example' => 'CZ616'], + 'code_share' => ['title' => '', 'description' => 'Indicates whether the flight is a codeshare flight.', 'type' => 'boolean', 'required' => true, 'example' => 'true', 'default' => 'false'], + ], + 'required' => false, + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'required' => false, + 'example' => '', + ], + ], + [ + 'name' => 'x-acs-airticket-access-token', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The access token.', 'type' => 'string', 'required' => true, 'example' => 'eyJhbGciOiJSUzI1NiIsImtpZCI6InN1ZXpfa2V5aWQifQ.eyJqdGkiOiJCQldMaWIzN0VxbC0xMjhhR2N5elJ3IiwiaWF0IjoxNjc3MDY2NTAxLCJleHAiOjE2NzcwNzM3MDEsIm5iZiI6MTY3NzA2NjQ0MX0.AF0DxsZK4Edyg0C6ObRQFUo36R1VYrb5IYmak25TmL1OfR5RkIUc3PpqFuQKNLKXf5fOtVQaKjaexzwodVeWZQDKEG_RPt_Ybb99EnEm6vPKs6e3pWFbKiBq71WleLHhVrdFb4YPowRKjc7bG0jyGUxiQ2iXy0RWDj9tIjfI-KEdzNp5oVnX7j4p3H12DwQrRPmd1nz3BciAQNINvDpzqusuIUw8JXyLFCz838Y0NhwB1_bYZyctxRLSzrGZuI5rrWtItgupqMsOlJ3RNy1QrIbQ2g6nPmzl-atOqcQ4Nw0HeDLR8dhM1OsIcFLbKXBUtwXofflhzAQrkDxhwYiXii'], + ], + [ + 'name' => 'x-acs-airticket-language', + 'in' => 'header', + 'schema' => ['title' => '', 'description' => 'The language. Defaults to the buyer account configuration.', 'type' => 'string', 'required' => false, 'example' => 'en_US'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'PopBaseRes<List<VisaRemark>, Object>', + 'type' => 'object', + 'properties' => [ + 'status' => ['title' => '', 'description' => 'The HTTP status code. The value is always 200 for successful HTTP requests.', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'error_code' => ['title' => '', 'description' => 'The business error code.', 'type' => 'string', 'example' => 'null'], + 'error_msg' => ['title' => '', 'description' => 'The error message.', 'type' => 'string', 'example' => 'null'], + 'success' => ['title' => '', 'description' => 'Indicates whether the request was successful.', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['title' => '', 'description' => 'The request ID.', 'type' => 'string', 'example' => '51593418-8C73-5E47-8BA8-3F1D4A00CC0B'], + 'data' => [ + 'title' => '', + 'description' => 'The data returned for a successful request.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'city_code' => ['title' => '', 'description' => 'The three-letter IATA code of the stopover or transfer city.', 'type' => 'string', 'example' => 'HGH'], + 'visa_type' => ['title' => '', 'description' => 'The transit visa type. Valid values:'."\n" + .'- 0: no transit visa required.'."\n" + .'- 1: transit visa required.', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'example' => '', + ], + 'error_data' => ['title' => '', 'description' => 'The data returned with an error response.', 'type' => 'any', 'example' => 'null'], + ], + 'example' => '', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": 200,\\n \\"error_code\\": \\"null\\",\\n \\"error_msg\\": \\"null\\",\\n \\"success\\": true,\\n \\"RequestId\\": \\"51593418-8C73-5E47-8BA8-3F1D4A00CC0B\\",\\n \\"data\\": [\\n {\\n \\"city_code\\": \\"HGH\\",\\n \\"visa_type\\": 1\\n }\\n ],\\n \\"error_data\\": \\"null\\"\\n}","type":"json"}]', + 'title' => 'TransitVisa', + 'description' => 'Queries transit visa requirements for a flight itinerary. You provide flight information, and the API returns whether a transit visa is required for the itinerary. Only transfer or stopover segments are valid input parameters (transfers or stopovers passing through a third country). The supported passenger type defaults to Chinese mainland travelers.', + 'changeSet' => [], + ], ], 'endpoints' => [], + 'errorCodes' => [], + 'changeSet' => [ + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2026-04-27T05:48:52.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2026-04-22T03:46:26.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Pricing'], + ['description' => 'OpenAPI offline', 'api' => 'OrderDetail'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-11-18T06:20:03.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Pricing'], + ['description' => 'OpenAPI offline', 'api' => 'OrderDetail'], + ], + 'createdAt' => '2025-11-18T06:10:43.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Pricing'], + ['description' => 'OpenAPI offline', 'api' => 'OrderDetail'], + ], + 'createdAt' => '2025-11-12T04:01:07.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Pricing'], + ['description' => 'OpenAPI offline', 'api' => 'OrderDetail'], + ], + 'createdAt' => '2025-11-12T03:58:52.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Pricing'], + ['description' => 'OpenAPI offline', 'api' => 'OrderDetail'], + ], + 'createdAt' => '2025-11-12T03:58:45.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-11-06T09:10:48.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-11-06T03:52:32.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-11-04T11:41:35.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'OrderDetail'], + ['description' => 'OpenAPI offline', 'api' => 'Pricing'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Pricing'], + ['description' => 'OpenAPI offline', 'api' => 'OrderDetail'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-10-24T05:51:47.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'OrderDetail'], + ['description' => 'OpenAPI offline', 'api' => 'Pricing'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Pricing'], + ['description' => 'OpenAPI offline', 'api' => 'OrderDetail'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-10-24T05:51:47.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'ChangeConfirm'], + ['description' => 'OpenAPI offline', 'api' => 'Ticketing'], + ['description' => 'OpenAPI offline', 'api' => 'Book'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-09-29T07:26:39.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'ChangeConfirm'], + ['description' => 'OpenAPI offline', 'api' => 'Ticketing'], + ['description' => 'OpenAPI offline', 'api' => 'Book'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-09-29T07:26:39.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-07-08T02:11:20.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-07-08T02:10:43.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'Response parameters changed', 'api' => 'Enrich'], + ['description' => 'Response parameters changed', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-16T13:47:34.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'Response parameters changed', 'api' => 'Enrich'], + ['description' => 'Response parameters changed', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-16T13:47:33.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-06-16T13:45:19.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-06-16T13:45:19.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-16T13:20:00.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-16T13:20:00.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-06-16T06:40:49.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-16T04:09:49.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-16T04:09:45.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-16T04:09:45.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-16T04:09:44.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-16T04:09:44.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-06-16T03:47:56.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ['description' => 'OpenAPI offline', 'api' => 'Enrich'], + ], + 'createdAt' => '2025-06-16T01:54:11.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'Search'], + ], + 'createdAt' => '2025-06-13T06:12:56.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI offline', 'api' => 'ChangeApply'], + ], + 'createdAt' => '2025-05-08T09:47:18.000Z', + 'description' => '', + ], + ], ]; |