BokaMera.API.Host

<back to all web services

CreateRecurringSchedule

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin
The following routes are available for this service:
POST/schedules/recurringAdd new recurring scheduleAdd new recurring schedule to the company for the currently logged in user, only administrators are allowed to add schedules.
"use strict";
export class DayOfWeekDto {
    /** @param {{DayOfWeekId?:number,DotNetDayOfWeekId?:number,DayOfWeek?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {number} */
    DayOfWeekId;
    /** @type {number} */
    DotNetDayOfWeekId;
    /** @type {string} */
    DayOfWeek;
}
export class ScheduleResources {
    /** @param {{Id?:number,Name?:string,ImageUrl?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {number} */
    Id;
    /**
     * @type {string}
     * @description Name of the resource */
    Name;
    /**
     * @type {string}
     * @description The image url of the resource */
    ImageUrl;
}
export class ScheduleServices {
    /** @param {{Id?:number,Name?:string,ImageUrl?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {number} */
    Id;
    /**
     * @type {string}
     * @description Name of the service */
    Name;
    /**
     * @type {string}
     * @description The image url of the service */
    ImageUrl;
}
export class RecurringScheduleExceptionResponse {
    /** @param {{StartTime?:string,EndTime?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description Start time of the schedule exception. */
    StartTime;
    /**
     * @type {string}
     * @description End time of the schedule exception. */
    EndTime;
}
export class RecurringScheduleDateResponse {
    /** @param {{Id?:number,Date?:string,StartTime?:string,EndTime?:string,ResponseStatus?:ResponseStatus}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {number} */
    Id;
    /** @type {string} */
    Date;
    /** @type {string} */
    StartTime;
    /** @type {string} */
    EndTime;
    /** @type {ResponseStatus} */
    ResponseStatus;
}
export class RecurringScheduleQueryResponse {
    /** @param {{Id?:number,Name?:string,Description?:string,Active?:boolean,TimeInterval?:number,ValidFrom?:string,ValidTo?:string,StartTime?:string,EndTime?:string,NumberOfScheduleDays?:number,IsResourceSpecific?:boolean,UpdatedDate?:string,CreatedDate?:string,EnableBookingUntilClosingTime?:boolean,DaysOfWeek?:DayOfWeekDto[],Resources?:ScheduleResources[],Services?:ScheduleServices[],Exceptions?:RecurringScheduleExceptionResponse[],ScheduleDates?:RecurringScheduleDateResponse[],ResponseStatus?:ResponseStatus}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description The schedule id */
    Id;
    /**
     * @type {string}
     * @description Name of the schedule */
    Name;
    /**
     * @type {string}
     * @description Description of the schedule */
    Description;
    /**
     * @type {boolean}
     * @description If the schedule is active or not */
    Active;
    /**
     * @type {number}
     * @description Time interval for available times Here you set the interval at which times should appear. For example, if you select the range 15minutes, and your service has an duration of 1 hour and opening hours are 9AM to 6PM you will see the following suggested times: 09AM-10PM 09:15AM-10:15PM, 09:30AM-10:30PM ,  ..... 04:45PM-05:45, 05:00PM-06:00PM */
    TimeInterval;
    /**
     * @type {string}
     * @description The timestamp to which the schedule is valid from */
    ValidFrom;
    /**
     * @type {string}
     * @description The timestamp to which the schedule is valid to */
    ValidTo;
    /**
     * @type {string}
     * @description The time for the schedule opening hours (starttime) */
    StartTime;
    /**
     * @type {string}
     * @description The time for the schedule opening hours (endtime) */
    EndTime;
    /**
     * @type {number}
     * @description The number of days the schedule is valid from todays date */
    NumberOfScheduleDays;
    /**
     * @type {boolean}
     * @description If the schedule is only connected to some specific resources. Note: You must have IncludeResources property to see this. */
    IsResourceSpecific;
    /**
     * @type {string}
     * @description The timestamp when the schedule was updated */
    UpdatedDate;
    /**
     * @type {string}
     * @description The timestamp when the schedule was created */
    CreatedDate;
    /**
     * @type {boolean}
     * @description Allow bookings end time exceeds the opening hours Here you can choose whether it should be possible to make a reservation exceeding the opening hours. This should be ticked when a service duration is longer than 24 hours (possible to book over midnight). */
    EnableBookingUntilClosingTime;
    /**
     * @type {DayOfWeekDto[]}
     * @description If recurring, an array indicating which days of the week the exception recures on where 1 = Monday .. 7 = Sunday. When recurring then the time portion of the Fields From and To indicates the time of day the recurrence occurs */
    DaysOfWeek;
    /**
     * @type {ScheduleResources[]}
     * @description The resources that is connected to the schedule */
    Resources;
    /**
     * @type {ScheduleServices[]}
     * @description The services that is connected to the schedule */
    Services;
    /**
     * @type {RecurringScheduleExceptionResponse[]}
     * @description The exceptions that is added to the schedule */
    Exceptions;
    /**
     * @type {RecurringScheduleDateResponse[]}
     * @description Schedule dates, used when the schedule is not a rolling schedule using days of week */
    ScheduleDates;
    /** @type {ResponseStatus} */
    ResponseStatus;
}
export class AddRecurringScheduleDate {
    /** @param {{Date?:string,StartTime?:string,EndTime?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description The date for the schedule opening (only date part is used here */
    Date;
    /**
     * @type {string}
     * @description The time for the schedule opening hours (starttime) */
    StartTime;
    /**
     * @type {string}
     * @description The time for the schedule opening hours (endtime) */
    EndTime;
}
export class ScheduleException {
    /** @param {{StartTime?:string,EndTime?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {string} */
    StartTime;
    /** @type {string} */
    EndTime;
}
export class AddScheduleResource {
    /** @param {{Id?:number}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description The resource id */
    Id;
}
export class AddScheduleService {
    /** @param {{Id?:number}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description The service id */
    Id;
}
export class CreateRecurringSchedule {
    /** @param {{CompanyId?:string,Name?:string,Description?:string,Active?:boolean,TimeInterval?:number,EnableBookingUntilClosingTime?:boolean,ValidFrom?:string,ValidTo?:string,StartTime?:string,EndTime?:string,NumberOfScheduleDays?:number,DaysOfWeek?:number[],ScheduleDates?:AddRecurringScheduleDate[],Exceptions?:ScheduleException[],Resources?:AddScheduleResource[],Services?:AddScheduleService[]}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {?string}
     * @description The company id, if empty will use the company id for the user you are logged in with. */
    CompanyId;
    /**
     * @type {string}
     * @description The schedule name */
    Name;
    /**
     * @type {string}
     * @description The schedule description */
    Description;
    /**
     * @type {boolean}
     * @description If schedule is active or not */
    Active;
    /**
     * @type {number}
     * @description Time interval for available times. Here you set the interval at which times should appear. For example, if you select the range 15minutes, and your service has an duration of 1 hour and opening hours are 9AM to 6PM you will see the following suggested times: 09AM-10PM 09:15AM-10:15PM, 09:30AM-10:30PM ,  ..... 04:45PM-05:45, 05:00PM-06:00PM */
    TimeInterval;
    /**
     * @type {boolean}
     * @description Allow bookings end time exceeds the opening hours Here you can choose whether it should be possible to make a reservation exceeding the opening hours. This should be ticked when a service duration is longer than 24 hours (possible to book over midnight). */
    EnableBookingUntilClosingTime;
    /**
     * @type {string}
     * @description The timestamp to which the schedule is valid from */
    ValidFrom;
    /**
     * @type {string}
     * @description The timestamp to which the schedule is valid to */
    ValidTo;
    /**
     * @type {string}
     * @description The time for the schedule opening hours (starttime) */
    StartTime;
    /**
     * @type {string}
     * @description The time for the schedule opening hours (endtime) */
    EndTime;
    /**
     * @type {number}
     * @description The number of days the schedule is valid from todays date */
    NumberOfScheduleDays;
    /**
     * @type {number[]}
     * @description If recurring, an array indicating which days of the week the schedule recures on where 1 = Monday .. 7 = Sunday. When recurring then the time portion of the Fields From and To indicates the time of day the recurrence occurs */
    DaysOfWeek;
    /**
     * @type {AddRecurringScheduleDate[]}
     * @description If not recuring, an array indicating which dates that are open for the schedule. */
    ScheduleDates;
    /**
     * @type {ScheduleException[]}
     * @description Schedule exceptions. For example closed on lunch time between 12AM and 1PM. These times will be removed from the recurring schedule. */
    Exceptions;
    /**
     * @type {AddScheduleResource[]}
     * @description If the schedule is only connected to some resources, add them here. If empty, it will be used by all resources. */
    Resources;
    /**
     * @type {AddScheduleService[]}
     * @description Set what services the schedule should be connected to. */
    Services;
}

