BokaMera.API.Host

<back to all web services

CreateResource

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin
The following routes are available for this service:
POST/resourceAdd a new resourceAdd a new resource to the company of the currently logged in user, only administrators are allowed to add resources.
"use strict";
export class TimeException {
    /** @param {{Id?:number,IsRecurring?:boolean,IsBlock?:boolean,ReasonText?:string,ReasonTextPublic?:string,From?:string,To?:string,ResourceIds?:number[]}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description Time exception id */
    Id;
    /**
     * @type {boolean}
     * @description Indicates whether or not the time exception is recurring */
    IsRecurring;
    /**
     * @type {boolean}
     * @description Indicates whether the time exception is blocking the time or not */
    IsBlock;
    /**
     * @type {string}
     * @description The reason of the time exception, example: Vacation, doctors appointment, ... */
    ReasonText;
    /**
     * @type {string}
     * @description The public reason of the time exception, example: Vacation, doctors appointment, ... */
    ReasonTextPublic;
    /**
     * @type {string}
     * @description Time exception start */
    From;
    /**
     * @type {string}
     * @description Time exception end */
    To;
    /**
     * @type {number[]}
     * @description Resources that owns this exception */
    ResourceIds;
}
/** @typedef {number} */
export var BookingStatusEnum;
(function (BookingStatusEnum) {
    BookingStatusEnum[BookingStatusEnum["Booked"] = 1] = "Booked"
    BookingStatusEnum[BookingStatusEnum["Unbooked"] = 2] = "Unbooked"
    BookingStatusEnum[BookingStatusEnum["Reserved"] = 3] = "Reserved"
    BookingStatusEnum[BookingStatusEnum["Canceled"] = 4] = "Canceled"
    BookingStatusEnum[BookingStatusEnum["AwaitingPayment"] = 5] = "AwaitingPayment"
    BookingStatusEnum[BookingStatusEnum["AwaitingPaymentNoTimeLimit"] = 6] = "AwaitingPaymentNoTimeLimit"
    BookingStatusEnum[BookingStatusEnum["Payed"] = 7] = "Payed"
    BookingStatusEnum[BookingStatusEnum["AwaitingPaymentRequestFromAdmin"] = 8] = "AwaitingPaymentRequestFromAdmin"
    BookingStatusEnum[BookingStatusEnum["AwaitingPaymentFromProvider"] = 9] = "AwaitingPaymentFromProvider"
    BookingStatusEnum[BookingStatusEnum["Invoiced"] = 10] = "Invoiced"
})(BookingStatusEnum || (BookingStatusEnum = {}));
export class BookedCustomer {
    /** @param {{Id?:string,Firstname?:string,Lastname?:string,Email?:string,Phone?:string,FacebookUserName?:string,ImageUrl?:string,CorporateIdentityNumber?:string,InvoiceAddress1?:string,InvoiceAddress2?:string,InvoiceCity?:string,InvoicePostalCode?:string,InvoiceCountryCode?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {string} */
    Id;
    /** @type {string} */
    Firstname;
    /** @type {string} */
    Lastname;
    /** @type {string} */
    Email;
    /** @type {string} */
    Phone;
    /** @type {string} */
    FacebookUserName;
    /** @type {string} */
    ImageUrl;
    /** @type {string} */
    CorporateIdentityNumber;
    /** @type {string} */
    InvoiceAddress1;
    /** @type {string} */
    InvoiceAddress2;
    /** @type {string} */
    InvoiceCity;
    /** @type {string} */
    InvoicePostalCode;
    /** @type {string} */
    InvoiceCountryCode;
}
export class BookedTime {
    /** @param {{Id?:number,ServiceId?:number,From?:string,To?:string,BookedSpots?:number,TotalSpots?:number,PauseAfterInMinutes?:number,StatusId?:number,Status?:BookingStatusEnum,Customer?:BookedCustomer}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description Booking id */
    Id;
    /**
     * @type {number}
     * @description The booked service */
    ServiceId;
    /**
     * @type {string}
     * @description Booking start */
    From;
    /**
     * @type {string}
     * @description Booking end */
    To;
    /**
     * @type {number}
     * @description Number of booked spots */
    BookedSpots;
    /**
     * @type {number}
     * @description Number of total spots for the service */
    TotalSpots;
    /**
     * @type {number}
     * @description The pause after the booking */
    PauseAfterInMinutes;
    /**
     * @type {number}
     * @description The booking status */
    StatusId;
    /** @type {BookingStatusEnum} */
    Status;
    /**
     * @type {BookedCustomer}
     * @description The customer the booking belongs to */
    Customer;
}
export class ResourceQueryResponse {
    /** @param {{Id?:number,Name?:string,Description?:string,Active?:boolean,Color?:string,Email?:string,ImageUrl?:string,MobilePhone?:string,AccessGroup?:string,EmailNotification?:boolean,SMSNotification?:boolean,SendEmailReminder?:boolean,SendSMSReminder?:boolean,Exceptions?:TimeException[],Bookings?:BookedTime[],Created?:string,Updated?:string,ResponseStatus?:ResponseStatus}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description The resource id */
    Id;
    /**
     * @type {string}
     * @description The resource name */
    Name;
    /**
     * @type {string}
     * @description The resource description */
    Description;
    /**
     * @type {boolean}
     * @description If resource is active or not */
    Active;
    /**
     * @type {string}
     * @description The resource color in scheduler in hexadecimal color code. Example: #00b0f0 for blue. */
    Color;
    /**
     * @type {string}
     * @description The email of the resource */
    Email;
    /**
     * @type {string}
     * @description The image url of the resource */
    ImageUrl;
    /**
     * @type {string}
     * @description The mobile phone number of the resource */
    MobilePhone;
    /**
     * @type {string}
     * @description Used by example code locks to know what access group the resource is assigned to */
    AccessGroup;
    /**
     * @type {boolean}
     * @description If the resource should receive email notification when booked */
    EmailNotification;
    /**
     * @type {boolean}
     * @description If the resource should receive SMS notification when booked */
    SMSNotification;
    /**
     * @type {?boolean}
     * @description If the resource should receive email reminders on bookings */
    SendEmailReminder;
    /**
     * @type {?boolean}
     * @description If the resource should receive SMS reminders on bookings */
    SendSMSReminder;
    /**
     * @type {TimeException[]}
     * @description The resource time exceptions */
    Exceptions;
    /**
     * @type {BookedTime[]}
     * @description The resource bookings */
    Bookings;
    /**
     * @type {string}
     * @description Then date when the resource was created */
    Created;
    /**
     * @type {string}
     * @description Then date when the resource was updated */
    Updated;
    /** @type {ResponseStatus} */
    ResponseStatus;
}
export class AddCustomField {
    /** @param {{Id?:number,Value?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {number} */
    Id;
    /** @type {string} */
    Value;
}
export class CreateResource {
    /** @param {{CompanyId?:string,Name?:string,Description?:string,Active?:boolean,Color?:string,Email?:string,ImageUrl?:string,AccessGroup?:string,MobilePhone?:string,EmailNotification?:boolean,SMSNotification?:boolean,SendEmailReminder?:boolean,SendSMSReminder?:boolean,CustomFields?:AddCustomField[]}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description Enter the company id, if blank company id and you are an admin, your company id will be used. */
    CompanyId;
    /**
     * @type {string}
     * @description The resource name */
    Name;
    /**
     * @type {string}
     * @description The resource description */
    Description;
    /**
     * @type {boolean}
     * @description If resource is active or not. Default is active. */
    Active;
    /**
     * @type {string}
     * @description The resource color in scheduler */
    Color;
    /**
     * @type {string}
     * @description The email of the resource */
    Email;
    /**
     * @type {string}
     * @description The image url of the resource */
    ImageUrl;
    /**
     * @type {string}
     * @description Used by example code locks to know what access group the resource is assigned to */
    AccessGroup;
    /**
     * @type {string}
     * @description The mobile phone number of the resource */
    MobilePhone;
    /**
     * @type {?boolean}
     * @description If the resource should receive email notification when booked */
    EmailNotification;
    /**
     * @type {?boolean}
     * @description If the resource should receive SMS notification when booked */
    SMSNotification;
    /**
     * @type {?boolean}
     * @description If the resource should receive email reminders on bookings */
    SendEmailReminder;
    /**
     * @type {?boolean}
     * @description If the resource should receive SMS reminders on bookings */
    SendSMSReminder;
    /**
     * @type {AddCustomField[]}
     * @description If Custom Fields are added to the resource, here you will send the id and the value for each custom field to be saved */
    CustomFields;
}

