Interface SellerListingResource


@Path("/{version}") public interface SellerListingResource
  • Method Details

    • getSellerListing

      @GET @Path("/sellerlistings/{listingId}") SellerListing getSellerListing(@PathParam("listingId") Long listingId) throws IOException, ViagogoException
      Parameters:
      listingId - the listing ID.
      Returns:
      the seller listing of the specified listing ID.
      Throws:
      IOException - indicates I/O exception
      ViagogoException - indicates business exception
    • getSellerListingsRecentUpdates

      @GET @Path("/sellerlistings/recentupdates") PagedResource<SellerListing> getSellerListingsRecentUpdates(@QueryParam("updated_since") Instant updatedSince) throws IOException, ViagogoException
      List seller listings (recent updates)

      List seller listings for the authenticated user that have been created or updated over a certain period of time.

      Parameters:
      updatedSince - Filters the response to only return items that have been updated since the given timestamp
      Returns:
      recent updates
      Throws:
      IOException - indicates I/O exception
      ViagogoException - indicates business exception
    • getSellerListings

      @GET @Path("/sellerlistings") PagedResource<SellerListing> getSellerListings(@QueryParam("event_id") Long eventId, @QueryParam("requested_event_id") String requestedEventId, @QueryParam("page") Integer page, @QueryParam("page_size") Integer pageSize, @QueryParam("updated_since") Instant updatedSince, @QueryParam("sort") String sort) throws IOException, ViagogoException
      List seller listings

      List seller listings for the authenticated user.

      Parameters:
      eventId - the event ID.
      requestedEventId - the requested event ID.
      page - Specifies which page of data to retrieve.
      pageSize - Set custom page sizes on response.
      updatedSince - Filters the response to only return items that have been updated since the given timestamp
      sort - Determines the ordering of items. A comma-separated string containing available_tickets, created_at, event_date, event_name, expiration_date, price, resource_version, or ticket_availability_date.
      Returns:
      seller listings
      Throws:
      IOException - indicates I/O exception
      ViagogoException - indicates business exception
    • createListingForRequestedEvent

      @POST @Path("/sellerlistings") @Produces("application/json") @Consumes("application/json") SellerListing createListingForRequestedEvent(CreateSellerListingRequest createSellerListingRequest) throws IOException, ViagogoException
      Parameters:
      createSellerListingRequest - PostRequestedEventSellerListingRequest
      Returns:
      SellerListing
      Throws:
      IOException - indicates I/O exception
      ViagogoException - indicates business exception
    • createListing

      @POST @Path("/events/{eventId}/sellerlistings") @Produces("application/json") @Consumes("application/json") SellerListing createListing(@PathParam("eventId") Long eventId, CreateSellerListingRequest createSellerListingRequest) throws IOException, ViagogoException
      Parameters:
      eventId - the event ID.
      createSellerListingRequest - the request.
      Returns:
      the created seller listing.
      Throws:
      IOException - indicates I/O exception
      ViagogoException - indicates business exception
    • getSellerListingByExternalId

      @GET @Path("/externalsellerlistings/{externalListingId}") SellerListing getSellerListingByExternalId(@PathParam("externalListingId") String externalListingId) throws IOException, ViagogoException
      Parameters:
      externalListingId - the external listing ID.
      Returns:
      the seller listing.
      Throws:
      IOException - indicates I/O exception
      ViagogoException - indicates business exception
    • deleteListingByExternalListingId

      @DELETE @Path("/externalsellerlistings/{externalId}") void deleteListingByExternalListingId(@PathParam("externalId") String externalId) throws IOException, ViagogoException
      Delete a seller listing by external ID

      Delete a seller listing by identifier that has been assigned to the listing in an external inventory management system.

      Parameters:
      externalId - An identifier that has been assigned to the listing in an external inventory management system.
      Throws:
      IOException - indicates I/O exception
      ViagogoException - indicates business exception