网页与行动版的免费线上预约排程服务

让您的客户不用离开您的应用程序就能预约服务！

提供您的客户发现在地商家时会想采取的动作，藉此让您的网站或应用程序更加贴切、迷人、更有效益。我们的 API 让您轻松在您的网页上直接添加一个「现在预约」的按钮，以让您的客户能够不分日夜做实时预约。

我们的 API 提供您所有需要的预约数据之访问权限，让您架构并配置适合您的客户群之预约功能。

藉由将客户连结至您的营业时间表，我们会创造一个全新的交易层面。我们相信直接在您的应用程序或网站上预约将允许我们提供您实际的有效客户，而不仅是潜在客户。

为何数以千计的客户都选择使用 SimplyВook.me API 呢？

简单利落的界面，轻松打造您自己的预约服务。
您可轻易地置入所有您需要的功能。
实时排程——您的客户能够天天 24 小时随时随地与您预约。
我们的应用程序为您提供了许多其他有用的功能。点击此处以进一步了解我们的功能。

支持中心

使用我们的开发人员 API 来创建您自己的预约界面。从最简单的小部件到多功能的应用程序，您可依据您特定的业务来客制任何的解决方案。

SimplyВook.me 应用程序界面（API）使用的是 JSON-RPC 2.0 协定。

看看以 API 架设的预约界面之范例，并且查看这个解决方案的程序代码。

授权

使用 SimplyВook.me 的 API 需要一个授权的动作。您必须取得一组存取密钥——即授权码，以在 SimplyВook.me API中授权。为了取得这个授权码，您必须在 https://user-api.simplybook.me/login 服务上透过您个人的 API 密钥呼叫 JSON-RPC 方法 getToken。您可以从管理界面上复制您的 API 密钥：到「客制功能」的页面并且选择 API 客制功能的「设定」。接着您必须将远程访问初始化至 SimplyВook.me API。您的请求应包含下面标题：'X-Company-Login', 'X-Token'。

授权码的取得可由客户端或由您的服务器来执行，然而后者是两者中较安全的解决方案。

您可使用我们的范例中的 javascript JSON-RPC-客户端链接库与 php JSON-RPC-客户端链接库来开发您自己的解决方案。

客户端 API（公司的公开服务）授权

从客户端代码之授权

取得授权码。


var loginClient = new JSONRpcClient({
	'url': 'https://user-api.simplybook.me' + '/login',
	'onerror': function (error) {},
});
var token = loginClient.getToken(YOUR_COMPANY_LOGIN, YOUR_API_KEY);

初始化客户端 JSON-RPC。


this.client = new JSONRpcClient({
	'url': 'https://user-api.simplybook.me',
	'headers': {
		'X-Company-Login': YOUR_COMPANY_LOGIN,
		'X-Token': token
	},
	'onerror': function (error) {}
});

从服务器端代码之授权

取得授权码。


$loginClient = new JsonRpcClient('https://user-api.simplybook.me' . '/login/');
$token = $loginClient->getToken(YOUR_COMPANY_LOGIN, YOUR_API_KEY);

初始化客户端 JSON-RPC。


$client = new JsonRpcClient('https://user-api.simplybook.me' . '/', array(
    'headers' => array(
        'X-Company-Login: ' . YOUR_COMPANY_LOGIN,
        'X-Token: ' . $token
    )
));

使用者 / 管理 API（公司的管理服务）授权

从客户端代码之授权

取得授权码。


var loginClient = new JSONRpcClient({
'url': 'https://user-api.simplybook.me' + '/login',
'onerror': function (error) {},
});
var token = loginClient.getUserToken(YOUR_COMPANY_LOGIN, YOUR_USER_LOGIN, YOUR_USER_PASSWORD);

初始化客户端 JSON-RPC。


this.client = new JSONRpcClient({
'url': 'https://user-api.simplybook.me' + '/admin/',
'headers': {
'X-Company-Login': YOUR_COMPANY_LOGIN,
'X-User-Token': token
},
'onerror': function (error) {}
});

从服务器端代码之授权

取得授权码。


$loginClient = new JsonRpcClient('https://user-api.simplybook.me' . '/login/');
$token = $loginClient->getUserToken(YOUR_COMPANY_LOGIN, YOUR_USER_LOGIN, YOUR_USER_PASSWORD);

初始化客户端 JSON-RPC。


$client = new JsonRpcClient('https://user-api.simplybook.me' . '/admin/', array(
'headers' => array(
'X-Company-Login: ' . YOUR_COMPANY_LOGIN,
'X-User-Token: ' . $token
)
));

从 SimplyВook.me 服务器取得数据

预约页面通常是一个让客户选择他们所需的服务、员工，以及他们的会议时间的页面。客户会接着输入一些联络信息并确认预约。较复杂的解决方案可包含填入不同的额外字段、做团体或多次预约等等。让我们描述一下创建最简单的预约页面之工作流程。然后，如果您需要为您的页面添加一些额外的功能，则请参阅这里的 SimplyВook.me API 方法之完整列表。

所以您应展示的第一项信息为服务列表及员工列表，使用 getEventList 及 getUnitList 方法来取得这个数据。两者皆会回传一个清单，内含其中每项对象的完整信息，所以您会有许多可能性来选择如何在您的页面上展示服务与员工。欲做员工筛选，使用服务清单的 unit_map 性能，其含有可以提供所选服务之员工的信息。

取得服务列表的范例代码


$services = $client->getEventList();
// returns array(array(
//     'id' => 1, - service id
//     'name' => 'Service 1', - service's name
//     'description' => 'Describe your service...', - service description
//     'duration' => 60, - service duration
//     'hide_duration' => 0, - Hide duration to clients flag,
//     'picture' => null, - file name of picture or null
//     'picture_path' => '/uploads/apidemo/event__picture/small/', - full path to picture,
//     'position' => 1 - service position
//     'is_active' => 1, - the service is activated
//     'is_public' => 1, - the service is allowed to book by clients
// ), ...)

取得服务执行者列表的范例代码


$services = $client->getUnitList();
// returns array(array(
//    'id' => 1, - performer id
//    'name' => 'Provider 1', - performer name
//    'phone' => '111111111', - perfomer phone number
//    'description' => 'Describe your performer...', - performer description
//    'email' => 'test@gmail.com', - perfomer email,
//    'is_active' => 1, - the performer is activated
//    'is_visible' => 1, - the perfomer is visible for clients,
//    'picture' => null, - file name of picture or null,
//    'picure_path' => '/uploads/apidemo/unit_group__picture/small/', - full path to picture
//    'position' => 1, - performer position
//    'qty' => 1, performer quantity
// ), ...)

客户的下一步是选择想要的服务日期与时间。我们在 API 使用范例中使用了一个 Bootstrap 日期选择器，您可以使用之或是任何其他的日历。欲设定您日历的第一天，使用 getFirstWorkingDay 方法。其可用员工 ID 作为参数并回传所选员工（预设则为任何员工）可做预约的下一天之日期。欲显示所选日期中的时段，您需要 getWorkCalendar 及 getStartTimeMatrix 方法。第一个方法给您工作日的开始及结束时间以及休息日的信息，第二个方法则回传一个特定日期中可预约的时段之清单。

取得工作日信息的范例代码


$year = 2015;
$month = 3; // March
$performerId = 1; // Can be null 
$workDaysInfo = $client->getWorkCalendar($year, $month, $performerId);				
// returns array(
//     '2015-03-01' => array('from' => '09:00:00', 'to' => '18:00:00', 'is_day_off' => 0),
//     '2015-03-02' => array('from' => '09:00:00', 'to' => '18:00:00', 'is_day_off' => 0),
//     ...
//);

取得开始时间矩阵的范例代码


$dateFrom = '2015-03-03';
$dateTo = '2015-03-04';
$serviceId = 1;
$performerId = 1;
$qty = 1;
$availableTime = $client->getStartTimeMatrix($dateFrom, $dateTo, $serviceId, $performerId, $qty);
// returns array(
//     '2015-03-03' => array('09:00:00', '09:30:00', '10:00:00', ....),
//     '2015-03-04' => array('09:00:00', '09:30:00', '10:00:00', ....),
//);

另一个您可能会需要的实用方法为 calculateEndTime。每个服务皆可有自己的服务时间长度，您的员工每天亦可能有不同的工作时段。使用这个方法，您就可以为客户正确地显示其所预约的服务之结束日期与时间。

计算预约结束时间的范例代码


$startDateTime = '2015-03-03 09:00:00';
$serviceId = 1;
$performerId = 1;
$availableTime = $client->calculateEndTime($startDateTime, $serviceId, $performerId);
// returns '2015-03-03 10:00:00'

当一位客户点击确认预约的按钮时，您必须呼叫 book 方法。这是执行所有必要的验证和在 SimplyВook.me 系统中注册新预约的主要功能。它需要与预约及客户数据（如名称、电话和一些额外的参数）相关的信息。在 API 功能列表中查看此方法的所有参数说明。本 book 方法的回应含有一组独特的代码以及这个新预约的其他细节，如果出现任何问题，亦会回传错误的清单，所以您可使用这个信息来以便利、直观的方式将预约结果展示给客户。

使用 API 密钥

某些情况下，book 方法可能会需要确认动作。例如，如果您接受客户的付款，则您仅在收到款项后才确认该预约。 SimplyВook.me API 的 confirmBookng 方法搜集预约 ID 以及安全签名以作为参数。（cancelBookng 是另一个需要安全签名的方法。）您必需使用您的 API 密钥来产生安全签名。欲知如何完成这个动作，请见下面的范例。您可开启管里界面的「客制功能」页面，然后从 API 客制功能的「设定」内取得这组密钥。

服务预约以及使用 API 密钥来确认之范例代码


$additionalFields = array(
	'6740d3bce747107ddb9a789cbb78abf3' => 'value1', 
	'b0657bafaec7a2c9800b923f959f8163' => 'value2'
);
$clientData = array(
	'name' => 'Client name',
	'email' => 'client@email.com',
	'phone' => '+13152108338'
);
		
$bookingsInfo = $client->book($eventId, $unitId, $date, $time, $clientData, $additionalFields);

if ($bookingsInfo->require_confirm) {
   foreach ($bookingsInfo->bookings as $booking) {
	   $sign = md5($booking->id . $booking->hash . YOUR_API_SECRET_KEY);
	   $result = $client->confirmBooking($booking->id, $sign);
	   echo '
Confirm result
';
	   var_dump($result);
    }
}

取得额外字段的范例代码


$fields = $client->getAdditionalFields($eventId);
// returns - array(array(
//		'name' => 'b0657bafaec7a2c9800b923f959f8163', - field name
//		'title' => 'Test digits', - field title
//		'type' => 'digits', - field type
//		'values' => null, - available values for select field type
//		'default' => null, - default value for field
//		'is_null' => null, - is filed nullable
//		'on_main_page' => 1, 
//		'pos' => 1, - field position
//		'value' => null
// )), ...)

SimplyВook.me 客制功能

如果您的公司需要一些特定的额外功能，您可启用一些我们的额外客制功能。您可于管理界面的「客制功能」页面查看完整的客制功能列表及详细描述。启用所需的客制功能之后，相应的 API 方法亦会启动，供您使用于您的代码中。

预约功能代码流

在 SimplyВook.me API 中使用 loginClient.getToken(companyLogin, apiKey); 功能来授权。

使用 isPluginActivated("event_category") 来检查服务类别客制功能是否有启用，如果有则显示类别列表 getCategoriesList()。

使用 getEventList() 和 getUnitList() 功能来取得服务（活动）和执行者（单位）的列表。如果服务可用「unit_map」数组，则代表本服务只能由特定的执行者提供。

如果有启用任何员工选择器客制功能 isPluginActivated("any_unit")，而且「unit_map」数组中的服务–执行者配对没有设定特别的时间长度，则使用者应可选择任何供应者的选项，或是手动选择供应者。然而，如果有启用 getCompanyParam("any_unit__hide_other_units")，则应无法手动选择执行者。

使用 getStartTimeMatrix ($from 作为当前日期，$to 作为当前日期，$eventId, $unitId, $count 作为所选的参与者数值) 来取得特定日期的可选时段。如果有选择任何员工的选项，则 $unitId 应为空值。

如果有启用任何员工选择器且有选择任何员工，则呼叫 getAvailableUnits($eventId, $dateTime, $count) 以取得可选择的 $unitId。

如果有启用额外字段客制功能 isPluginActivated("event_field")，则呼叫 getAdditionalFields($eventId) 功能以取得供客户填写的字段之清单。

呼叫 book($eventId, $unitId, $date, $time, $clientData, $additional, $count, $batchId) 以做预约。

取得 API 授权码

使用 SimplyВook.me 的 API 需要一个授权的动作。您必须取得一组存取密钥——即授权码，以在 SimplyВook.me API 中授权。为了取得这个授权码，您必须在 https://user-api.simplybook.me/login 服务上呼叫 JSON-RPC 方法 getToken 以提供您个人的 API 密钥。您可以从管理界面上复制您的 API 密钥：到“客制功能”的页面并且选择 API 客制功能的“设定”。

var token = loginClient.getToken(companyLogin, apiKey);

公司登入

API 密钥

范例代码:

var loginClient = new JSONRpcClient({
	'url': '//user-api.simplybook.me/login',
	'onerror': function (error) {
		alert(error);
	}
});
var token = loginClient.getToken('{companyLogin}', '{apiKey}');

方法结果

响应内容

HTTP 请求

取得活动清单

您已收到授权码。接下来您需要创建 JSON RPC 客户端、设定 http 标头，然后用这个客户端来从 Simplybook 服务器取得数据。欲取得服务清单，使用 getEventList() 方法，代码的范例如下。

var events = client.getEventList();

范例代码:

var client = new JSONRpcClient({
	'url': '//user-api.simplybook.me',
	'headers': {
		'X-Company-Login': '{companyLogin}',
		'X-Token': '{token}'
	},
	'onerror': function (error) {
		alert(error);
	}
});
var services = client.getEventList();

方法结果

响应内容

HTTP 请求

取得执行者清单

您亦须取得所有服务执行者的清单。执行这个动作请使用 getUnitList() 方法。

var units = client.getUnitList();

范例代码:

var performers = client.getUnitList();

方法结果

响应内容

HTTP 请求

依服务过滤执行者

现在，让使用者选择服务并接着选择执行者。请注意服务可连接至特定的执行者或是由清单中的任何执行者来提供，这即是您为何应在使用者做选择前过滤执行者的原因。在服务目标中使用 unit_map 参数以执行这个动作。请见下面的范例代码。

范例代码:

// fetch service and performers selects here
var serviceId;
var performerId;
jQuery('#select_event_id').empty();
jQuery('#select_unit_id').empty();
jQuery('#select_event_id').append('<option value=""></option>');
jQuery('#select_unit_id').append('<option value=""></option>');
for (var id in services) {
    jQuery('#select_event_id').append('<option value="' + id + '">' + services[id].name + '</option>');
}
for (var id in performers) {
    jQuery('#select_unit_id').append('<option value="' + id + '">' + performers[id].name + '</option>');
}
jQuery('#select_event_id').change(function () {
	// service id
	serviceId = jQuery(this).val();
	var selectedService = services[serviceId];
	// filter available performers
	if (selectedService) {
		if (typeof(selectedService.unit_map) != 'undefined' && selectedService.unit_map.length) {
			jQuery('#select_unit_id option').attr('disabled', true);
			jQuery('#select_unit_id option[value=""]').attr('disabled', false);
			for (var i = 0; i < selectedService.unit_map.length; i++) {
				jQuery('#select_unit_id option[value="' + selectedService.unit_map[i] + '"]').attr('disabled', false);
			}
		} else {
			jQuery('#select_unit_id option').attr('disabled', false);
		}
	}
	jQuery('#eventId').val(serviceId).change();
});
jQuery('#select_unit_id').change(function () {
	performerId = jQuery(this).val();
});

取得有可预约时段的最近日期

使用者选择服务及执行者后，您应取得所选执行者的第一个工作天并且将其设定为日期选择器的启动日期。使用 getFirstWorkingDay() 方法来执行这个动作。

var firstWorkingDay = client.getFirstWorkingDay(performerId);

选择服务

选择执行者

范例代码:

var firstWorkingDay = client.getFirstWorkingDay(performerId);

方法结果

响应内容

HTTP 请求

将日历中的非工作时间设为无效

除了设定您的日期选择器的启用日期以外，你亦可使用工作行程表的数据将其中的休息日设为无效。请见 getWorkCalendar() 如何在范例代码中运作。

workCalendar = client.getWorkCalendar(year, month, performerId);

范例代码:

// Init datepicker.
var workCalendar = {};
jQuery('#datepicker').datepicker({
	'onChangeMonthYear': function (year, month, inst) {
		workCalendar = client.getWorkCalendar(year, month, performerId);
		jQuery('#datepicker').datepicker('refresh');
	},
	'beforeShowDay': function (date) {
		var year = date.getFullYear();
		var month = ("0" + (date.getMonth() + 1)).slice(-2);
		var day = ("0" + date.getDate()).slice(-2);
		var date = year + '-' + month + '-' + day;
		if (typeof(workCalendar[date]) != 'undefined') {
			if (parseInt(workCalendar[date].is_day_off) == 1) {
				return [false, "", ""];
			}
		}
		return [true, "", ""];
	}
});
var firstWorkingDateArr = firstWorkingDay.split('-');
workCalendar = client.getWorkCalendar(firstWorkingDateArr[0], firstWorkingDateArr[1], performerId);

jQuery('#datepicker').datepicker('refresh');

方法结果

响应内容

HTTP 请求

取得可预约的时段

使用者选择一个日期后，您可以加载可预约服务的时间间隔。使用 getStartTimeMatrix() 方法来取得有效时段的开始时间之清单。

var startMatrix = client.getStartTimeMatrix(from, to, eventId, unitId, count)

范例代码:

// Handle date selection
var count = 1; // How many slots book
function formatDate(date) {
	var year = date.getFullYear();
	var month = ("0" + (date.getMonth() + 1)).slice(-2);
	var day = ("0" + date.getDate()).slice(-2);
	
	return year + '-' + month + '-' + day;
}

function drawMatrix(matrix) {
	jQuery('#starttime').empty();
	
	for (var i = 0; i < matrix.length; i++) {
		jQuery('#starttime').append('<span data-time="' + matrix[i] + '">' + matrix[i] + '</span>');
	}
	jQuery('#starttime span').click(function () {
		startTime = jQuery(this).data('time');
		
		jQuery('#starttime span').removeClass('selected');
		jQuery(this).addClass('selected');
	});
}

jQuery('#datepicker').datepicker('option', 'onSelect', function () {
	var startDate = formatDate(jQuery(this).datepicker('getDate'));
	jQuery('#dateFrom, #dateTo').val(startDate);
	
	var startMatrix = client.getStartTimeMatrix(startDate, startDate, serviceId, performerId, count);
	
	drawMatrix(startMatrix[startDate]);
});
var startMatrix = client.getStartTimeMatrix(firstWorkingDay, firstWorkingDay, serviceId, performerId, count);
drawMatrix(startMatrix[firstWorkingDay]);

方法结果

响应内容

HTTP 请求

确认是否有启用申请表客制功能

现在，确认是否有启用申请表客制功能以判断接下来要向客户显示什么。请见 isPluginActivated() 方法的使用范例。

var additionalFieldsActivated = client.isPluginActivated('event_field');

范例代码:

var additionalFielsActivated = client.isPluginActivated('event_field');

方法结果

响应内容

HTTP 请求

取得申请表

如果有启用申请表客制功能，您应使用 getAdditionalFields() 方法来加载申请表清单并且将它们添加到客户的详细信息表格中。

范例代码:

// load additional fields
var additionalFields = [];

function clearAdditionalFields() {
	jQuery('#additional-fields').empty();
	additionalFields = [];
}

function addAdditionalField(field) {
	var container = jQuery('<div class="form-group"></div>');
	var title = jQuery('<div class="control-label">' + field.title + '</div>');
			
	container.append(title);
			
	var fieldContainer = jQuery('<div class="field"></div>');
			
	container.append(fieldContainer);
			
	var fieldNode = null;
	switch (field.type) {
		case 'checkbox':
			fieldNode = jQuery('<input type="checkbox" name="' + field.name + '" id="' + field.name + '" value="1" />');
			if (field['default']) {
				fieldNode.attr('checked', true);
			}
			break;
		case 'select':
			fieldNode = jQuery('<select name="' + field.name + '" id="' + field.name + '"></select>');
			var values = field.values.split(',');
			for (var k = 0; k < values.length; k++) {
				fieldNode.append(jQuery('<option value="' + values[k].trim() + '">' + values[k].trim() + '</option>'));
			}
			if (field['default']) {
				fieldNode.val(field['default']);
			}
			break;
		case 'textarea':
			fieldNode = jQuery('<textarea name="' + field.name + '" id="' + field.name + '"></textarea>');
			if (field['default']) {
				fieldNode.val(field['default']);
			}
			break;
		default:
			fieldNode = jQuery('<input type="text" name="' + field.name + '" id="' + field.name + '" />');
			if (field['default']) {
				fieldNode.val(field['default']);
			}
			break;
	}
	if (fieldNode) {
		if (field.type == 'checkbox') {
			fieldNode.addClass('checkbox');
		} else {
			fieldNode.addClass('form-control');
		}
		fieldContainer.append(fieldNode);
		jQuery('#additional-fields').append(container);
	}
}

if (additionalFielsActivated) {
	clearAdditionalFields();
	additionalFields = client.getAdditionalFields(serviceId);
	for (var i = 0; i < additionalFields.length; i++) {
		addAdditionalField(additionalFields[i]);
	}
}

方法结果

响应内容

HTTP 请求

执行预约

客户将其讯息填入申请表后，您应呼叫 book() 方法以开始预约过程。

客户名称

客户电子信箱

客户电话

范例代码:

// Collect client data
var clientData = {
	'name': jQuery('#clientName').val(),
	'email': jQuery('#clientEmail').val(),
	'phone': jQuery('#clientPhone').val()
};
// Collect additional fields
var additionalFieldValues = {};
jQuery('#additional-fields input, #additional-fields select, #additional-fields textarea').each(function () {
	var val = '';
	if (jQuery(this).attr('type') == 'checkbox') {
		if (jQuery(this).is(':checked')) {
			val = 1;
		} else {
			val = 0;
		}
	} else {
		val = jQuery(this).val();
	}
	additionalFieldValues[jQuery(this).attr('name')] = val;
});
var count = 1;

var result = client.book(serviceId, performerId, startDate, startTime, clientData, additionalFieldValues, count);

方法结果

响应内容

HTTP 请求

摘要

以上是您可如何使用 Simplybook API 的简单范例。请到这里查看所有可用的 API 方法。欢迎随时联络我们并提出任何疑问。

感谢您的耐心阅读！

服务网址 https://user-api.simplybook.me/

getUnitList ($isVisibleOnly, $asArray, $handleClasses, $searchString)

{@inheritdoc}
- @param bool $isVisibleOnly
- @param bool $asArray
- @param integer $handleClasses (1 - classes only, -1 without classes, null - skip classes check)
- @param string $searchString part of name (used for comboboxes)
- @return Array
getEventList ($isVisibleOnly, $asArray, $handleClasses, $searchString)

{@inheritdoc}
- @param bool $isVisibleOnly
- @param bool $asArray
- @param integer $handleClasses (1 - classes only, -1 without classes, null - skip classes check)
- @param string $searchString part of name (used for comboboxes)
- @return Array
getCategoriesList ($isPublic)

{@inheritdoc}
- @param bool $isPublic
- @return Array
getLocationsList ($isPublic)

{@inheritdoc}
- @param Boolean $isPublic
- @return Array
getPaymentProcessorConfig ($paymentProcessor)

Returns payment processor config
- @param String $paymentProcessor
- @return Array
validatePayment ($paymentInfo, $cartId)

Validate application payment.
- @param mixed $paymentInfo
- @param Integer $cartId
- @return Boolean
getBookingCart ($bookingIds)

Returns cart information by bookings ids.
cart_id and cart_hash is used to create secure signature to confirm cart payment.

status - current cart status
amount - is total amount to payment
currency - cart currency
cart - contains cart items. You can use them to provide information for payment system. Each item is object with following fields:
id - booking id
event_id - service id
name - event name + start date time (use it to provide cart information for payment system)
price - booking price
qty - qty of bookings
- @param Array $bookingIds
- @return Object
getBookingCartInfo ($cartId, $sign)

Returns current cart information
cart_id and cart_hash is used to create secure signature to confirm cart payment.

amount - is total amount to payment
currency - cart currency
cart - contains cart items. You can use them to provide information for payment system. Each item is object with following fields:
id - booking id
event_id - service id
name - event name + start date time (use it to provide cart information for payment system)
price - booking price
qty - qty of bookings
- @param Integer $cartId cart id
- @param String $sign signature. (md5($cartId . $cartHash . $secretKey))
- @return Object
getBookingCartStatus ($id)

Returns current cart status
Possible result values:

cancel - user has canceled payment
paid - user has paid
error - error has been occurred on validation payment
not_paid - cart is not paid yet or payment status is pending
- @param Integer $id
- @return String
confirmBookingCart ($cartId, $paymentProcessor, $sign)

Confirm booking cart. Use it to confirm payment. Signature is required.
- @param Integer $cartId cart id
- @param String $paymentProcessor payment processor name
- @param String $sign signature. (md5($cartId . $cartHash . $secretKey))
- @return Boolean
confirmBooking ($id, $sign)

Confirm booking. Signature is required.
$sign = md5($bookingId . $bookingHash . $secretKey);

Call this method from server side only
- @param Integer $id
- @param String $sign
- @return Boolean
confirmBookingPayment ($id, $paymentProcessor, $sign)

Confirm booking payment. Signature is required.
$sign = md5($bookingId . $bookingHash . $secretKey);

Call this method from server side only
- @param Integer $id
- @param String $paymentProcessor
- @param String $sign
- @return Boolean
confirmBookingBatch ($batchId, $batchType, $sign)

Confirms booking batch. Signature is required.
$sign = md5($batchId . $batchHash . $secret)

Call this method from server side only
- @param Integer $batchId
- @param String $batchType
- @param String $sign
- @return Boolean
getBooking ($id, $sign)

Returns an object with details information about booking. $sign parameter must be a string created
with formula: md5($bookingId . $bookingHash . $secretKey). You can get $bookingHash

value as result of [[#book|book]] API method call. Method return an error with code -32080
(Appointment couldn't be found) if record with specified id not exists. Methods returns an error with code -32085
(Signature error) if $sign parameter is wrong.
- @param Integer $id
- @param String $sign
- @return Object
getBookingDetails ($id, $sign)

Returns an object with details information about booking. $sign parameter must be a string created
with formula: md5($bookingId . $bookingHash . $secretKey). You can get $bookingHash

value as result of [[#book|book]] API method call. Method return an error with code -32080
(Appointment couldn't be found) if record with specified id not exists. Methods returns an error with code -32085
(Signature error) if $sign parameter is wrong.
- @param Integer $id
- @param String $sign
- @return Object
isPaymentRequired ($eventId)

Returns true if [[Plugins#Accept_payments|Accept payments]] plugin activated and event with specified id has
configured price. If no paramentes specified then method returns true if payments plugin activated and at least

one event has configured price. Otherwise returns false.
- @param Integer $eventId
- @return Boolean
book ($eventId, $unitId, $date, $time, , , $count, $batchId, $recurringData)

Creates new booking record. Returns an object with appointment information or throw exception if booking time not
available or any of required parameters missed. If appointment requires confirmation, in result object will be

require_confirm = true. $startDate and $startTime specifies a date of
booking and time slot. Time value should be multiple to 'timeframe' configuration of company (see
[[#getTimeframe|getTimeframe]] API method). $endDate and $endTime parameters
should be calculated according to service duration. However you can specify different values to make appointment
longer or shorter then service configuration. Note that $endDate and $endTime should be
later in time than $startDate and $startTime. If your clients located in different time
zone you should specify 'client_time_offset' value in $clientData object as difference
between client's time zone and company's time zone in minutes. For example if company located in city with time
zone GMT+2 and customer located in city with GMT+3 then $clientTimeOffset will be 60 minutes. You
can get information about company's time zone using [[#getCompanyInfo|getCompanyInfo]] API method. To
create batch booking you can specify either count more then 1 or valid batchId (only one
parameter can be specified). You should specify an $additionalFields parameter if service requires
some additional fields (see [[Plugins#Additional fields|Additional fields plugin]]). To create a booking with promo code you
should pass it as additional field. For example: {"name": "promocode", "value": "some code", "type": "text"}

See [[#book response|example]] of book API method response.
- @see http://wiki.simplybook.me/index.php/Settings#Timeframe Timeframe information
- @param Integer $eventId
- @param Integer $unitId
- @param String $date in Y-m-d format
- @param String $time in H:i:s format
- @param Object
- @param array
- @param Integer $count bookings count, min. 1 (using for group bookings batch). (optional)
- @param Integer $batchId add booking to multiple bookings batch. (optional)
- @param Array $recurringData make booking recurrent. (optional)
- @return Object
getRecurringDatetimes ($eventId, $unitId, $date, $time, $recurringData)

Get list of dates for recurring booking
- @param Integer $eventId
- @param Integer $unitId
- @param String $date
- @param String $time
- @param Array $recurringData
- @return Array
hasUpcommingPromotions ()

Returns availability of active promotions
- @return Boolean
validatePromoCode ($code, $startDateTime, $eventId, $count, )

Validate promotion code.
Returns true in case promocode is valid otherwise throws exception with error.
- @param String $code
- @param String $startDateTime
- @param Integer $eventId
- @param Integer $count
- @param array
- @return Boolean
getPromocodeInfo ($code)

Returns an object with detailed information about promotion by promotion code. Returns null if no promotions with
specified code were not found.
- @param String $code
- @return Array
getPromotionRewardInfo ($commonPromotionId, $clientId, $hash)

Returns promotion reward by common promotion id, client id and hash.
- @param Integer $commonPromotionId
- @param Integer $clientId
- @param String $hash
- @return Array
getUserLicenseText ()

Returns user license text if user license plugin is turned on,
otherwise throws exception
- @return String
getClientInfo ($clientId, $sign)

Returns client info by client id
- @param Integer $clientId
- @param String $sign signature = md5($clientId . $clientHash . $secretKey)
- @return Object
getClientInfoByLoginPassword ($login, $password)

Returns client information by clients login (email)/password
- @param String $login
- @param String $password
- @return Object
remindClientPassword ($email)

Sends remind email for client
- @param String $email
- @return Boolean
getClientByLoginHash ($hash)

Get client information by client login hash
- @param String $hash
- @return Object
modifyClientInfo ($clientId, $data, $sign)

Edit client information data
- @param Integer $clientId
- @param Array $data
- @param String $sign signature = md5($clientId . $clientHash . $secretKey)
- @return Object
getMembershipList ()

Returns list of available memberships
- @return Array
getClientMembershipList ($filter, $clientId, $sign)

Returns purchased membership list
- @param Array $filter
- @param Integer $clientId
- @param String $sign
- @return Array
getClientBookings ($clientId, $sign, $filter)

Returns client bookings, accepts $filter ($filter {upcoming_only: true/false, confirmed_only: true/false})
- @param integer $clientId
- @param string $sign
- @param object $filter
- @return array
membershipCheckClientAccess ($eventId, $clientId, $clientSign, $date, $count)

Checks if client has access to book with $eventId at $startDateTime
- @param Integer $eventId
- @param Integer $clientId
- @param String $clientSign signature = md5($clientId . $clientHash . $secretKey)
- @param String $date
- @param int $count
- @return Boolean
getProductList ($filter)

Returns product list with filter.
At this time filter can accept only service_id parameter
- @param object $filter
- @return array
getClassesList ($filter)

Returns company's classes list. Ordered by position
- @param Array $filter
- @return Array
getCompanyParam ($key)

Returns company config value for key. A different set of keys available for public API and for company
administration API. Method return 'invalid params' error (code -32602) in case if access to specified key not

allowed. See [[#Company_params|list of available keys]].
- @param String $key
- @return mixed
getCompanyParams ($keys)

Returns company's config values for specified keys as key-value map. For non-existent and not-allowed param keys
it will return '''false''' as result. A different set of keys available for public API and for company

administration API. See [[#Company_params|list of available keys]].
- @param Array $keys
- @return Array
getTimelineType ()

Returns company timeline type
- @return String
calculateEndTime ($startDateTime, $eventId, $unitId)

Returns end datetime if booking is available, else return false
- @param String $startDateTime a date and time string in format 'Y-m-d H:i:s', eg. '2001-10-02 13:30:00'.
- @param Integer $eventId
- @param Integer $unitId
- @return String
getWorkCalendar ($year, $month, )

Returns company work schedule as array
Eg.: {'2014-05-01': {'from': '09:00:00', 'to': '21:00:00', 'is_day_off': '0'}, '2014-05-02': ...}
- @param Integer $year
- @param Integer $month
- @param Integer
- @return Object
getReservedTime ($from, $to, $eventId, $unitId, $count)

Returns map of objects for each day in specified date range. The key of the result mps is a date string. The value
is an array of two objects. Both objects contains list of time slots for type reserved_time and type

not_worked_time. reserved_time type represents time slots working time but already booked
by clients. Nobody knows what kind of data represented by not_worked_time type. Please don't use it.

If [[Plugins#Google calendar sync plugin|Google calendar sync plugin]] enabled then object with
reserved_time type will contain not empty list of time slots marked as busy in Google calendar. Call
[[#isPluginActivated|isPluginActivated('google_calendar_export')]] API method to check if Google
calendar sync plugin activated.

Example:
```
  {

    "2016-02-05": [

      {

        "dd": [], // time slots from Google calendar

        "events": [ // reserved time slots

          { "from": "16:00", "to": "16:30" },

          { "from": "16:30", "to": "17:00" },

          ... ],

        "type": "reserved_time",

      },

      {

        "events": [

          { "from": "09:00", "to": "09:30" },

          { "from": "09:30", "to": "10:00" },

          ... ],

        "type": "not_worked_time"

     }],

     ...

  }
```
- @param String $from
- @param String $to
- @param Integer $eventId
- @param Integer $unitId
- @param Integer $count
- @return Object
getWorkDaysInfo ($from, $to, $unitId, $eventId, $count)

Returns an information about working hours and break times for specified service and performer for a period
between two dates. If only service specified then information about performer (or performers) will be taken from

service configuration. Method returns a list of objects for each date in specified period. Count of objects in
list depends on break times. For example if performer works from 9:00 till 19:00 with one hour break at 13:00 method
returns:
```
  {'2014-05-14' : [

    {'from': '09:00:00', 'to': '13:00:00'},

    {'from': '14:00:00', 'to': '19:00:00'}

  ] }
```
Warning! Method can return a time string '24:00:00' as right edge of time range. This happens in case if time
range finishes on midnight.
- @param String $from
- @param String $to
- @param Integer $unitId (optional)
- @param Integer $eventId (optional)
- @param Integer $count (optional)
- @return Object
getFirstWorkingDay ()

Returns first working date for unit
- @param Integer
- @return String
getStartTimeMatrix ($from, $to, $eventId, $unitId, $count)

Returns available start time, taking into account breaktimes, start and end working time
Eg.: {'2014-05-14': ['09:00:00', ...], ...}

If locations plugin activated for company you should pass a list as $unitID parameter for filter results with
units available only for selected location. See [[Plugins#Unit_location|Unit location]] plugin description for
more details.
- @param String $from
- @param String $to
- @param Integer $eventId
- @param Mixed $unitId can be Integer or Array of Integers
- @param Integer $count
- @return Object
getAvailableTimeIntervals ($dateFrom, $dateTo, $eventId, $unitId, $count)

Returns available time intervals for all service providers for given period, taking into account breaktimes, start and end working time
Eg.: {['2016-03-04': ['1': [['09:00:00','09:30:00'], ['11:15:00','14:45:00']] , ...], ...]}
- @param String $dateFrom
- @param String $dateTo
- @param Integer $eventId
- @param Mixed $unitId can be Integer or Array of Integers
- @param Integer $count
- @return Object
getServiceAvailableTimeIntervals ($dateFrom, $dateTo, $eventId, $unitId, $count)

Returns available time intervals for all servics for given period, taking into account breaktimes, start and end working time
Eg.: {['2016-03-04': ['1': [['09:00:00','09:30:00'], ['11:15:00','14:45:00']] , ...], ...]}
- @param String $dateFrom
- @param String $dateTo
- @param Mixed $eventId can be Integer or Array of Integers
- @param Integer $unitId
- @param Integer $count
- @return Object
getReservedTimeIntervals ($dateFrom, $dateTo, $eventId, , $count)

Returns not available time
Eg.: {'2014-05-14': [{'reserved_time': [{'from': '14:00', 'to': '16:30'}], 'type': "reserved_time"}, ...], ...}
- @param String $dateFrom
- @param String $dateTo
- @param Integer $eventId
- @param Integer
- @param Integer $count
- @return Object
getAvailableUnits ($eventId, $dateTime, $count)

Returns list of available unit ids for specified date and service or empty array if all units are not allowed.
Eg.: [1, 2, 3]
- @param Integer $eventId
- @param String $dateTime a date and time string in format 'Y-m-d H:i:s'
- @param Integer $count
- @return Array
filterAvailableUnits ($eventId, $dateTime, , $count)

Returns list of available unit ids for specified date and service from provided $unitIds list.
You can use this method with location plugin.

Returns empty array if all units are not allowed.
Eg.: [1, 2, 3]
- @param Integer $eventId
- @param String $dateTime a date and time string in format 'Y-m-d H:i:s'
- @param Array
- @param Integer $count
- @return Array
getAnyUnitData ()

Returns information about [[Plugins#Any_Employee_selector|Any Employee selector plugin]] configuration. Returns
null if plugin not enabled.

Example:
{
"description" : "Select this option, if you want to find an available time with any of the employees",
"hide_other_units" : 1, // 1 or 0
"image" : null,
"name" : "Any employee",
"picture_path" : null,
"random_selection" : 0 // 1 or 0
}
- @return Object
getAdditionalFields ($eventId)

Return additional fields for certain event if [[Plugins#Additional_fields|Additional fields plugin]] is
activated. Returns empty array otherwise. Call [[#isPluginActivated|isPluginActivated('event_field')]]

API method to check if 'event_field' plugin activated.
- @param Integer $eventId
- @return Array
getTimeframe ()

Returns company's timeframe configuration (in minutes). Timeframe can be either 5, 10, 15, 20, 30 or 60 minutes.
You can find more details about timeframe [[Settings#Timeframe|here]].
- @return Integer
isPluginActivated ($pluginName)

Return plugin status true if status active, else false. $pluginName parameter is a plugin identifier.
See [[Plugins|plugins]] page for full plugins description. See [[#Plugin's identifiers|list of available plugin's names]].
- @param String $pluginName
- @return Boolean
getPluginStatuses ($pluginNames)

Return plugin status true if status active, else false. See [[#Plugin's identifiers|list of available plugin's names]].
- @param Array $pluginNames
- @return Array
getCompanyInfo ()

Returns an object with detailed information about company. See [[#getCompanyInfo response|example of response]].
- @return Object
createBatch ()

Creates new booking batch record. Returns newly created batch id. You can use this id in [[#book|book]]
API method.
- @return Integer
getCountryPhoneCodes ()

Returns country phone code list
- @return Array
getPluginPromoInfoByCode ()

Returns an object with detailed information about promotion by promotion code. You can get promotion code
using [[Catalogue#getPromotionList|getPromotionList]] API method. If promotion record with specified

code not found then method returns an empty array (an empty object). If [[Plugins#Simply Smart Promotions|Simply Smart Promotions plugin]]
not enabled then method returns an error with code -32001 (Plugin is not activated). Use
[[#isPluginActivated|isPluginActivated('promo')]] API method call to check if plugin enabled.

See [[#getPromotionList response|example]] of getPromotionList API method response. Please note that
response contains a list of services for wich promotion discount can be applied (service_ids key).
- @param String
- @return Array
getCompanyTimezoneOffset ()

Returns company timezone offset and company timezone
- @return array

服务网址 https://user-api.simplybook.me/admin

getBookings ()

Returns list of bookings filtered by given params. Filter params represented as object with following fields:

* '''date_from''' a date of booking in string format 'Y-m-d'
* '''time_from''' a time string in format 'H:i:s'
* '''date_to''' a date string in format 'Y-m-d'
* '''time_to''' a time string in format 'H:i:s'
* '''created_date_from''' a date string in format 'Y-m-d'
* '''created_date_to''' a date string in format 'Y-m-d'
* '''unit_group_id''' an integer. Use it to get bookings assigned for certain service provider.
* '''event_id''' an integer. Use it to get bookings only for certain service.
* '''is_confirmed''' 1 or 0. If [[Plugins#Approve booking|Approve booking]] plugin enabled then method will return confirmed bookings with approve status 'new'.
* '''client_id''' an integer. Use it to get bookings only for certain client.
* '''order''' string either 'record_date', 'date_start' or 'date_start_asc'. By default used 'date_start' value.
* '''booking_type''' a string. Value of this field depends on Approve booking plugin status.
* '''code''' booking code
*: If plugin not active:
** '''all''' for all bookings (default value)
** '''cancelled''' alias to 'is_confirmed' equal to 0
** '''non_cancelled''' alias to 'is_confirmed' equal to 1
*: If plugin active:
** '''all''' for all bookings (default value)
** '''cancelled''' returns bookings with 'is_confirmed' field equals to 0 and approve booking status equals to 'cancelled' (or booking does not have any approve status)
** '''non_cancelled''' returns bookings with either 'is_confirmed' field equals to 1 or approve booking status equals to 'new'
** '''cancelled_by_client''' returns bookings approved by admin but cancelled by client
** '''cancelled_by_admin''' returns bookings cancelled by admin
** '''non_approved_yet''' returns bookings with approve status 'new'
** '''approved''' returns bookings with either 'is_confirmed' field equals to 1 and approve booking status equals to 'approved' (or booking does not have any approve status)

Example:
{
"date_from":"2015-12-29",
"date_to":"2015-12-29",
"booking_type":"cancelled",
"event_id":"5",
"order":"start_date"
}
- @param Array
- @return Array
pluginZapierSubscribe ($url, $notificationType)

'create', 'cancel', 'new_client', 'change'
- @param string $url
- @param string $notificationType
- @return bool
- @throws Zend_Exception
getBookingDetailsZapierMock ()
- @return array
getClientInfo ()

Returns client data
- @param int
- @return array
getClientInfoZapier ()

Returns client data
- @param int
- @return array
- @throws \Exception
getClientInfoZapierMock ()

Returns client data
- @return array
- @throws \Exception
getBookingsZapier ()

Returns list of bookings filtered by given params
- @return Array
getBookingDetails ($id)

Returns detailed bookings object by booking id. See [[#getBookingDetails_response|response example]].
- @param integer $id booking id
- @return Array
getWorkDaysTimes ($startDateTime, $endDateTime, $type)

Return busy time by unit id by GoogleCalendar plugin if enabled.
Please note that this method may return not actual data because data synchronization between server and

Google Calendar may take some time and synchronized data are cached for 15 minutes.
- @param string $startDateTime
- @param string $endDateTime
- @param string $type either 'unit_group' or 'event'. Default value is 'unit_group'.
- @return Array
getGoogleCalendarBusyTime ($startDateTime, $endDateTime, $unitId)

Returns a list of objects represented a time intervals marked as busy in Google Calendar. Each object of result
contains from and to properties with datetime string as value. This method only actual if

[Plugins#Google calendar sync plugin|Google calendar sync plugin] enabled. If plugin not enabled an empty list will
be returned. You should call [[#isPluginActivated|isPluginActivated('google_calendar_export')]] to
check status of the plugin. Each object of result contains from and to properties with
datetime string as value. Please note that this method may return not actual data because data synchronization
between server and Google Calendar may take some time and synchronized data are cached for 15 minutes.

Example:
[ {"from" : "2016-02-16 13:30:00", "to" : "2016-02-16 16:00:00"}, ... ]
- @param string $startDateTime a date and time string in format 'Y-m-d H:i:s'
- @param string $endDateTime a date and time string in format 'Y-m-d H:i:s'. You can date string avoiding time in this parameter. In this case method will use time value '23:59:59'.
- @param int $unitId
- @return Array
getGoogleCalendarBusyTimeAvailableUnits ()

Returns configured unit ids, allowed to sync busy time
- @return Array
getBookingLimitUnavailableTimeInterval ($startDateTime, $endDateTime, $eventId)

Returns time intervals not available for bookings because of configuration of [[Plugins#Limit bookings|Limit bookings]]
plugin for period of time. Returns empty array if plugin not available.
- @param string $startDateTime a date and time string in format 'Y-m-d H:i:s'
- @param string $endDateTime a date and time string in format 'Y-m-d H:i:s'
- @param int $eventId
- @return Array
getUnitWorkingDurations ($dateStart, $dateEnd, $unitGroupId)

Return working durations
- @param string $dateStart
- @param string $dateEnd
- @param int $unitGroupId
- @return Array
getWorkload ($dateStart, $dateEnd, $unitGroupId)

Return workload data for units in period of time. Workload for each unit represented as array with work hours
at index 0, confirmed booking hours as load at index 1 and cancelled bookings hours at index 2.

Example:
['2015-10-21' : {
5 : [
10, // working hours
10, // load hours (confirmed bookings hours)
0 // cancelled bookings hours
] }]
- @param string $dateStart
- @param string $dateEnd
- @param int $unitGroupId
- @return Array
getBookingRevenue ($dateStart, $dateEnd, $unitGroupId, $serviceId)

Return bookings count and revenue value for each date in specified period. Data grouped by unit id and
represented as array with bookings count at index 0 and revenue amount at index 1. You can filter data either

by unit or by service. Set $dateStart and $dateEnd to null to get data for current week.

Example:
['2015-11-12' : {
3 : [
11, // bookings count
128.53 // revenue
]}
- @param string $dateStart a date string in format 'Y-m-d'.
- @param string $dateEnd a date string in format 'Y-m-d'
- @param int $unitGroupId
- @param int $serviceId
- @return Array
getUnitWorkdayInfo ($dateStart, $dateEnd, $unitGroupId)

Return workday info (date_start and date_end)
- @param string $dateStart
- @param string $dateEnd
- @param int $unitGroupId
- @return Array
cancelBooking ($id)

Cancels booking. Returns true on success. Returns an error with code -32080 (Appointment couldn't be found) if
no booking with specified id were found.
- @param Integer $id
- @return Boolean
cancelBatch ($id, $bookingIds)

Cancel batch of bookings. Returns true on success. Returns an error with code -32080 (Appointment couldn't be found)
if no booking with specified id were found. A booking with first id in $bookingIds list is used for

information in notifications.
- @param Integer $id identifier of batch. See [[#createBatch|createBatch]] API method.
- @param Array $bookingIds ids of bookings included to batch.
- @return bool
book ($eventId, $unitId, $clientId, $startDate, $startTime, $endDate, $endTime, $clientTimeOffset, , $count, $batchId, $recurringData)

Creates new booking record. Returns an object with appointment information or throw exception if booking time not
available or any of required parameters missed. If appointment requires confirmation, in result object will be

require_confirm = true. $startDate and $startTime specifies a date of
booking and time slot. Time value should be multiple to 'timeframe' configuration of company (see
[[#getTimeframe|getTimeframe]] API method). $endDate and $endTime parameters
should be calculated according to service duration. However you can specify different values to make appointment
longer or shorter then service configuration. Note that $endDate and $endTime should be
later in time than $startDate and $startTime. If your clients located in different time
zone you should specify 'client_time_offset' value in $clientData object as difference
between client's time zone and company's time zone in minutes. For example if company located in city with time
zone GMT+2 and customer located in city with GMT+3 then $clientTimeOffset will be 60 minutes.
You can get information about company's
time zone using [[#getCompanyInfo|getCompanyInfo]] API method. To create batch booking you can
specify either count more then 1 or valid batchId (only one parameter can be
specified). You should specify an $additionalFields parameter if service requires some additional
fields (see [[Plugins#Additional fields|Additional fields plugin]]).

To create a booking with promo code you should pass it as additional field. For example: {"promocode": "some code"}

If [[Plugins#Unit location|Unit location]] enabled you need to pass locations ID parameter as additional field
location_id. For example: {"location_id": "1"}. Use [[#isPluginActivated|isPluginActivated('location')]]
to check if plugin active and [[#getLocationsList|getLocationsList()]] method to get list of
available locations.

See [[#book response|example]] of book API method response.
- @see http://wiki.simplybook.me/index.php/Settings#Timeframe Timeframe information
- @param Integer $eventId
- @param Integer $unitId
- @param Integer $clientId
- @param string $startDate a date string in format 'Y-m-d'
- @param string $startTime a time string in format 'H:i:s'
- @param string $endDate a date string in format 'Y-m-d'
- @param string $endTime a time string in format 'H:i:s'
- @param Integer $clientTimeOffset
- @param array
- @param Integer $count bookings count used to make group bookings batch. This parameter can't be less than 1. (optional)
- @param Integer $batchId add booking to group bookings batch. You can't use $count and $batchId in one call. Please specify only one parameter. (optional)
- @param Array $recurringData make booking recurrent. (optional)
- @return Object
editBook ($shedulerId, $eventId, $unitId, $clientId, $startDate, $startTime, $endDate, $endTime, $clientTimeOffset, )

Edit existing booking record. See [[#book|book]] API method description for more details about date/time parameters,
time zone handling and additional fields. Returns null if parameters not valid.
- @param Integer $shedulerId an id of booking to edit. See [[#book|book]] or [[#getBookings|getBookings]] API methods.
- @param Integer $eventId
- @param Integer $unitId
- @param Integer $clientId
- @param String $startDate in Y-m-d format
- @param String $startTime in H:i:s format
- @param String $endDate in Y-m-d format
- @param String $endTime in H:i:s format
- @param Integer $clientTimeOffset
- @param array
- @return Object
addClient ($clientData, $sendEmail)

Adds new client with specified data. You can specify name, email, phone, address1, address2, city, zip,
country_id.

email, phone number or both of them can be mandatory fields. You should call
getCompanyParam('require_fields') method to check which fields are required.

Method returns an error:

* -32061 Client name value is wrong
* -32062 Client email value is wrong
* -32063 Client phone value is wrong

Example:

{
name: "Frances T. Perez",
phone: "+1502-810-4521",
email: "FrancesTPerez@teleworm.us",
address1: "3872 Earnhardt Drive",
address2: "Louisville, KY 40219",
city: Louisville,
zip: 3872
}
- @param Object $clientData
- @param Boolean $sendEmail
- @return Integer
editClient ($clientId, $clientData)

Edits client's record. See [[#addClient|addClient]] method description for list of available fields.
Method returns an id of client's record.
- @param Integer $clientId
- @param Object $clientData
- @return Integer
changeClientPassword ($clientId, $password, $sendEmail)

Change client password and send password email changing
- @param Integer $clientId
- @param String $password
- @param Boolean $sendEmail
resetClientsPassword ($clientIds)

Resets client password and send them emails
- @param Array $clientIds
remindClientsPassword ($email)

Sends remind email for client
- @param String $email
- @return Boolean
getClientList ($searchString, $limit)

Returns list of clients associated with company. You can use either phone number, email address or name as value
for $searchString. Pass an empty string for $searchString and null for $limit

parameters to get all records. See [[#addClient|addClient]] API method for list of available fields
of client data object.
- @param String $searchString
- @param Integer $limit
- @return Array
getStatuses ()

Returns list of available statuses or an empty list if [[Plugins#Status|Status plugin]] not enabled.
- @return Array
getBookingStatus ($bookingId)

Returns status of given booking (if status plugin is enabled)
default status will be returned if bookingId does not exists
- @param Integer $bookingId
- @return Array
setStatus ($bookingId, $statusId)

Sets specified status for booking. Returns an error with code -32020 if logged in user don't have access to edit
bookings. This method does nothing if [[Plugins#Status|Status plugin]] not enabled.
- @param Integer $bookingId
- @param Integer $statusId
- @return Boolean
getRecurringSettings ($eventId)

Returns an object with recurring settings for an event. Returns false if specified event does not configured as
recurring.
- @see http://blog.simplybook.me/recurring-and-periodic-bookings/ Recurring services desription
- @param Integer $eventId
- @return Array
getTopServices ($dateStart, $dateEnd)

Returns a list with statistics for services for a period of time. This data contains number of bookings and
revenues value for each service.
- @param String $dateStart
- @param String $dateEnd
- @return Array
getTopPerformers ()

Returns a list with statistics for performers. This data contains number of bookings and revenues value for each performer.
- @return Array
getRecurringDatetimes ($eventId, $unitId, $date, $time, $recurringData, $endDateTime)

Get list of dates for recurring booking
- @param Integer $eventId
- @param Integer $unitId
- @param String $date
- @param String $time
- @param Array $recurringData
- @param String $endDateTime (optional)
- @return Array
addDeviceToken ($token, $device)

Subscribe a mobile device to push notifications service. Device will recieve notifications about new bookings or
changes in already created bookings. Use either 'apple' or 'android' for device

parameter.
- @param String $token a device token string
- @param String $device a device type ('android' or 'apple')
- @return bool
deleteDeviceToken ($token)

Unsubscribe from push notifications service.
- @param String $token device token
- @return bool
getCountryList ()

Get list of all countries
- @return Array
getFeedbacks ($approvedOnly, $reviewsOnly, $lastOnly, $limit)

Get list of feedbacks
- @param Boolean $approvedOnly
- @param Boolean $reviewsOnly
- @param Boolean $lastOnly
- @param Integer $limit
- @return Array
getRecentActions ($lastOnly, $limit)

Returns latest actions
- @param Boolean $lastOnly
- @param Integer $limit
- @return Array
getWarnings ($lastObly)

Returns a list of objects represented system warnings. Each warning contains warning_type and warning_text
properties. warning_text property contains localized message. warning_type can be one of the values:

* '''sms_limit''' – warning indicates low amount of SMS credits
* '''sheduler_limit''' – warning indicates low amount of available bookings
- @param Boolean $lastObly Default value is '''false'''.
- @return Array
updateNotification ($type)

Mark notifications as readed
- @param String $type
getLastNotificationUpdate ($type)

Returns last update datetime
- @param String $type
- @return String
getBookingCancellationsInfo ($dateStart, $dateEnd)

Returns statistics about created bookings and cancellations for a time period. Data presented as array of hashes for
each type of operation (created or cancelled booking) groped by clients. "type" field can be either

"create", "cancel" or "nopayment_cancel". If "user_id" not specified then bookings where created or
cancelled by admin or employee. Data with type "nopayment_cancel" represents bookings cancelled
automatically by system.

Example:
3 bookings where created by admin or employee and 2 bookings where automatically cancelled by system.
[{
"cnt" : 3,
"firstname" : null,
"lastname" : null,
"login" : null,
"type" : "create",
"user_id"" : null
}, {
"cnt" : 2,
"firstname" : null,
"lastname" : null,
"login" : null,
"type" : "nopayment_cancel",
"user_id"" : null
}]
- @param String $dateStart a date string in format 'Y-m-d'. Pass null to get data from first day of current week.
- @param String $dateEnd a date string in format 'Y-m-d'. Pass null to get data filtered to last day of current week.
- @return Array
pluginApproveBookingApprove ($id)

Sets approve booking status to 'approved' if [[Plugins#Approve booking|Approve booking]] plugin enabled and returns
list of approved booking IDs. Returns false if plugin not enabled. Use [[#isPluginActivated|isPluginActivated('approve_booking')]]

API method call to check if plugin enabled.
- @param Integer $id
- @return Array
pluginApproveBookingCancel ($id)

Sets approve booking status to 'canceled' if [[Plugins#Approve booking|Approve booking]] plugin enabled and returns
true. Returns false if plugin not enabled. Use [[#isPluginActivated|isPluginActivated('approve_booking')]]

API method call to check if plugin enabled.
- @param Integer $id
- @return Boolean
pluginApproveGetPendingBookingsCount ()

Returns count of bookings pending approval if [[Plugins#Approve booking|Approve booking]] plugin enabled. Returns
0 if plugin not enabled. Use [[#isPluginActivated|isPluginActivated('approve_booking')]] API method

call to check if plugin enabled.
- @return Integer
pluginApproveGetPendingBookings ()

Returns list of objects with information about bookings pending approval if [[Plugins#Approve booking|Approve booking]]
plugin enabled. Returns empty list if plugin not enabled. Use [[#isPluginActivated|isPluginActivated('approve_booking')]]

API method call to check if plugin enabled.
- @return array
getPluginList ()

Returns a list of all plugins associated with company with status.
- @return Array
getBookingComment ($id)

Returns booking comment
- @param Integer $id
- @return String
setBookingComment ($id, $comment)

Set booking comment
- @param Integer $id
- @param String $comment
- @return Integer
getCurrentTariffInfo ()

Returns all information about current tariff (subscription). For example:

{
"name" : "gold",
"expire_date" : "2016-02-11 12:32:00",
"rest" : 41, // number of days until subscription expiration
"color" : "#fcb322"
}
- @return Array
getRegistrations ($groupBy)

Returns number of clients registrations by 'day', 'week' or 'month'. A time period depends on selected
grouping parameter:

* for 'day' methods returns statistics for last 31 days
* for 'week' methods returns data last 10 weeks period
* for 'month' time period is last 12 months
- @param String $groupBy either 'day', 'week' or 'month'
- @return Array
getBookingStats ($groupBy)

Returns statistic about bookings count grouped by 'day', 'week' or 'month'. A time period depends on selected
grouping parameter:

* for 'day' methods returns statistics for last 31 days
* for 'week' methods returns data last 10 weeks period
* for 'month' time period is last 12 months
- @param String $groupBy either 'day', 'week' or 'month'
- @return Array
getVisitorStats ($groupBy)

Returns statistics about page visits if plugin [[Plugins#Visitor Counter|Visitor Counter plugin]] enabled. Returns
an empty list if plugin not enabled. Use [[#isPluginActivated|isPluginActivated('counter')]] API method

call to check if plugin enabled. Results can be grouped by 'day', 'week' or 'month'. A time period depends on
selected grouping parameter:

* for 'day' methods returns statistics for last 31 days
* for 'week' methods returns data last 10 weeks period
* for 'month' time period is last 12 months
- @param String $groupBy
- @return Array
getSocialCounterStats ($provider)

Returns social counters value for your domain
- @param String $provider
- @return Integer
getCompanyCurrency ()

Returns company's currency as three chars code (ISO 4217).
- @return String
getClientComments ($clientId, $shedulerId)

Returns list of all comments for given client
- @param Integer $clientId
- @param Integer $shedulerId
- @return Array
getCurrentUserDetails ()

Returns an object with information about logged in user. Note: you are responsible for implementation of some
access rights based on group property value. Most of API methods returns an error if user has low access

rights but not all. There are 4 roles:

* '''Administrator''' - have full access to the system
* '''Senior Employee''' - have access to calendar, services and providers, and can modify bookings related with user
* '''Junior Employee''' - can access caledar (but only to own bookings), services associated with user
* '''Viewer''' - have only access to calendar and services in read only mode

group property can be one of the values:

* shop_user - "Senior Employee" access role
* station_user - "Junior Employee" access role
* admin - "Administrator" access role
* viewer - "Viewer" access role
* reseller_company_admin - reserved

Example:
{ "id": 1, "login": admin, "email": "admin@mycoolcompany.com"; "firstname": "Michail", "lastname": " ", "phone": "", "group": "admin", "is_blocked": 0, "last_access_time": "2016-06-06 17:55:51", "unit_group_id": null }
- @return Array
getUserPhoneValidationInfo ($userId, $number)

Get user db data (id, phone, is_validated)
- @param int $userId
- @param string $number
getClientSoapData ($clientId)

Returns current SOAP information by client id
- @param integer $clientId
- @return array
getClientSoapHistory ($clientId)

Returns SOAP history by client id
- @param integer $clientId
- @return array
updateClientSoapData ($clientId, $data)

Updates SOAP information if it was changed
- @param integer $clientId
- @param array $data
getClientSoapCryptData ($clientId)

Returns current SOAP (crypt) information by client id
- @param integer $clientId
- @return array
getClientSoapCryptHistory ($clientId)

Returns SOAP (crypt) history by client id
- @param integer $clientId
- @return array
updateClientSoapCryptData ($clientId, $data)

Updates SOAP (crypt) information if it was changed
- @param integer $clientId
- @param array $data
deleteCategories ($categories)

Delete given set of categories if it is possible
Returns an error with code -32001 if plugin is not activated. Use [[#isPluginActivated|isPluginActivated('event_category')]]

API method to check if plugin activated.
Returns an error with code -32101 if trying to delete default category and
an error with code -32102 if trying to delete all categories
Return an error with code -32002 if no $categories provided
- @param array $categories
- @return bool
deleteLocations ($locations)

Delete given set of locations if it is possible
Returns an error with code -32001 if plugin is not activated.

Use [[#isPluginActivated|isPluginActivated('location')]] API method to check if plugin activated.
Returns an error with code -32074 if trying to delete default location and
an error with code -32075 if trying to delete all locations
Returns an error with code -32002 if no $locations provided
- @param array $locations
- @return bool
addServiceProvider ($data)

Adds new service provider

Example:
{ "name" : "newtagg1 - 4", "description" : "Description - 1", "phone" : "1234567890", "email" : "test@test.com", "qty" : "2", "is_visible" : 1, "is_active" : 1, "position" : 2, "position_in_location" : null, "locations" : [ 3 ], "services" : [ 1, 2 ] }
- @param array $data
- @return Array
editServiceProvider ($id, $data)

Edit service provider
there is no way to delete provider via API, in this case set is_active = 0

Example:
{ "name" : "newtagg1 - 4", "description" : "Description - 1", "phone" : "1234567890", "email" : "test@test.com", "qty" : "2", "is_visible" : 1, "is_active" : 1, "position" : 2, "position_in_location" : null, "locations" : [ 3 ], "services" : [ 1, 2 ] }
- @param integer $id
- @param array $data
- @return Array
addService ($data)

Adds new service

Example:

{ "name":"Service name", "duration":"60", "hide_duration":"0", "description":"Service description", "is_public":"1", "is_active":"1", "position":"1", "file_id":null, "seo_url":null, "is_recurring":"0", "picture":null, "picture_sub_path":null, "picture_path":null, "recurring_settings":{ "days":7, "repeat_count":1, "type":"fixed", "mode":"skip", "is_default_settings":true, "days_names":[ "Friday", "Saturday", "Sunday" ] }, "units":[ 2, 3 ], "price":10, "currency":"USD", }
- @param array $data
- @return Array
editService ($id, $data)

Edit service
there is no way to delete service via API, in this case set is_active = 0

Example:
{ "name":"Service name", "duration":"60", "hide_duration":"0", "description":"Service description", "is_public":"1", "is_active":"1", "position":"1", "file_id":null, "seo_url":null, "is_recurring":"0", "picture":null, "picture_sub_path":null, "picture_path":null, "recurring_settings":{ "days":7, "repeat_count":1, "type":"fixed", "mode":"skip", "is_default_settings":true, "days_names":[ "Friday", "Saturday", "Sunday" ] }, "units":[ 2, 3 ], "categories":[ 2 ] "price":10, "currency":"USD", }
- @param integer $id
- @param array $data
- @return Array
editServiceCategory ($id, $data)

Edit service category

Example:

{ "name":"Category name", "description":"Category description", "is_default":1, "position":0,
- @param integer $id
- @param array $data
- @return Array
deleteServiceCategory ($id)

Delete service category
- @param integer $id
- @return Array
deleteServiceProviderLocation ($id)

Delete service provider location
- @param integer $id
- @return Array
addServiceCategory ($data)

Edit service category

Example:

{ "name":"Category name", "description":"Category description", "is_default":1, "position":0,
- @param array $data
- @return Array
editServiceProviderLocation ($id, $data)

Edit service provider location

Example:

{ "title":"Location mame", "description":"Locartion description", "address1":"Address 1", "address2":"Address 2", "city":"City", "zip":"12345", "country_id":"US", "lat":"0.00000000000000000000", "lng":"0.00000000000000000000", "phone":"11234567", "position":"1", "is_default":"1" }
- @param integer $id
- @param array $data
- @return Array
addServiceProviderLocation ($data)

Add service provider location

Example:

{ "title":"Location mame", "description":"Locartion description", "address1":"Address 1", "address2":"Address 2", "city":"City", "zip":"12345", "country_id":"US", "lat":"0.00000000000000000000", "lng":"0.00000000000000000000", "phone":"11234567", "position":"1", "is_default":"1" }
- @param array $data
- @return Array
getMembership ($membershipId)

Returns membership's data object.
- @param int $membershipId
- @return Array
getClientMembershipList ($clientId)

Returns purchased membership list
- @param Integer $clientId
- @return Array
saveConfigKeys ($data, $module, $plugin)

Save configuration keys
- @param array $data
- @param string $module optional
- @param string $plugin optional
- @return array
getNotificationConfigStructure ($plugin)

Get structure of SMS and Email notification config params
- @param string $plugin optional
- @return mixed
setWorkDayInfo ($info)

Set work day schedule for company|service|provider for week_day|date

Example:

{
"start_time":"10:00",
"end_time":"18:00",
"is_day_off":0,
"breaktime":[{"start_time":"14:00","end_time":"15:00"}],
"index":"1",
"name":"Monday",
"date":"",
"unit_group_id":"",
"event_id":""
}

index is 1-7 for Monday - Sunday (used for weekly settings)
date is used to set worktime for special date
unit_group_id is provider id
event_id is service id
if unit_group_id and event_id not passed then it set data for company
- @param array $info
- @return boolean true on success
deleteSpecialDay ($date, $params)

Delete special date if set

Example:

{
"unit_group_id":"",
"event_id":""
}
- @param string $date 'Y-m-d'
- @param array $params = null
- @return boolean true on success
getCompanyWorkCalendarForYear ($year)

Returns company special days and vacations
- @param Integer $year
- @return Object
getServiceWorkCalendarForYear ($year, $eventId)

Returns special days and vacations, defined for given service (event)
- @param Integer $year
- @param Integer $eventId
- @return Object
getCompanyVacations ()

Get list of company vacations in format array(vacation_id => array())
- @return array
getServiceVacations ($serviceId)

Get list of service vacations
- @param Integer $serviceId
- @return array
getPerformerVacations ($performerId)

Get list of performer vacations
- @param Integer $performerId
- @return array
getCompanyVacation ($vacationId)

Get company vacation by id
- @param Integer $vacationId
- @return array vacation table row data
getServiceVacation ($vacationId, $serviceId)

Get service vacation by id
- @param Integer $vacationId
- @param Integer $serviceId
- @return array vacation table row data
getPerformerVacation ($vacationId, $performerId)

Get service vacation by id
- @param Integer $vacationId
- @param Integer $performerId
- @return array vacation table row data
saveCompanyVacation ($data)

Save company vacation data
(create or update table depending on 'id' param existing in $data)
- @param array $data
- @return Integer id of saved vacation
saveServiceVacation ($data, $serviceId)

Save company vacation data
(create or update table depending on 'id' param existing in $data)
- @param array $data
- @param Integer $serviceId
- @return Integer id of saved vacation
savePerformerVacation ($data, $performerId)

Save company vacation data
(create or update table depending on 'id' param existing in $data)
- @param array $data
- @param Integer $performerId
- @return Integer id of saved vacation
deleteCompanyVacation ($vacationId)

Delete company vacation with all it's bindings
(including created special days in work_day_special table)
- @param Integer $vacationId
deleteServiceVacation ($vacationId, $serviceId)

Delete service vacation with all it's bindings
(including created special days in work_day_special table)
- @param Integer $vacationId
- @param Integer $serviceId
deletePerformerVacation ($vacationId, $unigGroupId)

Delete performer vacation with all it's bindings
(including created special days in work_day_special table)
- @param Integer $vacationId
- @param Integer $unigGroupId
getClassesList ($isVisibleOnly, $asArray)

Returns company's classes list. If $asArray is false then method returns a map with event id as key
and details object as value. If parameter set to true then method returns a list sorted by 'position' property of

class's details object.
- @param Boolean $isVisibleOnly
- @param Boolean $asArray
- @return Array
deleteClasses ($services)
- @internal Delete given classes if it is possible
- @param array $services
getProductList ($filter)

Returns product list with filter.
At this time filter can accept only service_id parameter
- @param object $filter
- @return array
deleteProduct ()

Delete given product or products if it is possible, otherwise set it as inactive
The $id param can be int or array of int
- @param integer
- @return bool
getPosReport ($request)

Get paginated data for Pos report

Return data in the following format:
array(
'data' => $data,
'metadata' => array(
'items_count'
'pages_count'
'page'
'on_page'
)
or Api_Service_Exception in error case
- @param Api_Paginator_Request $request
- @return array
getFeedbackReport ($request)

Get paginated data for Feedback report

The following filters can be provided in request param:
Date date_from, date_to
Integer from 1 to 5 rate_from, rate_to
String name, subject, message

Report can be ordered by one of the following fields:
date, rate, name, message, subject, answer

Return data in the following format:
array(
'data' => $data,
'metadata' => array(
'items_count'
'pages_count'
'page'
'on_page'
)
or Api_Service_Exception in error case
- @param Api_Paginator_Request $request
- @return array
getPromotionList ($isVisibleOnly, $asArray, $promotionType)

Get detailed list of promotions (new)
- @param bool $isVisibleOnly
- @param bool $asArray
- @param string $promotionType = 'discount' / 'gift_card' / null
- @return array
getPromotionInstanceList ($promotionType, $asArray)

Get all list of promotion instances
- @param string $promotionType = 'gift_card' | 'discount'
- @param bool $asArray
- @return array
getPromotionDetails ($id)

Return promotion detailed info
- @param integer $id
- @return array
getStaticPageList ()

Get static page list
- @return array
confirmInvoice ($id, $paymentSystem)

Confirms invoice by id
- @param integer $id
- @param string $paymentSystem
- @return array
- @throws Api_Entity_Exception
- @throws Zend_Db_Table_Exception
- @throws Zend_Exception
getCompanyParam ($key)

Returns company config value for key. A different set of keys available for public API and for company
administration API. Method return 'invalid params' error (code -32602) in case if access to specified key not

allowed. See [[#Company_params|list of available keys]].
- @param String $key
- @return mixed
getCompanyParams ($keys)

Returns company's config values for specified keys as key-value map. For non-existent and not-allowed param keys
it will return '''false''' as result. A different set of keys available for public API and for company

administration API. See [[#Company_params|list of available keys]].
- @param Array $keys
- @return Array
getTimelineType ()

Returns company timeline type
- @return String
getEventList ($isVisibleOnly, $asArray, $handleClasses, $searchString)

Returns company's events list. If $asArray is false then method returns a map with event id as key
and details object as value. If parameter set to true then method returns a list sorted by 'position' property of

event's details object.
- @param Boolean $isVisibleOnly
- @param Boolean $asArray
- @param integer $handleClasses 1 - classes only, -1 without classes, null - skip classes check
- @param string $searchString part of name (used for comboboxes)
- @return Array
getUnitList ($isVisibleOnly, $asArray, $handleClasses, $searchString)

Returns list of service performers. If $asArray is false then method returns a map with event id as
key and details object as value. If parameter set to true then method returns a list sorted by 'position' property

of event's details object.
- @param Boolean $isVisibleOnly
- @param Boolean $asArray
- @param integer $handleClasses 1 - classes only, -1 without classes, null - skip classes check
- @param string $searchString part of name (used for comboboxes)
- @return Array
getCategoriesList ($isPublic)

Returns company categories list if [[Plugins#Service categories|Service categories plugin]] is activated. Returns
an error with code -32001 if plugin is not activated. Use [[#isPluginActivated|isPluginActivated('event_category')]]

API method to check if plugin activated.
- @param Boolean $isPublic
- @return Array
getLocationsList ($isPublic, $asArray)

Returns available locations for company if plugin [[Plugins#Unit location|Unit location plugin]] is activated. Return
an error with code -32001 if plugin is not activated. Use [[#isPluginActivated|isPluginActivated('location')]]

API method to check if plugin activated.

This method accepts two boolean flags as parameters. If '''isPublic''' flag is '''true''' then method returns only
public locations. If '''asArray''' flag is '''true''' method returns list of objects. Otherwise method returns
map of objects with object id as key. You can omit both parameters.
- @param Boolean $isPublic Optional. Default value is '''false'''.
- @param bool $asArray Optional. Default value is '''false'''.
- @return Array
calculateEndTime ($startDateTime, $eventId, $unitId)

Returns end datetime if booking is available, else return false
- @param String $startDateTime a date and time string in format 'Y-m-d H:i:s', eg. '2001-10-02 13:30:00'.
- @param Integer $eventId
- @param Integer $unitId
- @return String
getWorkCalendar ($year, $month, )

Returns company work schedule as array
Eg.: {'2014-05-01': {'from': '09:00:00', 'to': '21:00:00', 'is_day_off': '0'}, '2014-05-02': ...}
- @param Integer $year
- @param Integer $month
- @param Integer
- @return Object
getReservedTime ($from, $to, $eventId, $unitId, $count)

Returns map of objects for each day in specified date range. The key of the result mps is a date string. The value
is an array of two objects. Both objects contains list of time slots for type reserved_time and type

not_worked_time. reserved_time type represents time slots working time but already booked
by clients. Nobody knows what kind of data represented by not_worked_time type. Please don't use it.

If [[Plugins#Google calendar sync plugin|Google calendar sync plugin]] enabled then object with
reserved_time type will contain not empty list of time slots marked as busy in Google calendar. Call
[[#isPluginActivated|isPluginActivated('google_calendar_export')]] API method to check if Google
calendar sync plugin activated.

Example:
```
  {

    "2016-02-05": [

      {

        "dd": [], // time slots from Google calendar

        "events": [ // reserved time slots

          { "from": "16:00", "to": "16:30" },

          { "from": "16:30", "to": "17:00" },

          ... ],

        "type": "reserved_time",

      },

      {

        "events": [

          { "from": "09:00", "to": "09:30" },

          { "from": "09:30", "to": "10:00" },

          ... ],

        "type": "not_worked_time"

     }],

     ...

  }
```
- @param String $from
- @param String $to
- @param Integer $eventId
- @param Integer $unitId
- @param Integer $count
- @return Object
getWorkDaysInfo ($from, $to, $unitId, $eventId, $count)

Returns an information about working hours and break times for specified service and performer for a period
between two dates. If only service specified then information about performer (or performers) will be taken from

service configuration. Method returns a list of objects for each date in specified period. Count of objects in
list depends on break times. For example if performer works from 9:00 till 19:00 with one hour break at 13:00 method
returns:
```
  {'2014-05-14' : [

    {'from': '09:00:00', 'to': '13:00:00'},

    {'from': '14:00:00', 'to': '19:00:00'}

  ] }
```
Warning! Method can return a time string '24:00:00' as right edge of time range. This happens in case if time
range finishes on midnight.
- @param String $from
- @param String $to
- @param Integer $unitId (optional)
- @param Integer $eventId (optional)
- @param Integer $count (optional)
- @return Object
getFirstWorkingDay ()

Returns first working date for unit
- @param Integer
- @return String
getStartTimeMatrix ($from, $to, $eventId, $unitId, $count)

Returns available start time, taking into account breaktimes, start and end working time
Eg.: {'2014-05-14': ['09:00:00', ...], ...}

If locations plugin activated for company you should pass a list as $unitID parameter for filter results with
units available only for selected location. See [[Plugins#Unit_location|Unit location]] plugin description for
more details.
- @param String $from
- @param String $to
- @param Integer $eventId
- @param Mixed $unitId can be Integer or Array of Integers
- @param Integer $count
- @return Object
getAvailableTimeIntervals ($dateFrom, $dateTo, $eventId, $unitId, $count)

Returns available time intervals for all service providers for given period, taking into account breaktimes, start and end working time
Eg.: {['2016-03-04': ['1': [['09:00:00','09:30:00'], ['11:15:00','14:45:00']] , ...], ...]}
- @param String $dateFrom
- @param String $dateTo
- @param Integer $eventId
- @param Mixed $unitId can be Integer or Array of Integers
- @param Integer $count
- @return Object
getServiceAvailableTimeIntervals ($dateFrom, $dateTo, $eventId, $unitId, $count)

Returns available time intervals for all servics for given period, taking into account breaktimes, start and end working time
Eg.: {['2016-03-04': ['1': [['09:00:00','09:30:00'], ['11:15:00','14:45:00']] , ...], ...]}
- @param String $dateFrom
- @param String $dateTo
- @param Mixed $eventId can be Integer or Array of Integers
- @param Integer $unitId
- @param Integer $count
- @return Object
getReservedTimeIntervals ($dateFrom, $dateTo, $eventId, , $count)

Returns not available time
Eg.: {'2014-05-14': [{'reserved_time': [{'from': '14:00', 'to': '16:30'}], 'type': "reserved_time"}, ...], ...}
- @param String $dateFrom
- @param String $dateTo
- @param Integer $eventId
- @param Integer
- @param Integer $count
- @return Object
getAvailableUnits ($eventId, $dateTime, $count)

Returns list of available unit ids for specified date and service or empty array if all units are not allowed.
Eg.: [1, 2, 3]
- @param Integer $eventId
- @param String $dateTime a date and time string in format 'Y-m-d H:i:s'
- @param Integer $count
- @return Array
filterAvailableUnits ($eventId, $dateTime, , $count)

Returns list of available unit ids for specified date and service from provided $unitIds list.
You can use this method with location plugin.

Returns empty array if all units are not allowed.
Eg.: [1, 2, 3]
- @param Integer $eventId
- @param String $dateTime a date and time string in format 'Y-m-d H:i:s'
- @param Array
- @param Integer $count
- @return Array
getAnyUnitData ()

Returns information about [[Plugins#Any_Employee_selector|Any Employee selector plugin]] configuration. Returns
null if plugin not enabled.

Example:
{
"description" : "Select this option, if you want to find an available time with any of the employees",
"hide_other_units" : 1, // 1 or 0
"image" : null,
"name" : "Any employee",
"picture_path" : null,
"random_selection" : 0 // 1 or 0
}
- @return Object
getAdditionalFields ($eventId)

Return additional fields for certain event if [[Plugins#Additional_fields|Additional fields plugin]] is
activated. Returns empty array otherwise. Call [[#isPluginActivated|isPluginActivated('event_field')]]

API method to check if 'event_field' plugin activated.
- @param Integer $eventId
- @return Array
getTimeframe ()

Returns company's timeframe configuration (in minutes). Timeframe can be either 5, 10, 15, 20, 30 or 60 minutes.
You can find more details about timeframe [[Settings#Timeframe|here]].
- @return Integer
isPluginActivated ($pluginName)

Return plugin status true if status active, else false. $pluginName parameter is a plugin identifier.
See [[Plugins|plugins]] page for full plugins description. See [[#Plugin's identifiers|list of available plugin's names]].
- @param String $pluginName
- @return Boolean
getPluginStatuses ($pluginNames)

Return plugin status true if status active, else false. See [[#Plugin's identifiers|list of available plugin's names]].
- @param Array $pluginNames
- @return Array
getCompanyInfo ()

Returns an object with detailed information about company. See [[#getCompanyInfo response|example of response]].
- @return Object
createBatch ()

Creates new booking batch record. Returns newly created batch id. You can use this id in [[#book|book]]
API method.
- @return Integer
getCountryPhoneCodes ()

Returns country phone code list
- @return Array
getPluginPromoInfoByCode ()

Returns an object with detailed information about promotion by promotion code. You can get promotion code
using [[Catalogue#getPromotionList|getPromotionList]] API method. If promotion record with specified

code not found then method returns an empty array (an empty object). If [[Plugins#Simply Smart Promotions|Simply Smart Promotions plugin]]
not enabled then method returns an error with code -32001 (Plugin is not activated). Use
[[#isPluginActivated|isPluginActivated('promo')]] API method call to check if plugin enabled.

See [[#getPromotionList response|example]] of getPromotionList API method response. Please note that
response contains a list of services for wich promotion discount can be applied (service_ids key).
- @param String
- @return Array
getCompanyTimezoneOffset ()

Returns company timezone offset and company timezone
- @return array

服务网址 https://user-api.simplybook.me/login

getServiceUrl ($companyLogin)

Returns API url for given company login
- @param String $companyLogin
- @return String
getToken ($companyLogin, $apiKey)

Returns an application's token string for a company. You should use this token to authenticate all calls of
[[Company public service methods|Company public service API methods]] and [[Catalogue|Catalogue API methods]]. To

get application API key you need to enable [[Plugins#API|API plugin]].
- @param String $companyLogin
- @param String $apiKey
- @return String
getUserToken ($companyLogin, $userLogin, $userPassword)

Returns an authentication token string for certain user registered for company. You should use this token to
authenticate all calls of [[Company administration service methods|Company administration service API methods]] and

[[Catalogue|Catalogue API methods]].
- @param String $companyLogin a company identifier (login)
- @param String $userLogin user's login associated with company
- @param String $userPassword user's password
- @return String
getApplicationToken ($applicationApiKey)

Returns an application's token string for an application. You should use this token to authenticate all calls of
[[Company public service methods|Company public service API methods]] and [[Catalogue|Catalogue API methods]]. To

get application API key please contact SimplyBook.me support team.
- @param String $applicationApiKey
- @return String

服务网址 https://user-api.simplybook.me/catalog

getCompanyList ($filter, $from, $limit)

Returns companies list

$filter filter params. Object that contains following params



'search_string': String,

'service_name': String,

'company_name': String,

'company_address': String,

'category_id': Integer,

'tag_ids': [Integer, Integer, ...],

'tags': String,

'country_id': String,

'city_id': String,

'nearby': {

    'radius': Integer,

    'center': {

       'lat': Number,

       'lng': NUmber

    }

}

Use tag_ids OR tags

@param Object $filter filter object
@param Integer $from from position
@param Integer $limit rows limit
@return array

getPromotionList ($filter, $from, $limit)

Returns active promotion list

$filter filter params. Object that contains following params



'search_string': String,

'service_name': String,

'company_name': String,

'company_address': String,

'tag_ids': [Integer, Integer, ...],

'tags': String,

'country_id': String,

'city_id': String,

'nearby': {

    'radius': Integer,

    'center': {

       'lat': Number,

       'lng': NUmber

    }

}

Use tag_ids OR tags

@param Object $filter filter object
@param Integer $from from position
@param Integer $limit rows limit
@return array

getPromotionListByIds ()

Returns active promotion list
- @param array
- @return array

getCompanyCount ($filter)

Returns total companies count with specified filter

$filter filter params. Object that contains following params



'search_string': String,

'service_name': String,

'company_name': String,

'company_address': String,

'tag_ids': [Integer, Integer, ...],

'tags': String,

'country_id': String,

'city_id': String,

'nearby': {

    'radius': Integer,

    'center': {

       'lat': Number,

       'lng': NUmber

    }

}

Use tag_ids OR tags

@param Object $filter filter object
@return array

getPromotionCount ($filter)

Returns total active promotions count with specified filter

$filter filter params. Object that contains following params



'search_string': String,

'service_name': String,

'company_name': String,

'company_address': String,

'tag_ids': [Integer, Integer, ...],

'tags': String,

'country_id': String,

'city_id': String,

'nearby': {

    'radius': Integer,

    'center': {

       'lat': Number,

       'lng': NUmber

    }

}

Use tag_ids OR tags

@param Object $filter filter object
@return array

getTopCountries ()

Returns country list as Array order by company count in country
- @return Array [{'id': ..., 'country': ...., 'count': ....}, ...]
getTopCities ()

Returns city list as Array order by company count in city
- @return Array [{'id': ..., 'city': ...., 'country_id': ...., 'count': .....}, ....]
getCountries ()

Returns a list of objects with just two properties each: id and country. An id
is a two character string with ISO 3166-1 country code.
- @return Array [{'id': ..., 'country': ...., 'count': ....}, ...]
getCities ($country, $withActiveCompany)

Returns a list of objects. If $country parametr specified then method returns only cities of this
country. Each object in list has 4 properties:

* id - number. A unique identificator of city. You should use it as filter options in methods getCompanyList.
* city - string. A city name.
* count_id - string. Two chars ISO 3166-1 country code.
* count - number.

Example:
```
  [{  

    "cnt" : 7,

    "country_id"" : "GB",

    "id" : 4607,

    "name" : "Uxbridge"

    },

    ...]
```
- @param String $country Optional. A two character ISO 3166-1 country code.
- @param bool $withActiveCompany
- @return Array [{'id': ..., 'city': ...., 'country_id': ...., 'count': .....}, ....]
getTags ($filter)

Returns tags list

$filter filter params. Object that contains following params
```
'tag_ids': [Integer, Integer, ...],

'tags': String,

'country_id': String,

'city_id': String
```
Use tag_ids OR tags
- @param Object $filter filter object
- @return Array [{'id': ..., 'tag': ...}, ....]
getCompanyInfo ($login)

Returns company information by company login
- @param String $login
- @return Object
getPromotionInfo ($id, $feedbackFrom, $feedbackCount)

Returns promotion information by id
- @param Integer $id
- @param Integer $feedbackFrom = 0
- @param Integer $feedbackCount = 100
- @return Object
getRelatedPromotions ($id, $count)

Returns related promotions by given promotion id
- @param Integer $id
- @param Integer $count = 10
- @return Array

getCompanyReviews ($login, $count, $offset)

Returns a list of company's review objects.



[{

  "company_id" : 86409,

  "domain" : "simplybook.me",

  "feedback_datetime" : "2015-10-27 13:06:57",

  "feedback_id" : 4623,

  "feedback_link" : "",

  "id" : 17384,

  "image" : "http://graph.facebook.com/1020443689023222/picture",

  "link" : "https://www.facebook.com/app_scoped_user_id/1020443689023222/",

  "message" : "Brilliant!",

  "name" : "Simply Booker",

  "provider" : "",

  "provider_data" : "...", // String. An object encoded with PHP's serialize method.

  "rate" : 5, // 0 to 5 rate

  "status" : "approved", // 'new' or 'approved'

  "subject" : "Good",

  "with_comment" : 1

},

...]

@see http://php.net/serialize
@param String $login
@param Integer $count
@param Integer $offset
@return Object

getCompanyReviewsCount ($login)

Returns company's reviews count
- @param String $login
- @return Integer
getCompanyReview ($login, $reviewId)

Returns a company's review objects.
- @param String $login
- @param Integer $reviewId
- @return Object
getClientReviewsLikes ($clientId, $clientProvider)

Returns a list of company's review likes.
- @param String $clientId
- @param String $clientProvider
- @return Object
addCompanyReview ($login, $subject, $message, $rate, $provider, $accessToken)

Adds company review
- @param String $login
- @param String $subject
- @param String $message
- @param Integer $rate
- @param String $provider
- @param String $accessToken
- @return Boolean
addPromotionReview ($promotionId, $subject, $message, $rate, $provider, $accessToken)

Add promotion review
- @param Integer $promotionId
- @param String $subject
- @param String $message
- @param Integer $rate
- @param String $provider
- @param String $accessToken
- @return Boolean
getPromotionReviews ($promotionId)

Returns promotion reviews list
- @param Integer $promotionId
- @return Object
getRecentPromotions ($count)

Returns list of promotions ordered by date DESC
- @param Integer $count
- @return Array
getRecentFeedbacks ($count)

Returns list of feedbacs ordered by date DESC
- @param Integer $count
- @return Array
getRecentCompanies ($count)

Returns list of companies ordered by date DESC
- @param Integer $count
- @return Array

getCategories ()

Returns all categories as list of objects. Each category can have a subcategories. Each subcategory contains parent
category id in company_category_id field. For top level categories this field is null and

is_header field is true.

Example:



  [{

     "company_category_id": null,

     "id": "1",

     "image": "/common/images/category_icons/car.png",

     "is_active": "1",

     "is_header": "1",

     "name": "Cars",

   },

   {

     "company_category_id": "1",

     "id" = 11;

     "image": null,

     "is_active": "1",

     "is_header": "0",

     "name": "Car wash",

   },

  ...]

@return Array

getFeedbackList ()

Get list of ALL simplybook feedbacks
- @return Array
getCompanyPromotionList ($promotionCompanyLogin, $count)

Returns a list of promotions objects associated with specified company. If company doesn't have any promotions or
[[Plugins#Simply_Smart_Promotions|Simply Smart Promotions plugin]] not active for this company method returns an

empty list.
- @param String $promotionCompanyLogin
- @param Integer $count Optional. Maximum amount of objects in response. Default value is 100.
- @return Array
getUserLocation ($ip)

Returns user location info
- @param String $ip optional
- @return Object

getAutocompleete ($filter, )

Returns suggestions for autocompeter

$filter filter params. Object that contains following params



'search_string': String,

'service_name': String,

'company_name': String,

'company_address': String,

'category_id': Integer,

'tag_ids': [Integer, Integer, ...],

'tags': String,

'country_id': String,

'city_id': String,

'nearby': {

    'radius': Integer,

    'center': {

       'lat': Number,

       'lng': NUmber

    }

}

Use tag_ids OR tags

@param Object $filter filter object
@param Boolean
@return array

deleteClientFeedbacks ($gdprDataSerialized)

Anonymize client feedbacks and feedback likes
according to GDPR client's right to be forgotten
- @param array $gdprDataSerialized

让您的客户不用离开您的应用程序就能预约服务！

支持中心

使用者 API 指南

API 探索器

API 说明文件

授权

客户端 API（公司的公开服务）授权

使用者 / 管理 API（公司的管理服务）授权

从服务器端代码之授权

从 SimplyВook.me 服务器取得数据

使用 API 密钥

SimplyВook.me 客制功能

预约功能代码流

取得 API 授权码

取得活动清单

取得执行者清单

依服务过滤执行者

取得有可预约时段的最近日期

将日历中的非工作时间设为无效

取得可预约的时段

确认是否有启用申请表客制功能

取得申请表

执行预约

摘要

API 功能

Company public service

Company administration service

Authentication

Catalogue

服务网址 https://user-api.simplybook.me/

getUnitList ($isVisibleOnly, $asArray, $handleClasses, $searchString)

getEventList ($isVisibleOnly, $asArray, $handleClasses, $searchString)

getCategoriesList ($isPublic)

getLocationsList ($isPublic)

getPaymentProcessorConfig ($paymentProcessor)

validatePayment ($paymentInfo, $cartId)

getBookingCart ($bookingIds)

getBookingCartInfo ($cartId, $sign)

getBookingCartStatus ($id)

confirmBookingCart ($cartId, $paymentProcessor, $sign)

confirmBooking ($id, $sign)

confirmBookingPayment ($id, $paymentProcessor, $sign)

confirmBookingBatch ($batchId, $batchType, $sign)

getBooking ($id, $sign)

getBookingDetails ($id, $sign)

isPaymentRequired ($eventId)

book ($eventId, $unitId, $date, $time, , , $count, $batchId, $recurringData)

getRecurringDatetimes ($eventId, $unitId, $date, $time, $recurringData)

hasUpcommingPromotions ()

validatePromoCode ($code, $startDateTime, $eventId, $count, )

getPromocodeInfo ($code)

getPromotionRewardInfo ($commonPromotionId, $clientId, $hash)

getUserLicenseText ()

getClientInfo ($clientId, $sign)

getClientInfoByLoginPassword ($login, $password)

remindClientPassword ($email)

getClientByLoginHash ($hash)

modifyClientInfo ($clientId, $data, $sign)

getMembershipList ()

getClientMembershipList ($filter, $clientId, $sign)

getClientBookings ($clientId, $sign, $filter)

membershipCheckClientAccess ($eventId, $clientId, $clientSign, $date, $count)

getProductList ($filter)

getClassesList ($filter)

getCompanyParam ($key)

getCompanyParams ($keys)

getTimelineType ()

calculateEndTime ($startDateTime, $eventId, $unitId)

getWorkCalendar ($year, $month, )

getReservedTime ($from, $to, $eventId, $unitId, $count)

getWorkDaysInfo ($from, $to, $unitId, $eventId, $count)

getFirstWorkingDay ()

getStartTimeMatrix ($from, $to, $eventId, $unitId, $count)

getAvailableTimeIntervals ($dateFrom, $dateTo, $eventId, $unitId, $count)

getServiceAvailableTimeIntervals ($dateFrom, $dateTo, $eventId, $unitId, $count)

getReservedTimeIntervals ($dateFrom, $dateTo, $eventId, , $count)

getAvailableUnits ($eventId, $dateTime, $count)

filterAvailableUnits ($eventId, $dateTime, , $count)

getAnyUnitData ()

getAdditionalFields ($eventId)