seatschart 0.1.1 → 0.3.0

data/lib/seatschart/api/map_designer_api.rb

@@ -19,8 +19,8 @@ module SeatsChart
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Extract seat candidates with OpenCV
-    # Multipart file and optional calibration JSON (sample patches, rotations and grouping); returns source-image pixel coordinates for review. Does not persist seats. Requires CV_SERVICE_URL.
+    # Extract seat candidates from a floor-plan image
+    # Multipart image (PNG/JPEG/WebP, at most 8 MiB and 16 megapixels). Returns seat centres in source-image pixels for review in the map designer, plus the `mode` that produced them; nothing is persisted. Requires CV_SERVICE_URL.  Review (`auto` and `examples`): every seat carries a `confidence` (0-1) and the uncertain ones `doubtful: true`; `review` counts them and the designer shows them for a keep/remove decision instead of keeping them silently. `legibility` is `ok`, `low_resolution` or `no_individual_seats`; when it is not `ok` every seat is doubtful and the count is not reliable. `suggested` lists places where a seat was probably missed (not part of `seats`); the designer offers them in the review. Clicks never remove a seat on weak evidence: a seat they argue against stays, flagged `doubtful`. When the clicked seats (or, without clicks, an illegible plan) are tiny, the scanner reads the plan again upscaled. Vector plans: send the PDF or SVG as `vector` (and `vector_page`) next to its rendered image; the response says whether its geometry was `used`.  Modes: `auto` (default) finds the repeated seat glyphs on its own and infers size, rotation and threshold; `examples` uses 1-24 clicked seats (`examples`): a click on a missed seat adds that look, then only detections consistent with the clicked seats (their look, size and spacing, or the same drawn vector shape) stay, plus seats of another look that the scanner is confident about; every clicked seat is kept; `edges` is the legacy contour mode tuned by the `seat_diameter`/`closing_kernel` query parameters.  Refinements for `auto` and `examples`: `negatives` (points the user marked as not a seat after a scan) remove that detection and its look-alikes, or the whole style when most of it looks alike; `region` limits the scan to a rectangle.  `calibration` (sample patches) and `profile` (the mapa1-mapa6 regression benchmark) are kept for backward compatibility and cannot be combined with `mode`, `examples`, `negatives` or `region`. Errors: 422 for invalid parameters or work budgets, 413/415 for oversized or unsupported images (or a `vector` file that is neither PDF nor SVG), 503 when the scanner is busy or not configured, 504 on its 80-second deadline.
     # @param post_api_extract_seats_request [PostApiExtractSeatsRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :seat_diameter 
@@ -28,14 +28,14 @@ module SeatsChart
     # @option opts [Float] :canny_low 
     # @option opts [Float] :canny_high 
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
-    # @return [nil]
+    # @return [PostApiExtractSeats200Response]
     def post_api_extract_seats(post_api_extract_seats_request, opts = {})
-      post_api_extract_seats_with_http_info(post_api_extract_seats_request, opts)
-      nil
+      data, _status_code, _headers = post_api_extract_seats_with_http_info(post_api_extract_seats_request, opts)
+      data
     end
 
-    # Extract seat candidates with OpenCV
-    # Multipart file and optional calibration JSON (sample patches, rotations and grouping); returns source-image pixel coordinates for review. Does not persist seats. Requires CV_SERVICE_URL.
+    # Extract seat candidates from a floor-plan image
+    # Multipart image (PNG/JPEG/WebP, at most 8 MiB and 16 megapixels). Returns seat centres in source-image pixels for review in the map designer, plus the `mode` that produced them; nothing is persisted. Requires CV_SERVICE_URL.  Review (`auto` and `examples`): every seat carries a `confidence` (0-1) and the uncertain ones `doubtful: true`; `review` counts them and the designer shows them for a keep/remove decision instead of keeping them silently. `legibility` is `ok`, `low_resolution` or `no_individual_seats`; when it is not `ok` every seat is doubtful and the count is not reliable. `suggested` lists places where a seat was probably missed (not part of `seats`); the designer offers them in the review. Clicks never remove a seat on weak evidence: a seat they argue against stays, flagged `doubtful`. When the clicked seats (or, without clicks, an illegible plan) are tiny, the scanner reads the plan again upscaled. Vector plans: send the PDF or SVG as `vector` (and `vector_page`) next to its rendered image; the response says whether its geometry was `used`.  Modes: `auto` (default) finds the repeated seat glyphs on its own and infers size, rotation and threshold; `examples` uses 1-24 clicked seats (`examples`): a click on a missed seat adds that look, then only detections consistent with the clicked seats (their look, size and spacing, or the same drawn vector shape) stay, plus seats of another look that the scanner is confident about; every clicked seat is kept; `edges` is the legacy contour mode tuned by the `seat_diameter`/`closing_kernel` query parameters.  Refinements for `auto` and `examples`: `negatives` (points the user marked as not a seat after a scan) remove that detection and its look-alikes, or the whole style when most of it looks alike; `region` limits the scan to a rectangle.  `calibration` (sample patches) and `profile` (the mapa1-mapa6 regression benchmark) are kept for backward compatibility and cannot be combined with `mode`, `examples`, `negatives` or `region`. Errors: 422 for invalid parameters or work budgets, 413/415 for oversized or unsupported images (or a `vector` file that is neither PDF nor SVG), 503 when the scanner is busy or not configured, 504 on its 80-second deadline.
     # @param post_api_extract_seats_request [PostApiExtractSeatsRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :seat_diameter 
@@ -43,7 +43,7 @@ module SeatsChart
     # @option opts [Float] :canny_low 
     # @option opts [Float] :canny_high 
     # @option opts [String] :idempotency_key Required on transactional routes. Reuse the same key for every retry of one logical operation; the API replays the stored outcome.