JavaScript CreateRecurringSchedule DTOs

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

HTTP + XML

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

POST /schedules/recurring HTTP/1.1 
Host: api.bokamera.se 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<CreateRecurringSchedule xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <Active>false</Active>
  <CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
  <DaysOfWeek xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:int>0</d2p1:int>
  </DaysOfWeek>
  <Description>String</Description>
  <EnableBookingUntilClosingTime>false</EnableBookingUntilClosingTime>
  <EndTime>PT0S</EndTime>
  <Exceptions>
    <ScheduleException>
      <EndTime>PT0S</EndTime>
      <StartTime>PT0S</StartTime>
    </ScheduleException>
  </Exceptions>
  <Name>String</Name>
  <NumberOfScheduleDays>0</NumberOfScheduleDays>
  <Resources>
    <AddScheduleResource>
      <Id>0</Id>
    </AddScheduleResource>
  </Resources>
  <ScheduleDates>
    <AddRecurringScheduleDate>
      <Date>0001-01-01T00:00:00</Date>
      <EndTime>PT0S</EndTime>
      <StartTime>PT0S</StartTime>
    </AddRecurringScheduleDate>
  </ScheduleDates>
  <Services>
    <AddScheduleService>
      <Id>0</Id>
    </AddScheduleService>
  </Services>
  <StartTime>PT0S</StartTime>
  <TimeInterval>0</TimeInterval>
  <ValidFrom>0001-01-01T00:00:00</ValidFrom>
  <ValidTo>0001-01-01T00:00:00</ValidTo>
