BokaMera.API.Host

<back to all web services

ExtendBookingReservation

The following routes are available for this service:
PUT/bookingreservations/{SessionKey}/extendExtend a booking reservation holdPushes the hold expiration of an AwaitingPayment reservation forward (bounded, never past the slot start) so the customer can retry a failed Stripe payment without losing the slot. The slot availability is re-checked; if it was taken in the meantime the request is rejected with Conflict.
import java.math.*;
import java.util.*;
import java.io.InputStream;
import net.servicestack.client.*;

public class dtos
{

    @ApiResponse(Description="You were unauthorized to call this service", StatusCode=401)
    // @ApiResponse(Description="No reservation found for the given session key", StatusCode=404)
    // @ApiResponse(Description="The reservation is not awaiting payment or the selected slot is no longer available", StatusCode=409)
    public static class ExtendBookingReservation implements ICompany
    {
        /**
        * The opaque session key that identifies the reservation.
        */
        @ApiMember(Description="The opaque session key that identifies the reservation.", IsRequired=true, ParameterType="path")
        public UUID SessionKey = null;

        /**
        * The company id, if empty will use the company id for the user you are logged in with.
        */
        @ApiMember(Description="The company id, if empty will use the company id for the user you are logged in with.")
        public UUID CompanyId = null;
        
        public UUID getSessionKey() { return SessionKey; }
        public ExtendBookingReservation setSessionKey(UUID value) { this.SessionKey = value; return this; }
        public UUID getCompanyId() { return CompanyId; }
        public ExtendBookingReservation setCompanyId(UUID value) { this.CompanyId = value; return this; }
    }

    public static class BookingReservationResponse
    {
        /**
        * The opaque session key that identifies the reservation.
        */
        @ApiMember(Description="The opaque session key that identifies the reservation.")
        public UUID SessionKey = null;

        /**
        * The company id.
        */
        @ApiMember(Description="The company id.")
        public UUID CompanyId = null;

        /**
        * The reserved service id.
        */
        @ApiMember(Description="The reserved service id.")
        public Integer ServiceId = null;

        /**
        * The reservation start.
        */
        @ApiMember(Description="The reservation start.")
        public Date From = null;

        /**
        * The reservation end.
        */
        @ApiMember(Description="The reservation end.")
        public Date To = null;

        /**
        * The BookingReservationStatus value.
        */
        @ApiMember(Description="The BookingReservationStatus value.")
        public Integer StatusCode = null;

        /**
        * The BookingReservationStatus name.
        */
        @ApiMember(Description="The BookingReservationStatus name.")
        public String StatusName = null;

        /**
        * When the hold expires (company-local time).
        */
        @ApiMember(Description="When the hold expires (company-local time).")
        public Date ExpirationDatetime = null;

        /**
        * Number of reserved spots.
        */
        @ApiMember(Description="Number of reserved spots.")
        public Integer NumberOfBookedSpots = null;

        /**
        * The computed price of the reservation, if any.
        */
        @ApiMember(Description="The computed price of the reservation, if any.")
        public BigDecimal Price = null;

        /**
        * The currency of the price, if any.
        */
        @ApiMember(Description="The currency of the price, if any.")
        public String CurrencyId = null;

        /**
        * Ids of the resources held by the reservation.
        */
        @ApiMember(Description="Ids of the resources held by the reservation.")
        public ArrayList<Integer> ResourceIds = new ArrayList<Integer>();

        /**
        * The full in-progress selection payload (wizard/session state) as JSON.
        */
        @ApiMember(Description="The full in-progress selection payload (wizard/session state) as JSON.")
        public String SelectionPayload = null;

        public ResponseStatus ResponseStatus = null;
        
        public UUID getSessionKey() { return SessionKey; }
        public BookingReservationResponse setSessionKey(UUID value) { this.SessionKey = value; return this; }
        public UUID getCompanyId() { return CompanyId; }
        public BookingReservationResponse setCompanyId(UUID value) { this.CompanyId = value; return this; }
        public Integer getServiceId() { return ServiceId; }
        public BookingReservationResponse setServiceId(Integer value) { this.ServiceId = value; return this; }
        public Date getFrom() { return From; }
        public BookingReservationResponse setFrom(Date value) { this.From = value; return this; }
        public Date getTo() { return To; }
        public BookingReservationResponse setTo(Date value) { this.To = value; return this; }
        public Integer getStatusCode() { return StatusCode; }
        public BookingReservationResponse setStatusCode(Integer value) { this.StatusCode = value; return this; }
        public String getStatusName() { return StatusName; }
        public BookingReservationResponse setStatusName(String value) { this.StatusName = value; return this; }
        public Date getExpirationDatetime() { return ExpirationDatetime; }
        public BookingReservationResponse setExpirationDatetime(Date value) { this.ExpirationDatetime = value; return this; }
        public Integer getNumberOfBookedSpots() { return NumberOfBookedSpots; }
        public BookingReservationResponse setNumberOfBookedSpots(Integer value) { this.NumberOfBookedSpots = value; return this; }
        public BigDecimal getPrice() { return Price; }
        public BookingReservationResponse setPrice(BigDecimal value) { this.Price = value; return this; }
        public String getCurrencyId() { return CurrencyId; }
        public BookingReservationResponse setCurrencyId(String value) { this.CurrencyId = value; return this; }
        public ArrayList<Integer> getResourceIds() { return ResourceIds; }
        public BookingReservationResponse setResourceIds(ArrayList<Integer> value) { this.ResourceIds = value; return this; }
        public String getSelectionPayload() { return SelectionPayload; }
        public BookingReservationResponse setSelectionPayload(String value) { this.SelectionPayload = value; return this; }
        public ResponseStatus getResponseStatus() { return ResponseStatus; }
        public BookingReservationResponse setResponseStatus(ResponseStatus value) { this.ResponseStatus = value; return this; }
    }

}

Java ExtendBookingReservation DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .other suffix or ?format=other

HTTP + OTHER

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PUT /bookingreservations/{SessionKey}/extend HTTP/1.1 
Host: testapi.bokamera.se 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"CompanyId":"00000000-0000-0000-0000-000000000000"}
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

{"ServiceId":0,"StatusCode":0,"StatusName":"String","NumberOfBookedSpots":0,"Price":0,"CurrencyId":"String","ResourceIds":[0],"SelectionPayload":"String","ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}