-    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    # @return [Array<(PostApiExtractSeats200Response, Integer, Hash)>] PostApiExtractSeats200Response data, response status code and response headers
     def post_api_extract_seats_with_http_info(post_api_extract_seats_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MapDesignerApi.post_api_extract_seats ...'
@@ -96,6 +96,8 @@ module SeatsChart
 
       # header parameters
       header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'multipart/form-data', 'text/plain']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data', 'text/plain'])
       if !content_type.nil?
@@ -110,7 +112,7 @@ module SeatsChart
       post_body = opts[:debug_body] || @api_client.object_to_http_body(post_api_extract_seats_request)
 
       # return_type
-      return_type = opts[:debug_return_type]
+      return_type = opts[:debug_return_type] || 'PostApiExtractSeats200Response'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'BearerAuth']

data/lib/seatschart/api/object_status_api.rb

@@ -439,7 +439,7 @@ module SeatsChart
     end
 
     # Put booked objects up for resale
-    # Resale retains the durable owner and sold status. Optional `resaleListingId` groups the objects into one listing (extraData.resaleListingId). Optional `resalePriceCents` is stored on extraData and merged into GET /seats on the next cache rebuild. Administrative status change on the path event. One SQL transaction per event; seats are locked in id order and every precondition is evaluated under those row locks, so a concurrent hold, purchase or other change cannot slip in between the check and the write. Requires **Idempotency-Key**; a replay returns the stored response and a retry after a crash reuses the same durable booking order.  **Objects** (max 64 per call, per event): seat UUID or seat label (labels are resolved per event; a label that matches several seats returns 409 `ambiguous_label`; unknown references return 404 `objects_not_found`). General admission areas are addressed by UUID or name **with `quantity`** (1–10000): - `booked`: the places are first reserved in the same Redis structure buyers hold from (capacity minus not-for-sale places), then `sold_count` is incremented in the transaction with a `sold_count + quantity <= capacity` guard; the durable receipt belongs to the administrative booking order (cancel it with POST /orders/{orderId}/cancel). - `reservedByToken` (or POST …/actions/hold, GA only): holds the places atomically against capacity minus withheld, sold and held places and issues a **GA hold token** (`hold: { holdToken, holdUserId, holdExpiresAt }`), confirmable with POST /ga/confirm (`holdToken`, `userId` = `holdUserId`). Optional `userId` (customer identity of the hold; one hold per user and area, 409 `hold_exists`) and `holdExpiresInMinutes` (1–120). 409 `insufficient_capacity`. - `RELEASE` / `free` without `holdToken`: releases places of **administrative** bookings (newest receipts first, optionally only those of `orderId`), recording a release receipt per consumed booking and decrementing `sold_count` under the GA row lock (409 `insufficient_booked_places` with `available`). Buyer purchases are never released here. - `RELEASE` with `holdToken` (GA hold token): releases that many places held by the token (409 `insufficient_held_places`, `hold_token_conflict`). Every GA operation is idempotent per Idempotency-Key (deterministic receipts/holds/markers), and capacity can never be exceeded nor `sold_count` go below zero. Response `gaAreas: { <areaId>: { areaId, label, quantity, soldCount, status, heldCount?, releasedFrom? } }`.  **`allowedPreviousStatuses` / `rejectedPreviousStatuses`**: `free`, `booked`, `resale`, `reservedByToken`, `retired` or a custom status. On violation nothing is written and 409 `illegal_previous_status` lists every offending object with its current status. For GA quantities the previous status follows from the operation: `free` for book/hold, `booked` for a release, `reservedByToken` for a release by `holdToken`.  **`holdToken`**: with status `booked`, books seats held by that hold token. The hold session is frozen first, so the buyer cannot confirm the same seats concurrently; seats held by another token or not held by this one return 409 `hold_token_conflict`. Remaining seats of the session stay held. With `RELEASE` it releases GA places (see above).  **`ticketType`** (per object, `{ objectId, ticketType }`, status `booked` only): ticket type id recorded on the new booking (order item and reservation, like a confirmed sale) and returned per object; it shows up in reports by ticket type. Other statuses return 400. **`keepExtraData`**: keeps the stored extraData; per-object `extraData` sent with it is merged on top (without it, the object's extraData is replaced by the one sent, or cleared).  **`ticketBuyerId`** (opaque, ≤ 256 chars, never an internal user id) is recorded on new bookings, object statuses, status history and GA hold tokens; query it with GET /events/{eventId}/objects?ticketBuyerId=….  **`channelKeys`** (channel secret keys or channel ids) restricts the change to public objects and objects of the named channels (409 `channel_forbidden` otherwise). Without `channelKeys`, or with `ignoreChannels: true`, channel partitions are ignored (backward-compatible default).  **`events`** (max 50, must include the path event): applies the same change to each event of the tenant, labels resolved per event. By default each event is atomic on its own (no cross-event atomicity): response 200 when every event succeeded, otherwise 207 with `results[]` (`{ eventId, ok, objects | status, error, message }`), `succeeded` and `failed`. Replaying the same Idempotency-Key returns the stored per-event outcome; retry failed events (listed with their error) with a new key. **`atomic: true`** makes the whole call all-or-nothing in one SQL transaction (same engine as POST /events/actions/change-object-status; at most 512 objects across the events): 200 with `atomic: true` when everything was applied, otherwise the status of the first failing event and `results[]` with `outcome: failed` (with `error`, `message`) or `rolled_back` per event — nothing was written. GA administrative holds cannot be atomic (400 `not_atomic`).  **`seasonId`** (season or partial season id; XOR with `events`): fans out by unique label to every live member in one transaction (cap 50 members, 64 seats overall). Preconditions and channelKeys apply to every member seat.
+    # Resale retains the durable owner and sold status. Optional `resaleListingId` groups the objects into one listing (extraData.resaleListingId). Optional `resalePriceCents` is stored on extraData and merged into GET /seats on the next cache rebuild. Optional `listing` also creates a server-side listing of the objects (type, sellAsWhole, price; see the listings tag): viewers then show and sell it as one listing. Administrative status change on the path event. One SQL transaction per event; seats are locked in id order and every precondition is evaluated under those row locks, so a concurrent hold, purchase or other change cannot slip in between the check and the write. Requires **Idempotency-Key**; a replay returns the stored response and a retry after a crash reuses the same durable booking order.  **Objects** (max 64 per call, per event): seat UUID or seat label (labels are resolved per event; a label that matches several seats returns 409 `ambiguous_label`; unknown references return 404 `objects_not_found`). General admission areas are addressed by UUID or name **with `quantity`** (1–10000): - `booked`: the places are first reserved in the same Redis structure buyers hold from (capacity minus not-for-sale places), then `sold_count` is incremented in the transaction with a `sold_count + quantity <= capacity` guard; the durable receipt belongs to the administrative booking order (cancel it with POST /orders/{orderId}/cancel). - `reservedByToken` (or POST …/actions/hold, GA only): holds the places atomically against capacity minus withheld, sold and held places and issues a **GA hold token** (`hold: { holdToken, holdUserId, holdExpiresAt }`), confirmable with POST /ga/confirm (`holdToken`, `userId` = `holdUserId`). Optional `userId` (customer identity of the hold; one hold per user and area, 409 `hold_exists`) and `holdExpiresInMinutes` (1–120). 409 `insufficient_capacity`. - `RELEASE` / `free` without `holdToken`: releases places of **administrative** bookings (newest receipts first, optionally only those of `orderId`), recording a release receipt per consumed booking and decrementing `sold_count` under the GA row lock (409 `insufficient_booked_places` with `available`). Buyer purchases are never released here. - `RELEASE` with `holdToken` (GA hold token): releases that many places held by the token (409 `insufficient_held_places`, `hold_token_conflict`). Every GA operation is idempotent per Idempotency-Key (deterministic receipts/holds/markers), and capacity can never be exceeded nor `sold_count` go below zero. Response `gaAreas: { <areaId>: { areaId, label, quantity, soldCount, status, heldCount?, releasedFrom? } }`.  **`allowedPreviousStatuses` / `rejectedPreviousStatuses`**: `free`, `booked`, `resale`, `reservedByToken`, `retired` or a custom status. On violation nothing is written and 409 `illegal_previous_status` lists every offending object with its current status. For GA quantities the previous status follows from the operation: `free` for book/hold, `booked` for a release, `reservedByToken` for a release by `holdToken`.  **`holdToken`**: with status `booked`, books seats held by that hold token. The hold session is frozen first, so the buyer cannot confirm the same seats concurrently; seats held by another token or not held by this one return 409 `hold_token_conflict`. Remaining seats of the session stay held. With `RELEASE` it releases GA places (see above).  **`ticketType`** (per object, `{ objectId, ticketType }`, status `booked` only): ticket type id recorded on the new booking (order item and reservation, like a confirmed sale) and returned per object; it shows up in reports by ticket type. Other statuses return 400. **`keepExtraData`**: keeps the stored extraData; per-object `extraData` sent with it is merged on top (without it, the object's extraData is replaced by the one sent, or cleared).  **`ticketBuyerId`** (opaque, ≤ 256 chars, never an internal user id) is recorded on new bookings, object statuses, status history and GA hold tokens; query it with GET /events/{eventId}/objects?ticketBuyerId=….  **`channelKeys`** (channel secret keys or channel ids) restricts the change to public objects and objects of the named channels (409 `channel_forbidden` otherwise). Without `channelKeys`, or with `ignoreChannels: true`, channel partitions are ignored (backward-compatible default).  **`events`** (max 50, must include the path event): applies the same change to each event of the tenant, labels resolved per event. By default each event is atomic on its own (no cross-event atomicity): response 200 when every event succeeded, otherwise 207 with `results[]` (`{ eventId, ok, objects | status, error, message }`), `succeeded` and `failed`. Replaying the same Idempotency-Key returns the stored per-event outcome; retry failed events (listed with their error) with a new key. **`atomic: true`** makes the whole call all-or-nothing in one SQL transaction (same engine as POST /events/actions/change-object-status; at most 512 objects across the events): 200 with `atomic: true` when everything was applied, otherwise the status of the first failing event and `results[]` with `outcome: failed` (with `error`, `message`) or `rolled_back` per event — nothing was written. GA administrative holds cannot be atomic (400 `not_atomic`).  **`seasonId`** (season or partial season id; XOR with `events`): fans out by unique label to every live member in one transaction (cap 50 members, 64 seats overall). Preconditions and channelKeys apply to every member seat.
     # @param event_id [String] 
     # @param post_api_events_by_event_id_actions_change_object_status_request [PostApiEventsByEventIdActionsChangeObjectStatusRequest] 
     # @param [Hash] opts the optional parameters