JavaScript CreateResource DTOs

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

POST /resource HTTP/1.1 
Host: api.bokamera.se 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"CompanyId":"00000000-0000-0000-0000-000000000000","Name":"String","Description":"String","Active":false,"Color":"String","Email":"String","AccessGroup":"String","MobilePhone":"String","EmailNotification":false,"SMSNotification":false,"SendEmailReminder":false,"SendSMSReminder":false,"CustomFields":[{"Id":0,"Value":"String"}]}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"Id":0,"Name":"String","Description":"String","Active":false,"Color":"String","Email":"String","MobilePhone":"String","AccessGroup":"String","EmailNotification":false,"SMSNotification":false,"SendEmailReminder":false,"SendSMSReminder":false,"Exceptions":[{"Id":0,"IsRecurring":false,"IsBlock":false,"ReasonText":"String","ReasonTextPublic":"String","ResourceIds":[0]}],"Bookings":[{"Id":0,"ServiceId":0,"BookedSpots":0,"TotalSpots":0,"PauseAfterInMinutes":0,"StatusId":0,"Status":"Booked","Customer":{"Firstname":"String","Lastname":"String","Email":"String","Phone":"String","FacebookUserName":"String","ImageUrl":"String","CorporateIdentityNumber":"String","InvoiceAddress1":"String","InvoiceAddress2":"String","InvoiceCity":"String","InvoicePostalCode":"String","InvoiceCountryCode":"String"}}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}