Overview of Integration API
An application programming interface (API) is a code-based specification that allows separate parties to talk to each other without having any previous knowledge or intervention. Sitepass has developed an integration API that provides a solution to integrate the Sitepass system with a third party systems. The Integration API allows third party systems to create and modify any data stored within Sitepass. This specifically refers to data relating to:Sitepass user accountsSitepass business accountsThe most common clients outcomes achieved using integration API are as follows:I only want the necessary information regarding my users (employees, contractors, etc) from my internal database (i.e. Chris21) to be uploaded and synchronised with SitepassNew users that are created in my internal database should be automatically set up in SitepassI want to manage user details from my internal database only. That would include adding new, updating existing, and disconnecting users.BenefitsComplete integration solutionFlexible and easily modifiable by the clientHigh levels of data integrityLow error-prone solutionLimitationsThe potential for larger development time and costCustom development will be requiredRequires prior knowledge of Sitepass and its functionalitySitepass APIThe Sitepass API is organised around Respresentational State Transfer (REST). Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication and verbs.Our client facing API's are protected by API keys that are specific to your account.API KeySitepass authenticates your API requests using your account specific API Key.  If you do not include your account specific API Key when making an API request, or use that is incorrect or outdated, Sitepass will returns an error.You need to provide your API key in a header property called x-api-key. For example, A CURL request would beAll API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. Sitepass DomainsTo ensure that your integration is always communicating with Sitepass, your integration must be able to reach any of Sitepass’s fully qualified domains for it to function properly. Depending on how your integration operates, you may need to whitelist it.To help your integration operate securely, it must verify that it’s communicating with the the listed domains.Sitepass API DomainsDepending on the environment you are trying to access, your API key and domains may vary.Production: api.app.mysitepass.com/external Beta: api.beta.mysitepass.com/external Sitepass EnvironmentsDepending on your Account setup, there are two environments available which are available to receive requests.Our Beta environment is available to our Enterprise customers and does not contain or effect data on our Production environment.  API keys for the Beta environment should be obtained from your Beta account.NOTE: Use only your beta API keys for testing and development. This ensures that you don't accidentally modify your live production data.