View Javadoc
1   package org.oxerr.vividseats.client.rescu.resource.v1;
2   
3   import java.io.IOException;
4   import java.math.BigDecimal;
5   import java.util.List;
6   
7   import org.oxerr.vividseats.client.model.SplitType;
8   import org.oxerr.vividseats.client.rescu.resource.Response;
9   import org.oxerr.vividseats.client.rescu.resource.VividSeatsException;
10  
11  import jakarta.ws.rs.Consumes;
12  import jakarta.ws.rs.FormParam;
13  import jakarta.ws.rs.POST;
14  import jakarta.ws.rs.Path;
15  import jakarta.ws.rs.Produces;
16  import jakarta.ws.rs.core.MediaType;
17  
18  @Path("/listings/v1")
19  @Produces(MediaType.APPLICATION_JSON)
20  @Consumes(MediaType.APPLICATION_JSON)
21  public interface ListingResource {
22  
23  	/**
24  	 * Updates a listing.
25  	 *
26  	 * XML or JSON responses.
27  	 *
28  	 * The updateListing method allows you to update a listing in real-time.
29  	 * Only parameters you pass in to the method will be updated.
30  	 * The ticketId is your internal unique ID associated with the listing.
31  	 *
32  	 * Not rate limited
33  	 *
34  	 * @param ticketId The ticket ID.
35  	 * @param quantity The quantity of tickets.
36  	 * @param section The section.
37  	 * @param row The row.
38  	 * @param seatFrom The seat from.
39  	 * @param seatThru The seat thru.
40  	 * @param notes The notes.
41  	 * @param price The price.
42  	 * @param electronic The electronic.
43  	 * @param inHandDate The in hand date.
44  	 * @param splitType The split type.
45  	 * @param splitValue The split value.
46  	 * @param barcode The barcode.
47  	 * @param faceValue The face value.
48  	 * @param unitTaxedCost The unit taxed cost.
49  	 * @return the response.
50  	 * @throws IOException if an I/O error occurs.
51  	 * @throws VividSeatsException if an error occurs.
52  	 * @see <a href="https://vividseats.stoplight.io/docs/broker-portal/ebf6bb237e97b-update-listing">Update Listing</a>
53  	 */
54  	@POST
55  	@Path("/updateListing")
56  	Response updateListing(
57  		@FormParam("ticketId") String ticketId,
58  		@FormParam("quantity") Integer quantity,
59  		@FormParam("section") String section,
60  		@FormParam("row") String row,
61  		@FormParam("seatFrom") String seatFrom,
62  		@FormParam("seatThru") String seatThru,
63  		@FormParam("notes") String notes,
64  		@FormParam("price") BigDecimal price,
65  		@FormParam("electronic") Boolean electronic,
66  		@FormParam("inHandDate") String inHandDate,
67  		@FormParam("splitType") SplitType splitType,
68  		@FormParam("splitValue") String splitValue,
69  		@FormParam("barcode") List<String> barcode,
70  		@FormParam("faceValue") BigDecimal faceValue,
71  		@FormParam("unitTaxedCost") BigDecimal unitTaxedCost
72  	) throws IOException, VividSeatsException;
73  
74  }