@gojinko/api-client 2.26.0 → 2.28.0

package/public-api.yaml

@@ -1,10 +1,10 @@
-# synced from jinko-api@558277d11f0dc4707c3e6bf121a97ddf60b12a77 (558277d1)
+# synced from jinko-api@c46664fb52f2597644c841a14abe5a1eb80cee21 (c46664fb)
 # Vendored copy of the canonical public contract. Do not hand-edit: change it in
 # jinko-api, then `pnpm sync:api-spec <ref>` here, which also runs `pnpm generate:api-types`.
 openapi: 3.0.0
 info:
   title: Jinko Public API
-  version: 0.11.0
+  version: 0.10.0
   description: >-
     Curated public REST surface for Jinko. Authenticated with jnk_ API keys. See
     https://docs.gojinko.com for guides.
@@ -458,26 +458,6 @@ components:
         direct_only:
           type: boolean
           example: false
-        include_carriers:
-          type: array
-          items:
-            type: string
-            pattern: ^[A-Za-z0-9]{2,3}$
-          description: Keep only itineraries whose VALIDATING (ticketing) carrier is in
-            this list — the only carrier field the flight cache carries, unlike
-            the marketing-carrier match on flight_search. 2-3 character
-            IATA/ICAO codes. Must not overlap `exclude_carriers`.
-          example: &a8
-            - UA
-        exclude_carriers:
-          type: array
-          items:
-            type: string
-            pattern: ^[A-Za-z0-9]{2,3}$
-          description: Drop itineraries whose VALIDATING (ticketing) carrier is in this
-            list. Same semantics as `include_carriers`; must not overlap it.
-          example: &a9
-            - NK
         adults:
           type: integer
           minimum: 0
@@ -528,7 +508,7 @@ components:
           default: 0
         sort_by:
           type: string
-          enum: &a10
+          enum: &a8
             - lowest
             - recommendation
           default: lowest
@@ -565,19 +545,6 @@ components:
         next_page_token:
           type: string
           example: eyJvZmZzZXQiOjIwfQ==
-        available_airlines:
-          type: array
-          items:
-            type: string
-          description: VALIDATING (ticketing) carrier codes present across the WHOLE
-            cached match set — not just this page — ordered by itinerary count
-            descending. Lets a caller discover which airlines are available
-            (e.g. to retry with `include_carriers`) without paging through every
-            result. Absent when the platform reports no facet data.
-          example:
-            - UA
-            - DL
-            - AA
       required:
         - itineraries
     FlightDiscoveryRequest:
@@ -648,24 +615,6 @@ components:
         direct_only:
           type: boolean
           example: false
-        include_carriers:
-          type: array
-          items:
-            type: string
-            pattern: ^[A-Za-z0-9]{2,3}$
-          description: Keep only itineraries whose VALIDATING (ticketing) carrier is in
-            this list — the only carrier field the flight cache carries, unlike
-            the marketing-carrier match on flight_search. 2-3 character
-            IATA/ICAO codes. Must not overlap `exclude_carriers`.
-          example: *a8
-        exclude_carriers:
-          type: array
-          items:
-            type: string
-            pattern: ^[A-Za-z0-9]{2,3}$
-          description: Drop itineraries whose VALIDATING (ticketing) carrier is in this
-            list. Same semantics as `include_carriers`; must not overlap it.
-          example: *a9
         adults:
           type: integer
           minimum: 0
@@ -716,7 +665,7 @@ components:
           default: 0
         sort_by:
           type: string
-          enum: *a10
+          enum: *a8
           default: lowest
         intent:
           $ref: "#/components/schemas/IntentInput"
@@ -1558,12 +1507,12 @@ components:
           pattern: ^\d{4}-\d{2}-\d{2}$
         origin_type:
           type: string
-          enum: &a11
+          enum: &a9
             - city
             - airport
         destination_type:
           type: string
-          enum: *a11
+          enum: *a9
         cabin_class:
           type: string
           enum: *a7
@@ -1980,7 +1929,7 @@ components:
           example: trip_1048576
         status:
           type: string
-          enum: &a12
+          enum: &a10
             - draft
             - quoting
             - quoted
@@ -2060,7 +2009,7 @@ components:
             - message
         status:
           type: string
-          enum: *a12
+          enum: *a10
           description: The trip state that refused the write. `expired` on TRIP_EXPIRED;
             on TRIP_STATE_CONFLICT it is whichever state the trip is actually
             in. Nothing was changed, so re-reading the trip returns this same
@@ -2265,7 +2214,7 @@ components:
           example: trip_1048576
         status:
           type: string
-          enum: *a12
+          enum: *a10
           description: "Where the trip is in its lifecycle. `expired` is the 24-hour
             lapse: it is evaluated LAZILY, on the read that first observes it,
             so this call is where a dead trip becomes visible. Once a trip is
@@ -3714,7 +3663,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: &a13
+      example: &a11
         booking_ref: JNK-8PT9VS
         last_name: Carrard
     CarCancelCommitResponse:
@@ -3819,7 +3768,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a13
+      example: *a11
     CarExchangeVehicle:
       type: object
       properties:
@@ -4173,7 +4122,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a13
+      example: *a11
     DestinationSnapshotRow:
       type: object
       properties:
