BokaMera.API.Host

CurrentUserQuery

The following routes are available for this service:
GET	/users	Get user information	Get information about the currently logged in user

**CurrentUserQuery** Parameters:
Name	Parameter	Data Type	Required	Description
IncludeFavorites	query	boolean	No	If you want to include the users favorites
IncludeCompanyCustomers	query	bool	No

**CurrentUserQueryResponse** Parameters:
Name	Parameter	Data Type	Required	Description
UserId	form	Guid	No	The user id for your profile.
Favorites	form	List<UserFavorites>	Yes
UserProfile	form	UserProfileResponse	Yes
CustomerProfile	form	UserProfileResponse	Yes
AdminProfile	form	AdminProfile	Yes
CompanyCustomers	form	List<CompanyCustomerResponse>	Yes

**UserFavorites** Parameters:
Name	Parameter	Data Type	Required	Description
CompanyId	form	Guid	No
Company	form	CompanyQueryResponse	Yes

**CompanyQueryResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	Guid	No
Name	form	string	No
OrganisationNumber	form	string	No	The organisation number will only be visible if your owner to the company
TypeId	form	int	No	What type of company. If it's used for personal use or as a company.
Details	form	string	No
CategoryId	form	int	No
Category	form	string	No
LogoType	form	Uri	No
CoverImage	form	Uri	No
Street1	form	string	No
Street2	form	string	No
ZipCode	form	string	No
City	form	string	No
CountryId	form	string	No
Longitude	form	string	No
Latitude	form	string	No
Distance	form	double?	No
Phone	form	string	No
Email	form	string	No
Homepage	form	string	No
SitePath	form	string	No
Active	form	bool	No
CodeLockSystem	form	CodeLockSystemType?	No
IsFreeAccount	form	bool	No
Updated	form	datetime	No	Will show when the company was updated, note it will only be shown if your logged in as admin for the company.
Created	form	datetime	No	Will show when the company was created, note it will only be shown if your logged in as admin for the company.
StatusId	form	int	No
IsFavorite	form	boolean	No	If the company is marked as favourite for the logged in user
BookingAgreements	form	string	No
BookingSettings	form	CompanyBookingSettings	No
SystemSettings	form	CompanySystemSettings	No
WidgetSettings	form	CompanyWidgetSettings	No
HomepageSettings	form	HomepageSettingsResponse	No
RatingSummary	form	CompanyRatingSummary	No
Reviews	form	List<RatingReviewResponse>	No
CustomerCustomFields	form	List<CustomFieldConfigData>	No
ResponseStatus	form	ResponseStatus	No

**CodeLockSystemType** Enum:
Sample
RcoM5
AxemaVaka
VanderbiltOmnis
ParakeyParakey
AmidoDax
TelkeyTelkey
TechSolutionsSiedle
Accessy
Zesec
Enabla

**CompanyBookingSettings** Parameters:
Name	Parameter	Data Type	Required	Description
EnableMobileApp	form	bool	No
BookingReceiptMessage	form	string	No
ShowFreeTimesLeft	form	bool	No
EnableShowBookedTimes	form	bool	No
BookingAgreement	form	string	No
WeekNumberSetting	form	int	No	The settings for how to display week number. 1 = ShowWeekNumberFromDate, 2 = ShowWeekNumberToDate, 3 = ShowWeekNumberFromToDate, 4 = DontShowWeekNumber
ShowBookedTimes	form	bool	No
PaymentProviderId	form	int	No	The payment provider id. 1 = Payson Checkout 1.0, 2= Payson Checkout 2.0 ... To get the full payment provider for the company call GET /payment/settings
BookOnlyOnExistingCustomers	form	boolean	No	If it's only allowed for existing customers to book
PaymentEnabled	form	boolean	No	If payment is enabled

**CompanySystemSettings** Parameters:
Name	Parameter	Data Type	Required	Description
Active	form	bool	No	If the booking is active or not
InactiveMessage	form	string	No	If the booking is not active, what message to show to the customers
Searchable	form	bool	No	If the company should be visible in search results on hompage
GATrackingId	form	string	No	If you have a google analytics account and want to track your customers behaviors.
GoogleAdsConversionId	form	string	No	If you have a google Ads Conversion Id account and want to track your customers behaviors.
LinkedinTagId	form	string	No	If you have a LinkedIn account and want to track your customers behaviors.
GoogleAdsConversionLabel	form	string	No	If you have a Google Ads Conversion Label and want to track your customers behaviors.
GTMTrackingId	form	string	No	If you have a google tag manager account and want to track your customers behaviors.
FacebookPixelId	form	string	No	If you have a facebook account and want to track your customers behaviors.
MultiLanguage	form	bool	No	If you want your customers to be albe to change language on your homepage
ShowOnMarketplace	form	bool	No	If the company should be visible on the marketplace
EnableAPITranslation	form	bool	No	If you want your own written text on your homepage to be translated using google analytics when a user changes language
DefaultLanguage	form	string	No	What is the standard language your homepage information is written in. Select from the different countries, ie. SE,NO,EN
SendCustomerInformationToExternalProviders	form	bool	No	If you want to allow to send customer information in the tracking events to the external providers. Note you as a company are responsible for informing your customers and handling the data in terms of GDPR.

