Interface SellerListingResource
@Path("/{version}")
public interface SellerListingResource
-
Method Summary
Modifier and TypeMethodDescriptioncreateListing
(Long eventId, CreateSellerListingRequest createSellerListingRequest) createListingForRequestedEvent
(CreateSellerListingRequest createSellerListingRequest) void
deleteListingByExternalListingId
(String externalId) getSellerListing
(Long listingId) getSellerListingByExternalId
(String externalListingId) getSellerListings
(Long eventId, String requestedEventId, Integer page, Integer pageSize, Instant updatedSince, String sort) getSellerListingsRecentUpdates
(Instant updatedSince) List seller listings (recent updates)
-
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 exceptionViagogoException
- 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 exceptionViagogoException
- 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 listingsList 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 timestampsort
- Determines the ordering of items. A comma-separated string containingavailable_tickets
,created_at
,event_date
,event_name
,expiration_date
,price
,resource_version
, orticket_availability_date
.- Returns:
- seller listings
- Throws:
IOException
- indicates I/O exceptionViagogoException
- 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 exceptionViagogoException
- 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 exceptionViagogoException
- 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 exceptionViagogoException
- indicates business exception
-
deleteListingByExternalListingId
@DELETE @Path("/externalsellerlistings/{externalId}") void deleteListingByExternalListingId(@PathParam("externalId") String externalId) throws IOException, ViagogoException Delete a seller listing by external IDDelete 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 exceptionViagogoException
- indicates business exception
-