@@ -451,7 +451,7 @@ module SeatsChart
     end
 
     # Put booked objects up for resale
-    # Resale retains the durable owner and sold status. Optional &#x60;resaleListingId&#x60; groups the objects into one listing (extraData.resaleListingId). Optional &#x60;resalePriceCents&#x60; is stored on extraData and merged into GET /seats on the next cache rebuild. Administrative status change on the path event. One SQL transaction per event; seats are locked in id order and every precondition is evaluated under those row locks, so a concurrent hold, purchase or other change cannot slip in between the check and the write. Requires **Idempotency-Key**; a replay returns the stored response and a retry after a crash reuses the same durable booking order.  **Objects** (max 64 per call, per event): seat UUID or seat label (labels are resolved per event; a label that matches several seats returns 409 &#x60;ambiguous_label&#x60;; unknown references return 404 &#x60;objects_not_found&#x60;). General admission areas are addressed by UUID or name **with &#x60;quantity&#x60;** (1–10000): - &#x60;booked&#x60;: the places are first reserved in the same Redis structure buyers hold from (capacity minus not-for-sale places), then &#x60;sold_count&#x60; is incremented in the transaction with a &#x60;sold_count + quantity &lt;&#x3D; capacity&#x60; guard; the durable receipt belongs to the administrative booking order (cancel it with POST /orders/{orderId}/cancel). - &#x60;reservedByToken&#x60; (or POST …/actions/hold, GA only): holds the places atomically against capacity minus withheld, sold and held places and issues a **GA hold token** (&#x60;hold: { holdToken, holdUserId, holdExpiresAt }&#x60;), confirmable with POST /ga/confirm (&#x60;holdToken&#x60;, &#x60;userId&#x60; &#x3D; &#x60;holdUserId&#x60;). Optional &#x60;userId&#x60; (customer identity of the hold; one hold per user and area, 409 &#x60;hold_exists&#x60;) and &#x60;holdExpiresInMinutes&#x60; (1–120). 409 &#x60;insufficient_capacity&#x60;. - &#x60;RELEASE&#x60; / &#x60;free&#x60; without &#x60;holdToken&#x60;: releases places of **administrative** bookings (newest receipts first, optionally only those of &#x60;orderId&#x60;), recording a release receipt per consumed booking and decrementing &#x60;sold_count&#x60; under the GA row lock (409 &#x60;insufficient_booked_places&#x60; with &#x60;available&#x60;). Buyer purchases are never released here. - &#x60;RELEASE&#x60; with &#x60;holdToken&#x60; (GA hold token): releases that many places held by the token (409 &#x60;insufficient_held_places&#x60;, &#x60;hold_token_conflict&#x60;). Every GA operation is idempotent per Idempotency-Key (deterministic receipts/holds/markers), and capacity can never be exceeded nor &#x60;sold_count&#x60; go below zero. Response &#x60;gaAreas: { &lt;areaId&gt;: { areaId, label, quantity, soldCount, status, heldCount?, releasedFrom? } }&#x60;.  **&#x60;allowedPreviousStatuses&#x60; / &#x60;rejectedPreviousStatuses&#x60;**: &#x60;free&#x60;, &#x60;booked&#x60;, &#x60;resale&#x60;, &#x60;reservedByToken&#x60;, &#x60;retired&#x60; or a custom status. On violation nothing is written and 409 &#x60;illegal_previous_status&#x60; lists every offending object with its current status. For GA quantities the previous status follows from the operation: &#x60;free&#x60; for book/hold, &#x60;booked&#x60; for a release, &#x60;reservedByToken&#x60; for a release by &#x60;holdToken&#x60;.  **&#x60;holdToken&#x60;**: with status &#x60;booked&#x60;, books seats held by that hold token. The hold session is frozen first, so the buyer cannot confirm the same seats concurrently; seats held by another token or not held by this one return 409 &#x60;hold_token_conflict&#x60;. Remaining seats of the session stay held. With &#x60;RELEASE&#x60; it releases GA places (see above).  **&#x60;ticketType&#x60;** (per object, &#x60;{ objectId, ticketType }&#x60;, status &#x60;booked&#x60; only): ticket type id recorded on the new booking (order item and reservation, like a confirmed sale) and returned per object; it shows up in reports by ticket type. Other statuses return 400. **&#x60;keepExtraData&#x60;**: keeps the stored extraData; per-object &#x60;extraData&#x60; sent with it is merged on top (without it, the object&#39;s extraData is replaced by the one sent, or cleared).  **&#x60;ticketBuyerId&#x60;** (opaque, ≤ 256 chars, never an internal user id) is recorded on new bookings, object statuses, status history and GA hold tokens; query it with GET /events/{eventId}/objects?ticketBuyerId&#x3D;….  **&#x60;channelKeys&#x60;** (channel secret keys or channel ids) restricts the change to public objects and objects of the named channels (409 &#x60;channel_forbidden&#x60; otherwise). Without &#x60;channelKeys&#x60;, or with &#x60;ignoreChannels: true&#x60;, channel partitions are ignored (backward-compatible default).  **&#x60;events&#x60;** (max 50, must include the path event): applies the same change to each event of the tenant, labels resolved per event. By default each event is atomic on its own (no cross-event atomicity): response 200 when every event succeeded, otherwise 207 with &#x60;results[]&#x60; (&#x60;{ eventId, ok, objects | status, error, message }&#x60;), &#x60;succeeded&#x60; and &#x60;failed&#x60;. Replaying the same Idempotency-Key returns the stored per-event outcome; retry failed events (listed with their error) with a new key. **&#x60;atomic: true&#x60;** makes the whole call all-or-nothing in one SQL transaction (same engine as POST /events/actions/change-object-status; at most 512 objects across the events): 200 with &#x60;atomic: true&#x60; when everything was applied, otherwise the status of the first failing event and &#x60;results[]&#x60; with &#x60;outcome: failed&#x60; (with &#x60;error&#x60;, &#x60;message&#x60;) or &#x60;rolled_back&#x60; per event — nothing was written. GA administrative holds cannot be atomic (400 &#x60;not_atomic&#x60;).  **&#x60;seasonId&#x60;** (season or partial season id; XOR with &#x60;events&#x60;): fans out by unique label to every live member in one transaction (cap 50 members, 64 seats overall). Preconditions and channelKeys apply to every member seat.
+    # Resale retains the durable owner and sold status. Optional &#x60;resaleListingId&#x60; groups the objects into one listing (extraData.resaleListingId). Optional &#x60;resalePriceCents&#x60; is stored on extraData and merged into GET /seats on the next cache rebuild. Optional &#x60;listing&#x60; also creates a server-side listing of the objects (type, sellAsWhole, price; see the listings tag): viewers then show and sell it as one listing. Administrative status change on the path event. One SQL transaction per event; seats are locked in id order and every precondition is evaluated under those row locks, so a concurrent hold, purchase or other change cannot slip in between the check and the write. Requires **Idempotency-Key**; a replay returns the stored response and a retry after a crash reuses the same durable booking order.  **Objects** (max 64 per call, per event): seat UUID or seat label (labels are resolved per event; a label that matches several seats returns 409 &#x60;ambiguous_label&#x60;; unknown references return 404 &#x60;objects_not_found&#x60;). General admission areas are addressed by UUID or name **with &#x60;quantity&#x60;** (1–10000): - &#x60;booked&#x60;: the places are first reserved in the same Redis structure buyers hold from (capacity minus not-for-sale places), then &#x60;sold_count&#x60; is incremented in the transaction with a &#x60;sold_count + quantity &lt;&#x3D; capacity&#x60; guard; the durable receipt belongs to the administrative booking order (cancel it with POST /orders/{orderId}/cancel). - &#x60;reservedByToken&#x60; (or POST …/actions/hold, GA only): holds the places atomically against capacity minus withheld, sold and held places and issues a **GA hold token** (&#x60;hold: { holdToken, holdUserId, holdExpiresAt }&#x60;), confirmable with POST /ga/confirm (&#x60;holdToken&#x60;, &#x60;userId&#x60; &#x3D; &#x60;holdUserId&#x60;). Optional &#x60;userId&#x60; (customer identity of the hold; one hold per user and area, 409 &#x60;hold_exists&#x60;) and &#x60;holdExpiresInMinutes&#x60; (1–120). 409 &#x60;insufficient_capacity&#x60;. - &#x60;RELEASE&#x60; / &#x60;free&#x60; without &#x60;holdToken&#x60;: releases places of **administrative** bookings (newest receipts first, optionally only those of &#x60;orderId&#x60;), recording a release receipt per consumed booking and decrementing &#x60;sold_count&#x60; under the GA row lock (409 &#x60;insufficient_booked_places&#x60; with &#x60;available&#x60;). Buyer purchases are never released here. - &#x60;RELEASE&#x60; with &#x60;holdToken&#x60; (GA hold token): releases that many places held by the token (409 &#x60;insufficient_held_places&#x60;, &#x60;hold_token_conflict&#x60;). Every GA operation is idempotent per Idempotency-Key (deterministic receipts/holds/markers), and capacity can never be exceeded nor &#x60;sold_count&#x60; go below zero. Response &#x60;gaAreas: { &lt;areaId&gt;: { areaId, label, quantity, soldCount, status, heldCount?, releasedFrom? } }&#x60;.  **&#x60;allowedPreviousStatuses&#x60; / &#x60;rejectedPreviousStatuses&#x60;**: &#x60;free&#x60;, &#x60;booked&#x60;, &#x60;resale&#x60;, &#x60;reservedByToken&#x60;, &#x60;retired&#x60; or a custom status. On violation nothing is written and 409 &#x60;illegal_previous_status&#x60; lists every offending object with its current status. For GA quantities the previous status follows from the operation: &#x60;free&#x60; for book/hold, &#x60;booked&#x60; for a release, &#x60;reservedByToken&#x60; for a release by &#x60;holdToken&#x60;.  **&#x60;holdToken&#x60;**: with status &#x60;booked&#x60;, books seats held by that hold token. The hold session is frozen first, so the buyer cannot confirm the same seats concurrently; seats held by another token or not held by this one return 409 &#x60;hold_token_conflict&#x60;. Remaining seats of the session stay held. With &#x60;RELEASE&#x60; it releases GA places (see above).  **&#x60;ticketType&#x60;** (per object, &#x60;{ objectId, ticketType }&#x60;, status &#x60;booked&#x60; only): ticket type id recorded on the new booking (order item and reservation, like a confirmed sale) and returned per object; it shows up in reports by ticket type. Other statuses return 400. **&#x60;keepExtraData&#x60;**: keeps the stored extraData; per-object &#x60;extraData&#x60; sent with it is merged on top (without it, the object&#39;s extraData is replaced by the one sent, or cleared).  **&#x60;ticketBuyerId&#x60;** (opaque, ≤ 256 chars, never an internal user id) is recorded on new bookings, object statuses, status history and GA hold tokens; query it with GET /events/{eventId}/objects?ticketBuyerId&#x3D;….  **&#x60;channelKeys&#x60;** (channel secret keys or channel ids) restricts the change to public objects and objects of the named channels (409 &#x60;channel_forbidden&#x60; otherwise). Without &#x60;channelKeys&#x60;, or with &#x60;ignoreChannels: true&#x60;, channel partitions are ignored (backward-compatible default).  **&#x60;events&#x60;** (max 50, must include the path event): applies the same change to each event of the tenant, labels resolved per event. By default each event is atomic on its own (no cross-event atomicity): response 200 when every event succeeded, otherwise 207 with &#x60;results[]&#x60; (&#x60;{ eventId, ok, objects | status, error, message }&#x60;), &#x60;succeeded&#x60; and &#x60;failed&#x60;. Replaying the same Idempotency-Key returns the stored per-event outcome; retry failed events (listed with their error) with a new key. **&#x60;atomic: true&#x60;** makes the whole call all-or-nothing in one SQL transaction (same engine as POST /events/actions/change-object-status; at most 512 objects across the events): 200 with &#x60;atomic: true&#x60; when everything was applied, otherwise the status of the first failing event and &#x60;results[]&#x60; with &#x60;outcome: failed&#x60; (with &#x60;error&#x60;, &#x60;message&#x60;) or &#x60;rolled_back&#x60; per event — nothing was written. GA administrative holds cannot be atomic (400 &#x60;not_atomic&#x60;).  **&#x60;seasonId&#x60;** (season or partial season id; XOR with &#x60;events&#x60;): fans out by unique label to every live member in one transaction (cap 50 members, 64 seats overall). Preconditions and channelKeys apply to every member seat.
     # @param event_id [String] 
     # @param post_api_events_by_event_id_actions_change_object_status_request [PostApiEventsByEventIdActionsChangeObjectStatusRequest] 
     # @param [Hash] opts the optional parameters

