Changes

no edit summary
Line 67: Line 67:  
Returns Boolean.
 
Returns Boolean.
   −
Cancel booking. Signature is required
+
Cancels a booking. <code>$sign</code> parameter must be a string created with formula: <code>md5($bookingId . $bookingHash . $secretKey)
$sign = md5($bookingId . $bookingHash . $secretKey);
+
</code>. You can get <code>$bookingHash</code> value as result of <code>[[#book|book]]</code> 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 <code>$sign</code> parameter is wrong.
      Line 224: Line 226:  
Returns Object.
 
Returns Object.
   −
Returns booking info. Signature is required
+
Returns an object with details information about booking. <code>$sign</code> parameter must be a string created
$sign = md5($bookingId . $bookingHash . $secretKey);
+
with formula: <code>md5($bookingId . $bookingHash . $secretKey)</code>. You can get <code>$bookingHash</code>
 +
value as result of <code>[[#book|book]]</code> 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 <code>$sign</code> parameter is wrong.
      Line 241: Line 246:  
Returns Object.
 
Returns Object.
   −
Returns detailed booking info. Signature is required
+
Returns an object with details information about booking. <code>$sign</code> parameter must be a string created
$sign = md5($bookingId . $bookingHash . $secretKey);
+
with formula: <code>md5($bookingId . $bookingHash . $secretKey)</code>. You can get <code>$bookingHash</code>
 +
value as result of <code>[[#book|book]]</code> 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 <code>$sign</code> parameter is wrong.
      Line 271: Line 279:  
Returns Object.
 
Returns Object.
   −
Returns company information
+
Returns an object with detailed information about company. See [[#getCompanyInfo response|example of response]].
      Line 316: Line 324:  
Returns Array.
 
Returns Array.
   −
Returns company active events list
+
Returns company's events list. If <code>$asArray</code> 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.
      Line 364: Line 374:     
Returns payment processor config
 
Returns payment processor config
 +
 +
 +
----
 +
 +
=== getPluginPromoInfoByCode ===
 +
 +
<code>getPluginPromoInfoByCode($code)</code>
 +
 +
Parameters:
 +
 +
* '''$code''' 
 +
 +
Returns Array.
 +
 +
Return promotion information by code
      Line 393: Line 418:  
Returns Array|null.
 
Returns Array|null.
   −
Returns promocode information by code
+
Returns an object with detailed information about promotion by promotion code. Returns null if no promotions with
 +
specified code were not found.
      Line 449: Line 475:  
Returns Integer.
 
Returns Integer.
   −
Returns company timeframe
+
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]].
      Line 465: Line 491:  
Returns Array.
 
Returns Array.
   −
Returns active service performrs list
+
Returns list of service performers. If <code>$asArray</code> 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.
      Line 496: Line 524:  
* '''$from''' String  
 
* '''$from''' String  
 
* '''$to''' String  
 
* '''$to''' String  
* '''$unitId''' Integer  
+
* '''$unitId''' Integer (optional)
* '''$eventId''' null
+
* '''$eventId''' Integer (optional)
    
Returns Object.
 
Returns Object.
Line 530: Line 558:     
Return true if event payments plugin is turned on and prices were set,
 
Return true if event payments plugin is turned on and prices were set,
else return false
+
else return false.
      Line 786: Line 814:  
     "recurrent_batch_id":"1",
 
     "recurrent_batch_id":"1",
 
     "batch_hash":"357178bce290381bb7235080941ec143"
 
     "batch_hash":"357178bce290381bb7235080941ec143"
 +
  }
 +
 +
====getCompanyInfo response====
 +
 +
An example of data returned by [[#getCompanyInfo|getCompanyInfo]] API method.
 +
 +
  {
 +
    "login": "pierrecoetzee",
 +
    "name": "Pierre",
 +
    "description": "Write a description about your company or about you as a service provider. You can add other service providers inside the system and each can have his own description.",
 +
    "address1": "",
 +
    "address2": "Storey's Gate, ",
 +
    "city": "London",
 +
    "country_id": "GB",
 +
    "lat": "51.500435",
 +
    "lng": "-0.129811",
 +
    "email": "pierre.coe@gmail.com",
 +
    "phone": "",
 +
    "web":null,"skip_address":null,"logo":null,"address": "GB, London, Storey's Gate, ",
 +
    "description_text": "Write a description about your company or about you as a service provider. You can add other service providers inside the system and each can have his own description.",
 +
    "timezone": "Europe London",
 +
    "show_in_client_timezone":false,"timeframe": "60",
 +
    "timeline_type": "modern_week",
 +
    "allow_event_day_break": "0",
 +
    "allow_event_breaktime_break": "0"
 
   }
 
   }