User API guide/sv: Difference between revisions

Created page with "Åtkomsttoken kan implementeras antingen från klientsidan eller från din server, vilket är den säkrare lösningen."
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."
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-&gt;getEventList();
// returns array(array(
// returnerar array(array(
//    'id' => 1, - service id
//    'id' =&gt; 1, - tjänst-id
//    'name' => 'Service 1', - service's name
//    'name' =&gt; 'Service 1', - tjänstens namn
//    'description' => 'Describe your service...', - service description
//    'description' =&gt; 'Beskriv din tjänst...', - tjänstens beskrivning
//    'duration' => 60, - service duration
//    'duration' =&gt; 60, - tjänstens varaktighet
//    'hide_duration' => 0, - Hide duration to clients flag,
//    'hide_duration' =&gt; 0, - flagga för att dölja varaktighet för kunder,
//    'picture' => null, - file name of picture or null
//    'picture' =&gt; null, - filnamn på bild eller null
//    'picture_path' => '/uploads/apidemo/event__picture/small/', - full path to picture,
//    'picture_path' =&gt; '/uploads/apidemo/event__picture/small/', - fullständig sökväg till bild,
//    'position' => 1 - service position
//    'position' =&gt; 1 - tjänstens position
//    'is_active' => 1, - the service is activated
//    'is_active' =&gt; 1, - tjänsten är aktiverad
//    'is_public' => 1, - the service is allowed to book by clients
//    'is_public' =&gt; 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-&gt;getUnitList();
// returns array(array(
// returnerar array(array(
//    'id' => 1, - performer id
//    'id' =&gt; 1, - leverantörs-id
//    'name' => 'Provider 1', - performer name
//    'name' =&gt; 'Provider 1', - utförarens namn
//    'phone' => '111111111', - perfomer phone number
//    'phone' =&gt; '111111111', - utförarens telefonnummer
//    'description' => 'Describe your performer...', - performer description
//    'description' =&gt; 'Beskriv din utförare...', - beskrivning av utföraren
//    'email' => 'test@gmail.com', - perfomer email,
//    'email' =&gt; 'test@gmail.com', - utförarens e-postadress,
//    'is_active' => 1, - the performer is activated
//    'is_active' =&gt; 1, - utföraren är aktiv
//    'is_visible' => 1, - the perfomer is visible for clients,
//    'is_visible' =&gt; 1, - artisten är synlig för kunder,
//    'picture' => null, - file name of picture or null,
//    'picture' =&gt; null, - filnamn på bild eller null,
//    'picure_path' => '/uploads/apidemo/unit_group__picture/small/', - full path to picture
//    'picure_path' =&gt; '/uploads/apidemo/unit_group__picture/small/', - fullständig sökväg till bild
//    'position' => 1, - performer position
//    'position' =&gt; 1, - artistens position
//    'qty' => 1, performer quantity
//    'qty' =&gt; 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">