data/lib/seatschart/api/public_api.rb

@@ -19,6 +19,356 @@ module SeatsChart
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # Map-only embed policy of a chart
+    # Used by the Next.js map-only viewer (`/viewer/chart/{chart}?workspaceKey=…`) to build CSP frame-ancestors and validate `parent_origin`, like the event embed policy: `{ origins, chart: { id, name }, rendererDefaults }`. No tenant id. A deactivated workspace returns 403 `workspace_deactivated`; an unknown key or chart, a chart that was never published or is archived: 404 `not_found` (errors are `no-store`). CDN cache key: path + Origin + normalized Accept-Encoding.
+    # @param public_key [String] Workspace public key (`pub_…`).
+    # @param chart [String] Chart id or chart key.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_public_by_public_key_charts_by_chart_embed_policy(public_key, chart, opts = {})
+      get_api_public_by_public_key_charts_by_chart_embed_policy_with_http_info(public_key, chart, opts)
+      nil
+    end
+
+    # Map-only embed policy of a chart
+    # Used by the Next.js map-only viewer (`/viewer/chart/{chart}?workspaceKey=…`) to build CSP frame-ancestors and validate `parent_origin`, like the event embed policy: `{ origins, chart: { id, name }, rendererDefaults }`. No tenant id. A deactivated workspace returns 403 `workspace_deactivated`; an unknown key or chart, a chart that was never published or is archived: 404 `not_found` (errors are `no-store`). CDN cache key: path + Origin + normalized Accept-Encoding.
+    # @param public_key [String] Workspace public key (`pub_…`).
+    # @param chart [String] Chart id or chart key.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_public_by_public_key_charts_by_chart_embed_policy_with_http_info(public_key, chart, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PublicApi.get_api_public_by_public_key_charts_by_chart_embed_policy ...'
+      end
+      # verify the required parameter 'public_key' is set
+      if @api_client.config.client_side_validation && public_key.nil?
+        fail ArgumentError, "Missing the required parameter 'public_key' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_embed_policy"
+      end
+      if @api_client.config.client_side_validation && public_key.to_s.length > 64
+        fail ArgumentError, 'invalid value for "public_key" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_embed_policy, the character length must be smaller than or equal to 64.'
+      end
+
+      if @api_client.config.client_side_validation && public_key.to_s.length < 1
+        fail ArgumentError, 'invalid value for "public_key" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_embed_policy, the character length must be great than or equal to 1.'
+      end
+
+      # verify the required parameter 'chart' is set
+      if @api_client.config.client_side_validation && chart.nil?
+        fail ArgumentError, "Missing the required parameter 'chart' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_embed_policy"
+      end
+      if @api_client.config.client_side_validation && chart.to_s.length > 100
+        fail ArgumentError, 'invalid value for "chart" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_embed_policy, the character length must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && chart.to_s.length < 1
+        fail ArgumentError, 'invalid value for "chart" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_embed_policy, the character length must be great than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[A-Za-z0-9][A-Za-z0-9_.~-]{0,99}$/)
+      if @api_client.config.client_side_validation && chart !~ pattern
+        fail ArgumentError, "invalid value for 'chart' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_embed_policy, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/api/public/{publicKey}/charts/{chart}/embed-policy'.sub('{' + 'publicKey' + '}', CGI.escape(public_key.to_s)).sub('{' + 'chart' + '}', CGI.escape(chart.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"PublicApi.get_api_public_by_public_key_charts_by_chart_embed_policy",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PublicApi#get_api_public_by_public_key_charts_by_chart_embed_policy\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Map-only chart geometry (immutable, CDN-cacheable)
+    # Content-addressed published geometry of the chart (sha256 of the canonical JSON; clients verify it), the same document as the chart preview geometry. `Cache-Control: public, max-age=31536000, immutable`. Unknown hash: 404. A deactivated workspace returns 403 `workspace_deactivated`; an unknown key or chart, a chart that was never published or is archived: 404 `not_found` (errors are `no-store`). CDN cache key: path + Origin + normalized Accept-Encoding.
+    # @param public_key [String] Workspace public key (&#x60;pub_…&#x60;).
+    # @param chart [String] Chart id or chart key.
+    # @param hash [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_public_by_public_key_charts_by_chart_geometry_by_hash(public_key, chart, hash, opts = {})
+      get_api_public_by_public_key_charts_by_chart_geometry_by_hash_with_http_info(public_key, chart, hash, opts)
+      nil
+    end
+
+    # Map-only chart geometry (immutable, CDN-cacheable)
+    # Content-addressed published geometry of the chart (sha256 of the canonical JSON; clients verify it), the same document as the chart preview geometry. &#x60;Cache-Control: public, max-age&#x3D;31536000, immutable&#x60;. Unknown hash: 404. A deactivated workspace returns 403 &#x60;workspace_deactivated&#x60;; an unknown key or chart, a chart that was never published or is archived: 404 &#x60;not_found&#x60; (errors are &#x60;no-store&#x60;). CDN cache key: path + Origin + normalized Accept-Encoding.
+    # @param public_key [String] Workspace public key (&#x60;pub_…&#x60;).
+    # @param chart [String] Chart id or chart key.
+    # @param hash [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_public_by_public_key_charts_by_chart_geometry_by_hash_with_http_info(public_key, chart, hash, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash ...'
+      end
+      # verify the required parameter 'public_key' is set
+      if @api_client.config.client_side_validation && public_key.nil?
+        fail ArgumentError, "Missing the required parameter 'public_key' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash"
+      end
+      if @api_client.config.client_side_validation && public_key.to_s.length > 64
+        fail ArgumentError, 'invalid value for "public_key" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash, the character length must be smaller than or equal to 64.'
+      end
+
+      if @api_client.config.client_side_validation && public_key.to_s.length < 1
+        fail ArgumentError, 'invalid value for "public_key" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash, the character length must be great than or equal to 1.'
+      end
+
+      # verify the required parameter 'chart' is set
+      if @api_client.config.client_side_validation && chart.nil?
+        fail ArgumentError, "Missing the required parameter 'chart' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash"
+      end
+      if @api_client.config.client_side_validation && chart.to_s.length > 100
+        fail ArgumentError, 'invalid value for "chart" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash, the character length must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && chart.to_s.length < 1
+        fail ArgumentError, 'invalid value for "chart" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash, the character length must be great than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[A-Za-z0-9][A-Za-z0-9_.~-]{0,99}$/)
+      if @api_client.config.client_side_validation && chart !~ pattern
+        fail ArgumentError, "invalid value for 'chart' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'hash' is set
+      if @api_client.config.client_side_validation && hash.nil?
+        fail ArgumentError, "Missing the required parameter 'hash' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash"
+      end
+      pattern = Regexp.new(/^[a-f0-9]{64}$/)
+      if @api_client.config.client_side_validation && hash !~ pattern
+        fail ArgumentError, "invalid value for 'hash' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/api/public/{publicKey}/charts/{chart}/geometry/{hash}'.sub('{' + 'publicKey' + '}', CGI.escape(public_key.to_s)).sub('{' + 'chart' + '}', CGI.escape(chart.to_s)).sub('{' + 'hash' + '}', CGI.escape(hash.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"PublicApi.get_api_public_by_public_key_charts_by_chart_geometry_by_hash",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PublicApi#get_api_public_by_public_key_charts_by_chart_geometry_by_hash\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Map-only chart manifest (CDN-cacheable)
+    # Published chart for a map-only render (seats.io `bringYourOwnBackend`): `{ chartId, name, eventId (= chartId), mapRevision, geometryHash, geometrySchema, seatCount, gaCount, geometryUrl, state }`. `state` is the compact state with every object free (catalog prices, GA capacities, category prices / ticket types, booking rules); the renderer overlays the statuses the host passes. No inventory, holds or event data. Every object of the chart (seats + general admission areas) counts as a used object once per chart and UTC month (see the map-only guide). ETag; `If-None-Match` returns 304. `Cache-Control: public, max-age=30, stale-while-revalidate=60`. `chart` accepts the chart id or key. A deactivated workspace returns 403 `workspace_deactivated`; an unknown key or chart, a chart that was never published or is archived: 404 `not_found` (errors are `no-store`). CDN cache key: path + Origin + normalized Accept-Encoding.
+    # @param public_key [String] Workspace public key (&#x60;pub_…&#x60;).
+    # @param chart [String] Chart id or chart key.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_public_by_public_key_charts_by_chart_manifest(public_key, chart, opts = {})
+      get_api_public_by_public_key_charts_by_chart_manifest_with_http_info(public_key, chart, opts)
+      nil
+    end
+
+    # Map-only chart manifest (CDN-cacheable)
+    # Published chart for a map-only render (seats.io &#x60;bringYourOwnBackend&#x60;): &#x60;{ chartId, name, eventId (&#x3D; chartId), mapRevision, geometryHash, geometrySchema, seatCount, gaCount, geometryUrl, state }&#x60;. &#x60;state&#x60; is the compact state with every object free (catalog prices, GA capacities, category prices / ticket types, booking rules); the renderer overlays the statuses the host passes. No inventory, holds or event data. Every object of the chart (seats + general admission areas) counts as a used object once per chart and UTC month (see the map-only guide). ETag; &#x60;If-None-Match&#x60; returns 304. &#x60;Cache-Control: public, max-age&#x3D;30, stale-while-revalidate&#x3D;60&#x60;. &#x60;chart&#x60; accepts the chart id or key. A deactivated workspace returns 403 &#x60;workspace_deactivated&#x60;; an unknown key or chart, a chart that was never published or is archived: 404 &#x60;not_found&#x60; (errors are &#x60;no-store&#x60;). CDN cache key: path + Origin + normalized Accept-Encoding.
+    # @param public_key [String] Workspace public key (&#x60;pub_…&#x60;).
+    # @param chart [String] Chart id or chart key.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_public_by_public_key_charts_by_chart_manifest_with_http_info(public_key, chart, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PublicApi.get_api_public_by_public_key_charts_by_chart_manifest ...'
+      end
+      # verify the required parameter 'public_key' is set
+      if @api_client.config.client_side_validation && public_key.nil?
+        fail ArgumentError, "Missing the required parameter 'public_key' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_manifest"
+      end
+      if @api_client.config.client_side_validation && public_key.to_s.length > 64
+        fail ArgumentError, 'invalid value for "public_key" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_manifest, the character length must be smaller than or equal to 64.'
+      end
+
+      if @api_client.config.client_side_validation && public_key.to_s.length < 1
+        fail ArgumentError, 'invalid value for "public_key" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_manifest, the character length must be great than or equal to 1.'
+      end
+
+      # verify the required parameter 'chart' is set
+      if @api_client.config.client_side_validation && chart.nil?
+        fail ArgumentError, "Missing the required parameter 'chart' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_manifest"
+      end
+      if @api_client.config.client_side_validation && chart.to_s.length > 100
+        fail ArgumentError, 'invalid value for "chart" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_manifest, the character length must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && chart.to_s.length < 1
+        fail ArgumentError, 'invalid value for "chart" when calling PublicApi.get_api_public_by_public_key_charts_by_chart_manifest, the character length must be great than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[A-Za-z0-9][A-Za-z0-9_.~-]{0,99}$/)
+      if @api_client.config.client_side_validation && chart !~ pattern
+        fail ArgumentError, "invalid value for 'chart' when calling PublicApi.get_api_public_by_public_key_charts_by_chart_manifest, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/api/public/{publicKey}/charts/{chart}/manifest'.sub('{' + 'publicKey' + '}', CGI.escape(public_key.to_s)).sub('{' + 'chart' + '}', CGI.escape(chart.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"PublicApi.get_api_public_by_public_key_charts_by_chart_manifest",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PublicApi#get_api_public_by_public_key_charts_by_chart_manifest\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Published buyer extraData of an event (workspace opt-in, CDN-cacheable)
+    # Object `extraData` is private by default. When a workspace admin enables buyer publication (`PUT /api/workspace/buyer-extra-data`) with an allow-list of keys, this read returns, for the workspace's events, `{ keys, objects: { [objectId]: { key: value } } }` with only those keys and scalar values (strings up to 256 characters, numbers, booleans, null; objects, arrays and longer strings are never published). The renderer reads it once after the map for declarative rules (`match.extraData`), templates (`{extraData.key}`) and host objects. Built from one indexed query on a miss, then served from a per-event cache dropped whenever the seat map cache is invalidated (overlay writes, extraData updates) and rebuilt when the key list changes. Never part of the compact state. Not published (setting off or no keys): 404 `extra_data_not_published`. ETag; `If-None-Match` returns 304. `Cache-Control: public, max-age=5, stale-while-revalidate=10`. `eventId` also accepts the event key.
+    # @param public_key [String] Workspace public key (&#x60;pub_…&#x60;).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_api_public_by_public_key_events_by_event_id_extra_data(public_key, event_id, opts = {})
+      get_api_public_by_public_key_events_by_event_id_extra_data_with_http_info(public_key, event_id, opts)
+      nil
+    end
+
+    # Published buyer extraData of an event (workspace opt-in, CDN-cacheable)
+    # Object &#x60;extraData&#x60; is private by default. When a workspace admin enables buyer publication (&#x60;PUT /api/workspace/buyer-extra-data&#x60;) with an allow-list of keys, this read returns, for the workspace&#39;s events, &#x60;{ keys, objects: { [objectId]: { key: value } } }&#x60; with only those keys and scalar values (strings up to 256 characters, numbers, booleans, null; objects, arrays and longer strings are never published). The renderer reads it once after the map for declarative rules (&#x60;match.extraData&#x60;), templates (&#x60;{extraData.key}&#x60;) and host objects. Built from one indexed query on a miss, then served from a per-event cache dropped whenever the seat map cache is invalidated (overlay writes, extraData updates) and rebuilt when the key list changes. Never part of the compact state. Not published (setting off or no keys): 404 &#x60;extra_data_not_published&#x60;. ETag; &#x60;If-None-Match&#x60; returns 304. &#x60;Cache-Control: public, max-age&#x3D;5, stale-while-revalidate&#x3D;10&#x60;. &#x60;eventId&#x60; also accepts the event key.
+    # @param public_key [String] Workspace public key (&#x60;pub_…&#x60;).
+    # @param event_id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_api_public_by_public_key_events_by_event_id_extra_data_with_http_info(public_key, event_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PublicApi.get_api_public_by_public_key_events_by_event_id_extra_data ...'
+      end
+      # verify the required parameter 'public_key' is set
+      if @api_client.config.client_side_validation && public_key.nil?
+        fail ArgumentError, "Missing the required parameter 'public_key' when calling PublicApi.get_api_public_by_public_key_events_by_event_id_extra_data"
+      end
+      if @api_client.config.client_side_validation && public_key.to_s.length > 64
+        fail ArgumentError, 'invalid value for "public_key" when calling PublicApi.get_api_public_by_public_key_events_by_event_id_extra_data, the character length must be smaller than or equal to 64.'
+      end
+
+      if @api_client.config.client_side_validation && public_key.to_s.length < 1
+        fail ArgumentError, 'invalid value for "public_key" when calling PublicApi.get_api_public_by_public_key_events_by_event_id_extra_data, the character length must be great than or equal to 1.'
+      end
+
+      # verify the required parameter 'event_id' is set
+      if @api_client.config.client_side_validation && event_id.nil?
+        fail ArgumentError, "Missing the required parameter 'event_id' when calling PublicApi.get_api_public_by_public_key_events_by_event_id_extra_data"
+      end
+      # resource path
+      local_var_path = '/api/public/{publicKey}/events/{eventId}/extra-data'.sub('{' + 'publicKey' + '}', CGI.escape(public_key.to_s)).sub('{' + 'eventId' + '}', CGI.escape(event_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"PublicApi.get_api_public_by_public_key_events_by_event_id_extra_data",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PublicApi#get_api_public_by_public_key_events_by_event_id_extra_data\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Public immutable geometry (CDN-cacheable)
     # Content-addressed geometry (sha256 of the canonical JSON). br/gzip negotiated from Accept-Encoding. `Cache-Control: public, max-age=31536000, immutable`. Clients must verify the hash. Unknown key, event or hash: 404 no-store. `eventId` also accepts the event key. A deactivated workspace returns 403 `workspace_deactivated` (no-store). CDN cache key: path + Origin + normalized Accept-Encoding. Never forward or key on cookies, Authorization, x-api-key, x-channel-key or the query string.
     # @param public_key [String] Workspace public key (&#x60;pub_…&#x60;).