Authentication: Difference between revisions

From SimplyBook.me
No edit summary
No edit summary
Line 1: Line 1:
<languages/>
<translate>
{{#seo:
{{#seo:
|title=Authentication - SimplyBook.me
|title=Authentication - SimplyBook.me
Line 5: Line 7:
|keywords=faq, frequently asked questions, booking software, appointment system questions, appointments online, calendar software, booking system, booking calendar, scheduling software, online appointment scheduling, online scheduling, setup, setup help, support, help content
|keywords=faq, frequently asked questions, booking software, appointment system questions, appointments online, calendar software, booking system, booking calendar, scheduling software, online appointment scheduling, online scheduling, setup, setup help, support, help content
}}
}}
</translate>


 
<translate>
== Methods ==
== Methods ==


Line 21: Line 24:
Returns API url for given company login
Returns API url for given company login


 
</translate>
----
----
 
<translate>
=== getApplicationToken ===
=== getApplicationToken ===


Line 38: Line 41:
get application API key please contact SimplyBook.me support team.
get application API key please contact SimplyBook.me support team.


 
</translate>
----
----
 
<translate>
=== getToken ===
=== getToken ===


Line 56: Line 59:
get application API key you need to enable [[Custom_Features#API|API Custom Feature]].
get application API key you need to enable [[Custom_Features#API|API Custom Feature]].


 
</translate>
----
----
 
<translate>
=== getUserToken ===
=== getUserToken ===


Line 74: Line 77:
authenticate all calls of [[Company administration service methods|Company administration service API methods]] and
authenticate all calls of [[Company administration service methods|Company administration service API methods]] and
[[Catalogue|Catalogue API methods]].
[[Catalogue|Catalogue API methods]].
 
</translate>
----
----
 
<translate>
==Constants==
==Constants==


Line 88: Line 91:
* -33004 User is blocked
* -33004 User is blocked
* -33005 You are not allowed to use this application when HIPAA Custom Feature is enabled
* -33005 You are not allowed to use this application when HIPAA Custom Feature is enabled
</translate>

Revision as of 13:10, 15 May 2025

Methods

getServiceUrl

getServiceUrl($companyLogin)

Parameters:

  • $companyLogin String

Returns String.

Returns API url for given company login


getApplicationToken

getApplicationToken($applicationApiKey)

Parameters:

  • $applicationApiKey String

Returns String.

Returns an application's token string for an application. You should use this token to authenticate all calls of Company public service API methods and Catalogue API methods. To get application API key please contact SimplyBook.me support team.


getToken

getToken($companyLogin, $apiKey)

Parameters:

  • $companyLogin String
  • $apiKey String

Returns String.

Returns an application's token string for a company. You should use this token to authenticate all calls of Company public service API methods and Catalogue API methods. To get application API key you need to enable API Custom Feature.


getUserToken

getUserToken($companyLogin, $userLogin, $userPassword)

Parameters:

  • $companyLogin String a company identifier (login)
  • $userLogin String user's login associated with company
  • $userPassword String user's password

Returns String.

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


Constants

Error codes

See Errors handling for details.

  • -33001 Company does not exist
  • -33002 Wrong API key
  • -33003 User with this login and password not found
  • -33004 User is blocked
  • -33005 You are not allowed to use this application when HIPAA Custom Feature is enabled