@@ -4499,7 +4448,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: &a14
+      example: &a12
         booking_ref: JNK-A0AUR2
         last_name: Carrard
     ServicingState:
@@ -4632,7 +4581,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a14
+      example: *a12
     RefundStatusResponse:
       type: object
       properties:
@@ -4693,7 +4642,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a14
+      example: *a12
     ExchangeOffer:
       type: object
       properties:
@@ -4754,7 +4703,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a14
+      example: *a12
     ExchangePriceResponse:
       type: object
       properties:
@@ -4901,7 +4850,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a14
+      example: *a12
     ProviderFigures:
       type: object
       properties:
@@ -5670,7 +5619,7 @@ components:
           example: Carrard
         intent:
           $ref: "#/components/schemas/IntentInput"
-      example: *a14
+      example: *a12
     FlightRefundCommitResponse:
       type: object
       properties:
@@ -6312,7 +6261,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: &a15
+          headers: &a13
             Retry-After:
               description: Seconds to wait before retrying, forwarded verbatim from the
                 upstream service. Absent when the upstream named no interval.
@@ -6453,7 +6402,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -6595,7 +6544,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -6736,7 +6685,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -6876,7 +6825,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -7012,7 +6961,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -7165,7 +7114,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -7303,7 +7252,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -7451,7 +7400,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -7587,7 +7536,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -7689,7 +7638,7 @@ paths:
                 anyOf:
                   - $ref: "#/components/schemas/TripStateResponse"
                   - $ref: "#/components/schemas/ErrorResponse"
-              example: &a16
+              example: &a14
                 error:
                   code: CONFLICT
                   message: This trip is already being checked out; no second checkout was started.
@@ -7741,7 +7690,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -7850,7 +7799,7 @@ paths:
                 anyOf:
                   - $ref: "#/components/schemas/TripStateResponse"
                   - $ref: "#/components/schemas/ErrorResponse"
-              example: *a16
+              example: *a14
         "410":
           description: The resource this request names no longer exists
           content:
@@ -7898,7 +7847,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -8050,7 +7999,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -8186,7 +8135,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -8334,7 +8283,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -8475,7 +8424,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -8621,7 +8570,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -8774,7 +8723,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -8927,7 +8876,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -9079,7 +9028,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -9239,7 +9188,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -9398,7 +9347,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -9552,7 +9501,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -9618,7 +9567,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a17
+            enum: &a15
               - Solo
               - Couple
               - Group
@@ -9629,7 +9578,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a18
+            enum: &a16
               - One-Way
               - Round-Trip
             example: Round-Trip
@@ -9699,7 +9648,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a19
+            enum: &a17
               - country
               - city
             description: "Ranked output granularity: country (default) or city. Applies to
@@ -9818,7 +9767,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -9884,14 +9833,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a15
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a16
             example: Round-Trip
           required: false
           name: trip_type
@@ -9959,7 +9908,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a19
+            enum: *a17
             description: "Ranked output granularity: country (default) or city. Applies to
               destination/market (not audience)."
             example: city
@@ -10076,7 +10025,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -10148,14 +10097,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a15
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a16
             example: Round-Trip
           required: false
           name: trip_type
@@ -10321,7 +10270,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -10399,14 +10348,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a15
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a16
             example: Round-Trip
           required: false
           name: trip_type
@@ -10458,7 +10407,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a20
+            enum: &a18
               - day
               - week
               - month
@@ -10568,7 +10517,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -10636,14 +10585,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a15
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a16
             example: Round-Trip
           required: false
           name: trip_type
@@ -10695,7 +10644,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a20
+            enum: *a18
             description: "Bucket size for the returned series: week (default), day, or
               month."
             example: week
@@ -10704,7 +10653,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a19
+            enum: *a17
             description: "Ranked output granularity: country (default) or city. Applies to
               destination/market (not audience)."
             example: city
@@ -10831,7 +10780,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -10899,14 +10848,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a15
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a16
             example: Round-Trip
           required: false
           name: trip_type
@@ -10958,7 +10907,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a20
+            enum: *a18
             description: "Bucket size for the returned series: week (default), day, or
               month."
             example: week
@@ -10967,7 +10916,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a19
+            enum: *a17
             description: "Ranked output granularity: country (default) or city. Applies to
               destination/market (not audience)."
             example: city
@@ -11094,7 +11043,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -11168,14 +11117,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a15
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a16
             example: Round-Trip
           required: false
           name: trip_type
@@ -11227,7 +11176,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a20
+            enum: *a18
             description: "Bucket size for the returned series: week (default), day, or
               month."
             example: week
@@ -11344,7 +11293,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -11482,7 +11431,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -11618,7 +11567,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -11754,7 +11703,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -11901,7 +11850,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -12037,7 +11986,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -12173,7 +12122,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -12309,7 +12258,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -12445,7 +12394,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -12603,7 +12552,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -12761,7 +12710,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -12936,7 +12885,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -13091,7 +13040,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -13258,7 +13207,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -13439,7 +13388,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -13598,7 +13547,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -13738,7 +13687,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -13868,7 +13817,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -14006,7 +13955,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -14143,7 +14092,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema:
@@ -14283,7 +14232,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a13
           content:
             application/json:
               schema: