User API guide/sv - Revision history

Admin at 19:47, 16 February 2026

2026-02-16T19:47:58Z

← Older revision		Revision as of 19:47, 16 February 2026
Line 1:		Line 1:
	<languages/>		<languages/>
	~~<div class="mw-translate-fuzzy">~~		{{#seo: \|title=Användar-API-guide – SimplyBook.me \|description=SimplyBook.me API-dokumentation för utvecklare. Integrera bokningssystemet med anpassad programvara. REST API-endpoints, autentisering och exempel ingår.\|titlemode=lägg till \|keywords=faq, vanliga frågor, bokningsprogramvara, frågor om bokningssystem, onlinebokningar, kalenderprogramvara, bokningssystem, bokningskalender, schemaläggningsprogramvara, onlinebokning, onlinebokning, plugins, anpassade funktioner, anpassad bokningssida, domännamn, anpassat domännamn, anpassad webbadress }}
	{{#seo: \|title=Användar-API-guide – SimplyBook.me \|description=~~Använd~~ SimplyBook.me-~~användar-API~~ för ~~att skapa avancerade integrationer~~. ~~Följ vår guide för smidig implementering~~. ~~Läs mer här!~~ \|titlemode=lägg till \|keywords=faq, vanliga frågor, bokningsprogramvara, frågor om bokningssystem, onlinebokningar, kalenderprogramvara, bokningssystem, bokningskalender, schemaläggningsprogramvara, onlinebokning, onlinebokning, plugins, anpassade funktioner, anpassad bokningssida, domännamn, anpassat domännamn, anpassad webbadress }}
	~~</div>~~
	<br><br>		<br><br>

FuzzyBot: Updating to match new version of source page

2026-02-16T19:46:59Z

Updating to match new version of source page

← Older revision		Revision as of 19:46, 16 February 2026
Line 1:		Line 1:
	<languages/>		<languages/>
			<div class="mw-translate-fuzzy">
	{{#seo: \|title=Användar-API-guide – SimplyBook.me \|description=Använd SimplyBook.me-användar-API för att skapa avancerade integrationer. Följ vår guide för smidig implementering. Läs mer här! \|titlemode=lägg till \|keywords=faq, vanliga frågor, bokningsprogramvara, frågor om bokningssystem, onlinebokningar, kalenderprogramvara, bokningssystem, bokningskalender, schemaläggningsprogramvara, onlinebokning, onlinebokning, plugins, anpassade funktioner, anpassad bokningssida, domännamn, anpassat domännamn, anpassad webbadress }}		{{#seo: \|title=Användar-API-guide – SimplyBook.me \|description=Använd SimplyBook.me-användar-API för att skapa avancerade integrationer. Följ vår guide för smidig implementering. Läs mer här! \|titlemode=lägg till \|keywords=faq, vanliga frågor, bokningsprogramvara, frågor om bokningssystem, onlinebokningar, kalenderprogramvara, bokningssystem, bokningskalender, schemaläggningsprogramvara, onlinebokning, onlinebokning, plugins, anpassade funktioner, anpassad bokningssida, domännamn, anpassat domännamn, anpassad webbadress }}
			</div>
	<br><br>		<br><br>

Admin: Created page with "'''Initialisering av JSON-RPC-klient'''.

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) {} });

"

2025-05-15T12:22:00Z

Created page with "'''Initialisering av JSON-RPC-klient'''. <nowiki>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) {} });</nowiki> "

← Older revision		Revision as of 12:22, 15 May 2025
Line 264:		Line 264:


	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		Om den anpassade funktionen Intake Forms är aktiverad, anropa [https://simplybook.me/en/api/doc#isPluginActivated isPluginActivated("event_field")] och funktionen [https://simplybook.me/en/api/doc#getAdditionalFields getAdditionalFields($eventId)] för att hämta listan över fält som kunden ska fylla i.
	If Intake Forms ~~Custom Feature is activated~~ [https://simplybook.me/en/api/doc#isPluginActivated isPluginActivated("event_field")] ~~call~~ [https://simplybook.me/en/api/doc#getAdditionalFields getAdditionalFields($eventId)] ~~function to get list of fields for client to fill~~.
	~~</div>~~


	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		Ring [https://simplybook.me/en/api/doc#book bokning($eventId, $unitId, $date, $time, $clientData, $additional, $count, $batchId)] för att göra en bokning.
	~~Call~~ [https://simplybook.me/en/api/doc#book ~~book~~($eventId, $unitId, $date, $time, $clientData, $additional, $count, $batchId)] ~~to make a booking~~.
	~~</div>~~

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~
	<br><br>		<br><br>
	~~</div>~~

Admin: Created page with "= '''SIMPLYBOOK ANPASSADE FUNKTIONER''' =

Om ditt företag behöver ytterligare funktioner kan du aktivera några av våra extra anpassade funktioner. En komplett lista över anpassade funktioner med detaljerade beskrivningar finns i administratörsgränssnittet under länken "Anpassade funktioner". När den önskade anpassade funktionen har aktiverats aktiveras motsvarande API-metoder så att du kan använda dem i din kod.

= '''KODFLÖDE FÖR BOKNI..."

2025-05-15T12:21:57Z

Created page with "= '''SIMPLYBOOK ANPASSADE FUNKTIONER''' = Om ditt företag behöver ytterligare funktioner kan du aktivera några av våra extra anpassade funktioner. En komplett lista över anpassade funktioner med detaljerade beskrivningar finns i administratörsgränssnittet under länken "Anpassade funktioner". När den önskade anpassade funktionen har aktiverats aktiveras motsvarande API-metoder så att du kan använda dem i din kod. = '''KODFLÖDE FÖR BOKNI..."

← Older revision		Revision as of 12:21, 15 May 2025
Line 257:		Line 257:


	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		Använd [https://simplybook.me/en/api/doc#getStartTimeMatrix getStartTimeMatrix ($from som aktuellt datum, $to som aktuellt datum, $eventId, $unitId, $count som valt deltagarantal)] för att få tillgängliga tidsluckor för ett visst datum. '''$unitId''' ska vara null om alternativet Alla anställda är valt.
	~~Use~~ [https://simplybook.me/en/api/doc#getStartTimeMatrix getStartTimeMatrix ($from ~~as current date~~, $to ~~as current date~~, $eventId, $unitId, $count ~~as selected participants value~~ )] ~~to get available timeslots for given date~~. '''$unitId''' ~~should be~~ null ~~if Any employee option is selected~~.
	~~</div>~~


	~~<div lang=~~"en" ~~dir="ltr" class="mw-content-ltr">~~		Om valet "Alla anställda" är aktivt och någon anställd har valts, anropa [https://simplybook.me/en/api/doc#getAvailableUnits getAvailableUnits($eventId, $dateTime, $count)] för att hämta tillgängliga $unitId
	~~If Any Employee selector is active and Any employee was selected call~~ [https://simplybook.me/en/api/doc#getAvailableUnits getAvailableUnits($eventId, $dateTime, $count)] ~~to get available~~ $unitId
	~~</div>~~

Admin: Created page with "'''Kodexempel på bokning av tjänst och bekräftelse med hjälp av hemlig API-nyckel'''

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

2025-05-15T12:21:55Z

Created page with "'''Kodexempel på bokning av tjänst och bekräftelse med hjälp av hemlig API-nyckel''' <nowiki>$additionalFields = array( '6740d3bce747107ddb9a789cbb78abf3' => 'value1', 'b0657bafaec7a2c9800b923f959f8163' => 'value2' ); $clientData = array( 'name' => 'Kundnamn', 'email' => 'client@email.com', 'phone' => '+13152108338' ); $bookingsInfo = $client->book($eventId, $unitId, $date, $time, $clientData, $additionalFields);"

← Older revision		Revision as of 12:21, 15 May 2025
Line 254:		Line 254:


	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		Om någon anpassad funktion för val av anställd är aktiverad [https://simplybook.me/en/api/doc#isPluginActivated isPluginActivated("any_unit")] och ingen särskild varaktighet är angiven för paret tjänsteleverantör-tjänsteutförare i matrisen "unit_map", ska användaren kunna välja alternativet Valfri leverantör eller välja leverantör manuellt. Manuell val av tjänsteutförare ska dock inte vara möjligt om [https://simplybook.me/en/api/doc#getCompanyParam getCompanyParam("any_unit__hide_other_units")] är aktiverat.
	~~If Any Employee Selector Custom Feature is activated~~ [https://simplybook.me/en/api/doc#isPluginActivated isPluginActivated("any_unit")] ~~and no special duration is set for service~~-~~performer pair in~~ "unit_map" ~~array then user should be allowed to select Any provider option or choose provider manually~~. ~~But manual selection of performers should not be possible if~~ [https://simplybook.me/en/api/doc#getCompanyParam getCompanyParam("any_unit__hide_other_units")] ~~is enabled~~.
	~~</div>~~

Admin: Created page with "= '''KLIENT-API ([https://simplybook.me/api/doc#/admin FÖRETAGETS OFFENTLIGA TJÄNST]) AUTORISERING''' =

== '''Auktorisering från klientens kod''' ==

'''Hämta token-nyckeln'''.

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

'''Initialisering av JSON-RPC-klient.'''
..."

2025-05-15T12:21:53Z

Created page with "= '''KLIENT-API ([https://simplybook.me/api/doc#/admin FÖRETAGETS OFFENTLIGA TJÄNST]) AUTORISERING''' = == '''Auktorisering från klientens kod''' == '''Hämta token-nyckeln'''. <nowiki>var loginClient = new JSONRpcClient({ 'url': 'https://user-api.simplybook.me' + '/login', 'onerror': function (error) {}, }); var token = loginClient.getToken(YOUR_COMPANY_LOGIN, YOUR_API_KEY);</nowiki> '''Initialisering av JSON-RPC-klient.''' ..."

← Older revision		Revision as of 12:21, 15 May 2025
Line 238:		Line 238:
	<br><br><br>		<br><br><br>

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		= '''SIMPLYBOOK ANPASSADE FUNKTIONER''' =
	='''SIMPLYBOOK ~~CUSTOM FEATURES~~'''=
	<br><br>		<br><br>
	~~If your company specific requires some additional functionality you can activate some of our additional Custom Features~~. ~~The complete Custom Features list with detailed description is avaiable in your admin interface~~ under ~~the 'Custom Feature' link~~. ~~After the necessary Custom Feature is enabled the corresponding~~ API ~~methods will be activated so you can use them in your code~~.		Om ditt företag behöver ytterligare funktioner kan du aktivera några av våra extra anpassade funktioner. En komplett lista över anpassade funktioner med detaljerade beskrivningar finns i administratörsgränssnittet under länken "Anpassade funktioner". När den önskade anpassade funktionen har aktiverats aktiveras motsvarande API-metoder så att du kan använda dem i din kod.
	<br><br><br>		<br><br><br>
	='''~~BOOKING FUNCTIONALITY CODEFLOW~~'''=		= '''KODFLÖDE FÖR BOKNINGSFUNKTIONER''' =
	<br><br>		<br><br>
	~~Authorize in~~ Simplybook API ~~using~~ '''loginClient.getToken(companyLogin, apiKey);''' ~~function~~.		Auktorisera i Simplybook API med funktionen '''loginClient.getToken(companyLogin, apiKey);'''.
	~~</div>~~


	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		Kontrollera om tjänstekategorierna Anpassad funktion är aktiverade med [https://simplybook.me/en/api/doc#isPluginActivated isPluginActivated("event_category")]. Om ja, visa listan över kategorier med [https://simplybook.me/en/api/doc#getCategoriesList getCategoriesList()].
	~~Check if Service categories Custom Feature is activated by~~ [https://simplybook.me/en/api/doc#isPluginActivated isPluginActivated("event_category")] ~~if yes then display list of categories~~ [https://simplybook.me/en/api/doc#getCategoriesList getCategoriesList()].
	~~</div>~~


	~~<div lang="~~en~~" dir="ltr" class="mw-content-ltr">~~		Hämta en lista över tjänster (evenemang) och utförare (enheter) med hjälp av funktionerna [https://simplybook.me/en/api/doc#getEventList getEventList()] och [https://simplybook.me/en/api/doc#getUnitList getUnitList()]. Om arrayen "unit_map" är tillgänglig för en tjänst betyder det att denna tjänst endast kan tillhandahållas av angivna utförare.
	~~Get list of services~~ (~~events~~) ~~and performers~~ (~~units~~) ~~using~~ [https://simplybook.me/en/api/doc#getEventList getEventList()] ~~and~~ [https://simplybook.me/en/api/doc#getUnitList getUnitList()] ~~functions~~. If "unit_map" ~~array is available for service it means this service can be provided by given performers only~~.
	~~</div>~~

Admin: Created page with "'''Kodexempel för att hämta tjänstelistan'''

$services = $client->getEventList(); // returnerar array(array( // 'id' => 1, - tjänst-id // 'name' => 'Service 1', - tjänstens namn // 'description' => 'Beskriv din tjänst...', - tjänstens beskrivning // 'duration' => 60, - tjänstens varaktighet // 'hide_duration' => 0, - flagga för att dölja varaktighet för kunder, // 'picture' => null, - filnamn på b..."

2025-05-15T12:21:50Z

Created page with "'''Kodexempel för att hämta tjänstelistan''' <nowiki>$services = $client->getEventList(); // returnerar array(array( // 'id' => 1, - tjänst-id // 'name' => 'Service 1', - tjänstens namn // 'description' => 'Beskriv din tjänst...', - tjänstens beskrivning // 'duration' => 60, - tjänstens varaktighet // 'hide_duration' => 0, - flagga för att dölja varaktighet för kunder, // 'picture' => null, - filnamn på b..."

← Older revision		Revision as of 12:21, 15 May 2025
Line 222:		Line 222:
	<br><br>		<br><br>

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		'''Kodexempel för att hämta intagsformulär'''
	'''~~Code example of getting intake forms~~'''
	<br><br>		<br><br>
	<nowiki>$fields = $client->getAdditionalFields($eventId);		<nowiki>$fields = $client->getAdditionalFields($eventId);
	// ~~returns~~ - array(array(		// returnerar - array(array(
	// 'name' => 'b0657bafaec7a2c9800b923f959f8163', - ~~field name~~		// 'name' => 'b0657bafaec7a2c9800b923f959f8163', - fältnamn
	// 'title' => 'Test digits', - ~~field title~~		// 'title' => 'Test digits', - fälttitel
	// 'type' => 'digits', - ~~field type~~		// 'type' => 'digits', - fälttyp
	// 'values' => null, - ~~available values for~~ select ~~field type~~		// 'values' => null, - tillgängliga värden för fält av typ select
	// 'default' => null, - ~~default value for field~~		// 'default' => null, - standardvärde för fält
	// 'is_null' => null, - ~~is filed nullable~~		// 'is_null' => null, - kan fältet vara tomt
	// 'on_main_page' => 1,		// 'on_main_page' => 1,
	// 'pos' => 1, - ~~field~~ position		// 'pos' => 1, - fältets position
	// 'value' => null		// 'value' => null
	// )), ...)</nowiki>		// )), ...)</nowiki>
	<br><br><br>		<br><br><br>
	~~</div>~~

	<div lang="en" dir="ltr" class="mw-content-ltr">		<div lang="en" dir="ltr" class="mw-content-ltr">

Admin: Created page with "= '''ANVÄNDNING AV API-HEMLIG NYCKEL''' =

I vissa fall kan bokningsmetoden kräva bekräftelse, t.ex. om du accepterar betalningar från kunder bekräftar du bokningen först efter att betalningen har kommit in. Simplybook API:s bekräftelsemetod tar boknings-id och säker signatur som parametrar (en annan metod som kräver säker signatur är cancelBookng). För att generera en säker signatur måste du använda din hemliga API-nyckel. Se hur det går till i e..."

2025-05-15T12:21:49Z

Created page with "= '''ANVÄNDNING AV API-HEMLIG NYCKEL''' = I vissa fall kan bokningsmetoden kräva bekräftelse, t.ex. om du accepterar betalningar från kunder bekräftar du bokningen först efter att betalningen har kommit in. Simplybook API:s bekräftelsemetod tar boknings-id och säker signatur som parametrar (en annan metod som kräver säker signatur är cancelBookng). För att generera en säker signatur måste du använda din hemliga API-nyckel. Se hur det går till i e..."

← Older revision		Revision as of 12:21, 15 May 2025
Line 188:		Line 188:
	<br><br>		<br><br>

	~~<div lang="~~en~~" dir="ltr" class="mw-content-ltr">~~		När en kund klickar på knappen Bekräfta bokning måste du anropa metoden book. Detta är huvudfunktionen som utför alla nödvändiga valideringar och registrerar en ny bokning i Simplybook-systemet. Den tar information om bokningen, kunddata som namn och telefonnummer samt några ytterligare parametrar. Se alla parametrarbeskrivningar för denna metod i [https://simplybook.me/api/doc listan över API-funktioner]. Svaret från bokningsmetoden innehåller en unik kod och andra detaljer om den nya bokningen eller en lista över fel om några problem har uppstått, så att du kan använda denna information för att visa bokningsresultatet för kunden på ett bekvämt och intuitivt sätt.
	~~When a client clicks confirm booking button you have to call~~ book ~~method~~. ~~This is the main function which performs all necessary validations and registers a new booking in~~ Simplybook ~~system~~. ~~It takes~~ information ~~about booking~~, ~~client data like name and phone and some additional params~~. ~~See all params descriptions of this method in~~ [https://simplybook.me/api/doc API ~~functions list~~]. ~~The book method responce contains an uniqe code and other details of the new booking or the list of errors if some problems occured~~, ~~so you can use this~~ information ~~to show booking result to a client in convinient and intuitive way~~.
	<br><br><br>		<br><br><br>
	~~</div>~~

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		= '''ANVÄNDNING AV API-HEMLIG NYCKEL''' =
	='''~~USING OF~~ API ~~SECRET KEY~~'''=
	<br><br>		<br><br>
	~~In some cases the book method may require the confirmation~~, e.g. ~~if your accept payments from clients you confirm booking only after the payment is already came~~. ~~The~~ Simplybook API ~~confirmBookng method takes booking~~-id ~~and secure signature as params~~ (~~another method which requires secure signature is~~ cancelBookng). ~~For the secure signature generation your secret~~ API-~~key should be used~~. ~~See how it can be done in the example below~~. ~~You can find the secret key at~~ admin ~~interface~~ under ~~'Settings' link of~~ API ~~Custom Feature in 'Custom Features' list~~.		I vissa fall kan bokningsmetoden kräva bekräftelse, t.ex. om du accepterar betalningar från kunder bekräftar du bokningen först efter att betalningen har kommit in. Simplybook API:s bekräftelsemetod tar boknings-id och säker signatur som parametrar (en annan metod som kräver säker signatur är cancelBookng). För att generera en säker signatur måste du använda din hemliga API-nyckel. Se hur det går till i exemplet nedan. Du hittar den hemliga nyckeln i admin-gränssnittet under länken "Inställningar" i API-anpassade funktioner i listan "Anpassade funktioner".
	<br><br>		<br><br>
	~~</div>~~

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		'''Kodexempel på bokning av tjänst och bekräftelse med hjälp av hemlig API-nyckel'''
	'''~~Code example of service booking and its confirmation using secret~~ API ~~key~~'''
	<br><br>		<br><br>
	<nowiki>$additionalFields = array(		<nowiki>$additionalFields = array(
	'6740d3bce747107ddb9a789cbb78abf3' => 'value1',		'6740d3bce747107ddb9a789cbb78abf3' => 'value1',
	'b0657bafaec7a2c9800b923f959f8163' => 'value2'		'b0657bafaec7a2c9800b923f959f8163' => 'value2'
	);		);
	$clientData = array(		$clientData = array(
	'name' => '~~Client name~~',		'name' => 'Kundnamn',
	'email' => 'client@email.com',		'email' => 'client@email.com',
	'phone' => '+13152108338'		'phone' => '+13152108338'
	);		);

	$bookingsInfo = $client->book($eventId, $unitId, $date, $time, $clientData, $additionalFields);		$bookingsInfo = $client->book($eventId, $unitId, $date, $time, $clientData, $additionalFields);
	~~</div>~~

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		if ($bookingsInfo->require_confirm) {
	if ($bookingsInfo->require_confirm) {		foreach ($bookingsInfo->bookings as $booking) {
	foreach ($bookingsInfo->bookings as $booking) {		$sign = md5($booking->id . $booking->hash . YOUR_API_SECRET_KEY);
	$sign = md5($booking->id . $booking->hash . YOUR_API_SECRET_KEY);		$result = $client->confirmBooking($booking->id, $sign);
	$result = $client->confirmBooking($booking->id, $sign);		echo '
	echo '		Bekräfta resultat
	~~Confirm result~~
	';		';
	var_dump($result);		var_dump($result);
	}		}
	}</nowiki>		}</nowiki>
	<br><br>		<br><br>
	~~</div>~~

	<div lang="en" dir="ltr" class="mw-content-ltr">		<div lang="en" dir="ltr" class="mw-content-ltr">

Admin: Created page with "= '''ANVÄNDARE/ADMIN API ([https://simplybook.me/api/doc#/admin FÖRETAGSADMINISTRATIONSTJÄNST]) AUTORISATION''' =

== '''Auktorisering från klientens kod''' ==

'''Hämta token-nyckeln.'''

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);

"

2025-05-15T12:21:43Z

Created page with "= '''ANVÄNDARE/ADMIN API ([https://simplybook.me/api/doc#/admin FÖRETAGSADMINISTRATIONSTJÄNST]) AUTORISATION''' = == '''Auktorisering från klientens kod''' == '''Hämta token-nyckeln.''' <nowiki>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);</nowiki> "

← Older revision		Revision as of 12:21, 15 May 2025
Line 152:		Line 152:
	<br><br>		<br><br>

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		<nowiki>$year = 2015;
	<nowiki>$year = 2015;		$month = 3; // mars
	$month = 3; // ~~March~~		$performerId = 1; // Kan vara null
	$performerId = 1; // ~~Can be~~ null		$workDaysInfo = $client->getWorkCalendar($year, $month, $performerId);
	$workDaysInfo = $client->getWorkCalendar($year, $month, $performerId);		// returnerar array(
	// ~~returns~~ array(		// '2015-03-01' => array('from' => '09:00:00', 'to' => '18:00:00', 'is_day_off' => 0),
	// '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),
	// '2015-03-02' => array('from' => '09:00:00', 'to' => '18:00:00', 'is_day_off' => 0),
	// ...		// ...
	//);</nowiki>		//);</nowiki>
	<br><br>		<br><br>
	'''~~Code example of getting start time matrix~~'''		'''Kodexempel för att hämta starttidsmatris'''
	<br><br>		<br><br>
	<nowiki>$dateFrom = '2015-03-03';		<nowiki>$dateFrom = '2015-03-03';
Line 170:		Line 169:
	$performerId = 1;		$performerId = 1;
	$qty = 1;		$qty = 1;
	$availableTime = $client->getStartTimeMatrix($dateFrom, $dateTo, $serviceId, $performerId, $qty);		$availableTime = $client->getStartTimeMatrix($dateFrom, $dateTo, $serviceId, $performerId, $qty);
	// ~~returns~~ array(		// returnerar array(
	// '2015-03-03' => array('09:00:00', '09:30:00', '10:00:00', ....),		// '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', ....),		// '2015-03-04' => array('09:00:00', '09:30:00', '10:00:00', ....),
	//);</nowiki>		//);</nowiki>
	<br><br>		<br><br>
	~~</div>~~

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		En annan användbar metod som du kan behöva är calculateEndTime. Varje tjänst kan ha sin egen varaktighet, och dina anställda kan ha olika arbetsscheman från dag till dag. Med den här metoden kan du visa en kund slutdatum och sluttid för den tjänst han eller hon har bokat på ett korrekt sätt.
	~~Another usefull method you may need is~~ calculateEndTime. ~~Each service can have its own duration~~, ~~also your company's employees possible have different work schedule form day to day~~. ~~So using this method you can show to a client an end date and time of the service he've booked in a correct way~~.
	<br><br>		<br><br>
	'''~~Code example of calculating booking end time~~'''		'''Kodexempel för beräkning av bokningens sluttid'''
	<br><br>		<br><br>
	<nowiki>$startDateTime = '2015-03-03 09:00:00';		<nowiki>$startDateTime = '2015-03-03 09:00:00';
	$serviceId = 1;		$serviceId = 1;
	$performerId = 1;		$performerId = 1;
	$availableTime = $client->calculateEndTime($startDateTime, $serviceId, $performerId);		$availableTime = $client->calculateEndTime($startDateTime, $serviceId, $performerId);
	// ~~returns~~ '2015-03-03 10:00:00'		// returnerar '2015-03-03 10:00:00'
	</nowiki>		</nowiki>
	<br><br>		<br><br>
	~~</div>~~

	<div lang="en" dir="ltr" class="mw-content-ltr">		<div lang="en" dir="ltr" class="mw-content-ltr">

Admin: Created page with "Använd vårt utvecklings-API för att skapa ditt eget bokningsgränssnitt. Du kan utforma vilken lösning du vill, från den enklaste widgeten till en multifunktionell applikation med funktioner anpassade efter just ditt företag."

2025-05-15T12:21:39Z

Created page with "Använd vårt utvecklings-API för att skapa ditt eget bokningsgränssnitt. Du kan utforma vilken lösning du vill, från den enklaste widgeten till en multifunktionell applikation med funktioner anpassade efter just ditt företag."

← Older revision		Revision as of 12:21, 15 May 2025
Line 109:		Line 109:
	En bokningssida är vanligtvis en sida där kunder väljer den tjänst de behöver, en anställd och en tid för sitt möte. Därefter anger kunden sina kontaktuppgifter och bekräftar bokningen. Mer komplexa lösningar kan innefatta ifyllande av olika intagsformulär, gruppbokningar, bokningar av flera tider och så vidare. Låt oss beskriva arbetsflödet för att skapa den enklaste bokningssidan. Om du sedan behöver lägga till ytterligare funktioner till din sida hittar du en fullständig lista över [https://simplybook.me/api/doc Simplybook API-metoder] här.		En bokningssida är vanligtvis en sida där kunder väljer den tjänst de behöver, en anställd och en tid för sitt möte. Därefter anger kunden sina kontaktuppgifter och bekräftar bokningen. Mer komplexa lösningar kan innefatta ifyllande av olika intagsformulär, gruppbokningar, bokningar av flera tider och så vidare. Låt oss beskriva arbetsflödet för att skapa den enklaste bokningssidan. Om du sedan behöver lägga till ytterligare funktioner till din sida hittar du en fullständig lista över [https://simplybook.me/api/doc Simplybook API-metoder] här.

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		Det första du bör visa är listan över tjänster och listan över anställda. Hämta dessa data med metoderna getEventList och getUnitList. Båda returnerar en lista med fullständig information om varje objekt i listan, så du har många möjligheter att visa tjänster och anställda på din sida. För att filtrera anställda använder du egenskapen unit_map i tjänstelistan, som innehåller information om anställda som kan tillhandahålla den valda tjänsten.
	~~So the first thing you should display is the list of services and the list of employes~~. ~~Get this~~ data by getEventList ~~and~~ getUnitList ~~methods~~. ~~They both return a list with complete~~ information ~~about each item in it~~, ~~so you have many possibilities how to display services and employees at your page~~. ~~To make employee filtration use~~ unit_map ~~property of the service list~~, ~~it contains the info about employees who can provide the selected service~~.
	<br><br>		<br><br>
	~~</div>~~

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		'''Kodexempel för att hämta tjänstelistan'''
	'''~~Code example of getting services list~~'''
	<br><br>		<br><br>
	<nowiki>$services = $client->getEventList();		<nowiki>$services = $client->getEventList();
	// ~~returns~~ array(array(		// returnerar array(array(
	// 'id' => 1, - ~~service~~ id		// 'id' => 1, - tjänst-id
	// 'name' => 'Service 1', - ~~service's name~~		// 'name' => 'Service 1', - tjänstens namn
	// 'description' => '~~Describe your service~~...', - ~~service description~~		// 'description' => 'Beskriv din tjänst...', - tjänstens beskrivning
	// 'duration' => 60, - ~~service duration~~		// 'duration' => 60, - tjänstens varaktighet
	// 'hide_duration' => 0, - ~~Hide duration to clients flag~~,		// 'hide_duration' => 0, - flagga för att dölja varaktighet för kunder,
	// 'picture' => null, - ~~file name of picture or~~ null		// 'picture' => null, - filnamn på bild eller null
	// 'picture_path' => '/uploads/apidemo/event__picture/small/', - ~~full path to picture~~,		// 'picture_path' => '/uploads/apidemo/event__picture/small/', - fullständig sökväg till bild,
	// 'position' => 1 - ~~service~~ position		// 'position' => 1 - tjänstens position
	// 'is_active' => 1, - ~~the service is activated~~		// 'is_active' => 1, - tjänsten är aktiverad
	// 'is_public' => 1, - ~~the service is allowed to book by clients~~		// 'is_public' => 1, - tjänsten får bokas av kunder
	// ), ...)</nowiki>		// ), ...)</nowiki>
	<br><br>		<br><br>
	~~</div>~~

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		'''Kodexempel för att hämta en lista över tjänsteleverantörer'''
	'''~~Code example of getting service performers list~~'''
	<br><br>		<br><br>
	<nowiki>$services = $client->getUnitList();		<nowiki>$services = $client->getUnitList();
	// ~~returns~~ array(array(		// returnerar array(array(
	// 'id' => 1, - ~~performer~~ id		// 'id' => 1, - leverantörs-id
	// 'name' => 'Provider 1', - ~~performer name~~		// 'name' => 'Provider 1', - utförarens namn
	// 'phone' => '111111111', - ~~perfomer phone number~~		// 'phone' => '111111111', - utförarens telefonnummer
	// 'description' => '~~Describe your performer~~...', - ~~performer description~~		// 'description' => 'Beskriv din utförare...', - beskrivning av utföraren
	// 'email' => 'test@gmail.com', - ~~perfomer email~~,		// 'email' => 'test@gmail.com', - utförarens e-postadress,
	// 'is_active' => 1, - ~~the performer is activated~~		// 'is_active' => 1, - utföraren är aktiv
	// 'is_visible' => 1, - ~~the perfomer is visible for clients~~,		// 'is_visible' => 1, - artisten är synlig för kunder,
	// 'picture' => null, - ~~file name of picture or~~ null,		// 'picture' => null, - filnamn på bild eller null,
	// 'picure_path' => '/uploads/apidemo/unit_group__picture/small/', - ~~full path to picture~~		// 'picure_path' => '/uploads/apidemo/unit_group__picture/small/', - fullständig sökväg till bild
	// 'position' => 1, - ~~performer~~ position		// 'position' => 1, - artistens position
	// 'qty' => 1, ~~performer quantity~~		// 'qty' => 1, antal artister
	// ), ...)</nowiki>		// ), ...)</nowiki>
	<br><br>		<br><br>
	~~</div>~~

	~~<div lang="~~en~~" dir="ltr" class="mw-content-ltr">~~		Nästa steg för en kund är att välja datum och tid för sin tjänst. Vi har använt en Bootstrap-datumväljare i API-användningsexemplet, men du kan också använda denna eller någon annan kalender. För att ställa in första datum i kalendern använder du metoden getFirstWorkingDay. Den kan ta anställd-id som parameter och returnerar nästa datum när den valda anställda (eller någon anställd i företaget som standard) är tillgänglig för bokning. För att visa tidsluckor inom ett valt datum behöver du metoderna getWorkCalendar och getStartTimeMatrix. Den första metoden ger dig information om arbetsdagens start- och sluttid samt om lediga dagar. Den andra returnerar en lista över tidsluckor som kan bokas för ett visst datum.
	~~The next step to a client is to pick a date and time of his service~~. ~~We've used a~~ Bootstrap ~~date~~-~~picker in~~ API-~~usage example~~, ~~you can also use this or any other calendar~~. ~~To set your calendar first date use~~ getFirstWorkingDay ~~method~~. ~~It can take employee~~ id ~~as a~~ parameter ~~and returns the next date when the selected employee~~ (~~or any employee in the company by default~~) ~~is avaiable for booking~~. ~~To show time slots inside a selected date you need~~ getWorkCalendar ~~and~~ getStartTimeMatrix ~~methods~~. ~~The first method give you an~~ information ~~about working day~~ start ~~and end time, and about day~~-~~offs~~. ~~And the second one returns the list of time-slots which can be booked for a certain date~~.
	<br><br>		<br><br>
	'''~~Code example of getting work days info~~'''		'''Kodexempel för att hämta information om arbetsdagar'''
	<br><br>		<br><br>
	~~</div>~~

	<div lang="en" dir="ltr" class="mw-content-ltr">		<div lang="en" dir="ltr" class="mw-content-ltr">

User API guide/sv - Revision history

Admin at 19:47, 16 February 2026

FuzzyBot: Updating to match new version of source page

Admin: Created page with "'''Initialisering av JSON-RPC-klient'''. 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) {} }); "

Admin: Created page with "Använd vårt utvecklings-API för att skapa ditt eget bokningsgränssnitt. Du kan utforma vilken lösning du vill, från den enklaste widgeten till en multifunktionell applikation med funktioner anpassade efter just ditt företag."

Admin: Created page with "'''Initialisering av JSON-RPC-klient'''.

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) {} });

"