**CompanyWidgetSettings** Parameters:
Name	Parameter	Data Type	Required	Description
ServiceLayoutId	form	int	No	The service layouts id.
TimeLayoutId	form	int	No	The time layouts id.
BookingLayoutId	form	int	No	The booking layouts id.
PrimaryColor	form	string	No	The primary color of the booking widget.
ShowServiceImage	form	bool	No	If you should show the service image in the booking widget.
ShowRebateCodeField	form	bool	No	If you should show the rebate code field in the booking widget.
ShowNextAvailableTime	form	bool	No	If you should show the next available time in the booking widget.
ShowEndTime	form	bool	No	If you should show the end time in the booking widget.
BookedTimeSlotText	form	string	No	What text to show on booked time slots. Default text is Booked
DarkTheme	form	bool	No	If the widget should be displayed in dark theme
ShowSubscribeToNewsletter	form	bool	No	If you should show the subscribe to newsletter checkbox in the booking widget.

**HomepageSettingsResponse** Parameters:
Name	Parameter	Data Type	Required	Description
HomepageHeading	form	string	No	The text for homepage heading
WelcomePageHeading	form	string	No	The text for homepage startpage heading
WelcomePageBody	form	string	No	The text for homepage startpage body
AboutUsPageHeading	form	string	No	The text for homepage about us page heading
AboutUsPageBody	form	string	No	The text for homepage about us page body
ImageUrl	form	Uri	No	The startpage image url
CoverImage	form	Uri	No	The cover image url
ShowRating	form	bool	No	Show rating on the page
HomePageTemplateId	form	int	No	The template for the homepage
HeroSectionStyleId	form	int	No	The hero section style for the homepage
EnableHomepage	form	bool	No	Enable the BokaMera Homepage

**CompanyRatingSummary** Parameters:
Name	Parameter	Data Type	Required	Description
AverageScore	form	double	No	The average rating score
RatingScore1Count	form	int	No	The number of ratings of score 1
RatingScore2Count	form	int	No	The number of ratings of score 2
RatingScore3Count	form	int	No	The number of ratings of score 3
RaingScore4Count	form	int	No	The number of ratings of score 4
RatingScore5Count	form	int	No	The number of ratings of score 5
Count	form	int	No	The number of ratings

**RatingReviewResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Title	form	string	No	The title for the review
Description	form	string	No	The description for the review
RatingScore	form	int	No	The rating score
Author	form	string	No	The review author
Created	form	DateTime	No	The created date
ReviewAnswer	form	string	No	The review answer from the company

**CustomFieldConfigData** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	Custom field id
Name	form	string	No	Configuration name. Example: 'Number of persons'.
Description	form	string	No	Custom field description. Example: 'For how many persons is this booking?'
Width	form	int?	No	Field width. Example: 20 for 20px
DataType	form	string	No	Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox'
DefaultValue	form	string	No	Default value of the field. Example: '3'
IsMandatory	form	bool	No	Determines if the field is required to have a value or not
MandatoryErrorMessage	form	string	No	Error message shown to the user if the field data is required but not entered
MaxLength	form	int	No	Max lenght of the field
MultipleLineText	form	bool	No	If the field should have multiple lines
RegEx	form	string	No	Regular expression used for validation of the field
RegExErrorMessage	form	string	No	Error message shown if the regular expression validation failed
Values	form	List<CustomFieldValueResponse>	No	The values to select from if Datatype is DropDown for this custom field

**CustomFieldValueResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Value	form	string	No

**UserProfileResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	Guid	No
Firstname	form	string	Yes
Lastname	form	string	Yes
Phone	form	string	Yes
Email	form	string	Yes

**AdminProfile** Parameters:
Name	Parameter	Data Type	Required
CompanyId	form	Guid	No
Id	form	Guid	No
Firstname	form	string	No
Lastname	form	string	No
Email	form	string	No
WorkerId	form	string	No
Phone	form	string	No

**CompanyCustomerResponse** Parameters:
Name	Parameter	Data Type	Required
CompanyId	form	Guid?	No
CompanyName	form	string	No
CustomerId	form	Guid?	No
SubscribedToNewsletter	form	bool	No
CustomFieldValues	form	List<CustomFieldDataResponse>	Yes

**CustomFieldDataResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No
Column	form	string	No
Name	form	string	No
Description	form	string	No
Value	form	string	No
DataType	form	string	No	Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox'

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

HTTP + JSV

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

GET /users HTTP/1.1 
Host: api.bokamera.se 
Accept: text/jsv

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Favorites: 
	[
		{
			Company: 
			{
				Name: String,
				OrganisationNumber: String,
				TypeId: 0,
				Details: String,
				CategoryId: 0,
				Category: String,
				Street1: String,
				Street2: String,
				ZipCode: String,
				City: String,
				CountryId: String,
				Longitude: String,
				Latitude: String,
				Distance: 0,
				Phone: String,
				Email: String,
				Homepage: String,
				SitePath: String,
				Active: False,
				CodeLockSystem: Sample,
				IsFreeAccount: False,
				Updated: "0001-01-01T00:00:00",
				Created: "0001-01-01T00:00:00",
				StatusId: 0,
				IsFavorite: False,
				BookingAgreements: String,
				BookingSettings: 
				{
					EnableMobileApp: False,
					BookingReceiptMessage: String,
					ShowFreeTimesLeft: False,
					EnableShowBookedTimes: False,
					BookingAgreement: String,
					WeekNumberSetting: 0,
					ShowBookedTimes: False,
					PaymentProviderId: 0,
					BookOnlyOnExistingCustomers: False,
					PaymentEnabled: False
				},
				SystemSettings: 
				{
					Active: False,
					InactiveMessage: String,
					Searchable: False,
					GATrackingId: String,
					GoogleAdsConversionId: String,
					LinkedinTagId: String,
					GoogleAdsConversionLabel: String,
					GTMTrackingId: String,
					FacebookPixelId: String,
					MultiLanguage: False,
					ShowOnMarketplace: False,
					EnableAPITranslation: False,
					DefaultLanguage: String,
					SendCustomerInformationToExternalProviders: False
				},
				WidgetSettings: 
				{
					ServiceLayoutId: 0,
					TimeLayoutId: 0,
					BookingLayoutId: 0,
					PrimaryColor: String,
					ShowServiceImage: False,
					ShowRebateCodeField: False,
					ShowNextAvailableTime: False,
					ShowEndTime: False,
					BookedTimeSlotText: String,
					DarkTheme: False,
					ShowSubscribeToNewsletter: False
				},
				HomepageSettings: 
				{
					HomepageHeading: String,
					WelcomePageHeading: String,
					WelcomePageBody: String,
					AboutUsPageHeading: String,
					AboutUsPageBody: String,
					ShowRating: False,
					HomePageTemplateId: 0,
					HeroSectionStyleId: 0,
					EnableHomepage: False
				},
				RatingSummary: 
				{
					AverageScore: 0,
					RatingScore1Count: 0,
					RatingScore2Count: 0,
					RatingScore3Count: 0,
					RaingScore4Count: 0,
					RatingScore5Count: 0,
					Count: 0
				},
				Reviews: 
				[
					{
						Title: String,
						Description: String,
						RatingScore: 0,
						Author: String,
						ReviewAnswer: String
					}
				],
				CustomerCustomFields: 
				[
					{
						"Id": 0,
						"Name": "String",
						"Description": "String",
						"Width": 0,
						"DataType": "String",
						"DefaultValue": "String",
						"IsMandatory": false,
						"MandatoryErrorMessage": "String",
						"MaxLength": 0,
						"MultipleLineText": false,
						"RegEx": "String",
						"RegExErrorMessage": "String",
						"Values": 
						[
							{
								"Value": "String"
							}
						]
					}
				],
				ResponseStatus: 
				{
					ErrorCode: String,
					Message: String,
					StackTrace: String,
					Errors: 
					[
						{
							ErrorCode: String,
							FieldName: String,
							Message: String,
							Meta: 
							{
								String: String
							}
						}
					],
					Meta: 
					{
						String: String
					}
				}
			}
		}
	],
	UserProfile: 
	{
		Firstname: String,
		Lastname: String,
		Phone: String,
		Email: String
	},
	CustomerProfile: 
	{
		Firstname: String,
		Lastname: String,
		Phone: String,
		Email: String
	},
	AdminProfile: 
	{
		Firstname: String,
		Lastname: String,
		Email: String,
		WorkerId: String,
		Phone: String
	},
	CompanyCustomers: 
	[
		{
			CompanyId: 00000000-0000-0000-0000-000000000000,
			CompanyName: String,
			CustomerId: 00000000-0000-0000-0000-000000000000,
			SubscribedToNewsletter: False,
			CustomFieldValues: 
			[
				{
					Id: 0,
					Column: String,
					Name: String,
					Description: String,
					Value: String,
					DataType: String
				}
			]
		}
	]
}