</CreateRecurringSchedule>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<RecurringScheduleQueryResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <Active>false</Active>
  <CreatedDate>0001-01-01T00:00:00</CreatedDate>
  <DaysOfWeek>
    <DayOfWeekDto>
      <DayOfWeek>String</DayOfWeek>
      <DayOfWeekId>0</DayOfWeekId>
      <DotNetDayOfWeekId>0</DotNetDayOfWeekId>
    </DayOfWeekDto>
  </DaysOfWeek>
  <Description>String</Description>
  <EnableBookingUntilClosingTime>false</EnableBookingUntilClosingTime>
  <EndTime>PT0S</EndTime>
  <Exceptions>
    <RecurringScheduleExceptionResponse>
      <EndTime>PT0S</EndTime>
      <StartTime>PT0S</StartTime>
    </RecurringScheduleExceptionResponse>
  </Exceptions>
  <Id>0</Id>
  <IsResourceSpecific>false</IsResourceSpecific>
  <Name>String</Name>
  <NumberOfScheduleDays>0</NumberOfScheduleDays>
  <Resources>
    <ScheduleResources>
      <Id>0</Id>
      <ImageUrl i:nil="true" />
      <Name>String</Name>
    </ScheduleResources>
  </Resources>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
  <ScheduleDates>
    <RecurringScheduleDateResponse>
      <Date>0001-01-01T00:00:00</Date>
      <EndTime>PT0S</EndTime>
      <Id>0</Id>
      <ResponseStatus xmlns:d4p1="http://schemas.servicestack.net/types">
        <d4p1:ErrorCode>String</d4p1:ErrorCode>
        <d4p1:Message>String</d4p1:Message>
        <d4p1:StackTrace>String</d4p1:StackTrace>
        <d4p1:Errors>
          <d4p1:ResponseError>
            <d4p1:ErrorCode>String</d4p1:ErrorCode>
            <d4p1:FieldName>String</d4p1:FieldName>
            <d4p1:Message>String</d4p1:Message>
            <d4p1:Meta xmlns:d7p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
              <d7p1:KeyValueOfstringstring>
                <d7p1:Key>String</d7p1:Key>
                <d7p1:Value>String</d7p1:Value>
              </d7p1:KeyValueOfstringstring>
            </d4p1:Meta>
          </d4p1:ResponseError>
        </d4p1:Errors>
        <d4p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d4p1:Meta>
      </ResponseStatus>
      <StartTime>PT0S</StartTime>
    </RecurringScheduleDateResponse>
  </ScheduleDates>
  <Services>
    <ScheduleServices>
      <Id>0</Id>
      <ImageUrl i:nil="true" />
      <Name>String</Name>
    </ScheduleServices>
  </Services>
  <StartTime>PT0S</StartTime>
  <TimeInterval>0</TimeInterval>
  <UpdatedDate>0001-01-01T00:00:00</UpdatedDate>
  <ValidFrom>0001-01-01T00:00:00</ValidFrom>
  <ValidTo>0001-01-01T00:00:00</ValidTo>
</RecurringScheduleQueryResponse>