User API guide/sv: Difference between revisions
Created page with "= '''ANVÄNDNING AV API-HEMLIG NYCKEL''' = <br><br> 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..." Tags: Mobile edit Mobile web edit |
Created page with "'''Initialisering av JSON-RPC-klient'''. <br><br> <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> <br><br>" Tags: Mobile edit Mobile web edit |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 222: | Line 222: | ||
<br><br> | <br><br> | ||
'''Kodexempel för att hämta intagsformulär''' | |||
''' | |||
<br><br> | <br><br> | ||
<nowiki>$fields = $client- | <nowiki>$fields = $client->getAdditionalFields($eventId); | ||
// | // returnerar - array(array( | ||
// 'name' = | // 'name' => 'b0657bafaec7a2c9800b923f959f8163', - fältnamn | ||
// 'title' = | // 'title' => 'Test digits', - fälttitel | ||
// 'type' = | // 'type' => 'digits', - fälttyp | ||
// 'values' = | // 'values' => null, - tillgängliga värden för fält av typ select | ||
// 'default' = | // 'default' => null, - standardvärde för fält | ||
// 'is_null' = | // 'is_null' => null, - kan fältet vara tomt | ||
// 'on_main_page' = | // 'on_main_page' => 1, | ||
// 'pos' = | // 'pos' => 1, - fältets position | ||
// 'value' = | // 'value' => null | ||
// )), ...)</nowiki> | // )), ...)</nowiki> | ||
<br><br><br> | <br><br><br> | ||
= '''SIMPLYBOOK ANPASSADE FUNKTIONER''' = | |||
='''SIMPLYBOOK | |||
<br><br> | <br><br> | ||
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> | ||
=''' | = '''KODFLÖDE FÖR BOKNINGSFUNKTIONER''' = | ||
<br><br> | <br><br> | ||
Auktorisera i Simplybook API med funktionen '''loginClient.getToken(companyLogin, apiKey);'''. | |||
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()]. | |||
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. | |||
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. | |||
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. | |||
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 | |||
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. | |||
Ring [https://simplybook.me/en/api/doc#book bokning($eventId, $unitId, $date, $time, $clientData, $additional, $count, $batchId)] för att göra en bokning. | |||
<br><br> | <br><br> | ||