Link Search Menu Expand Document
Wherewolf

Self Service: Your Own UI

If you choose to support self-service in your own UI, you can use the following API endpoints to configure integrations:

  1. POST /integration/install/[YOUR-BOOKING-SYSTEM]
  2. POST /integration/uninstall/[YOUR-BOOKING-SYSTEM]

Where [YOUR-BOOKING-SYSTEM] is the internal name given to your booking system by Wherewolf. This name will be defined when a new integration is added to the list of Wherewolf supported integrations.

Installation Flow

  1. User opens your booking system’s dashboard and finds an integrations or marketplace option.
  2. User finds the Wherewolf integration, inputs their Wherewolf app pool id and clicks the install button.
  3. Your system executes the API call to install the integration. This call will contain the app pool id provided by the user and any other information that you may want to share with Wherewolf such as account information or fresh api keys.
  4. Wherewolf will store the received details and issue a new API key for the target Wherewolf app pool.
  5. Wherewolf will respond with a success message, webhook url and api key.
  6. Your system will then configure the Wherewolf webhook url in your system and store the api key.

Global vs App Pool API Keys

Installation calls made by your system will contain an api key parameter that will be used to identify your system and allow the installation to be completed. The api key for the installation call is a global and unique key that represents your system.

After the installation is completed, Wherewolf will issue a new api key for the target app pool. This api key will be unique to the app pool and will be used to identify the app pool and accept the webhook calls your system will make on behalf of the app pool.

You need to store the global api key as part of your system level configuration and never exposed. The app pool api key may be stored at account level and used for calls made on behalf of the app pool such as webhook calls.

Example Install API Call

The following is an example of an installation call made to Wherewolf.

curl --request POST \
  --url http://localhost:1337/integration/install/fareharbor \
  --header 'content-type: application/json' \
  --data '{
  "key": "[YOUR-GLOBAL-INSTALL-API-KEY]",
  "pool": "[TARGET-WHEREWOLF-APP-POOL-ID]",
  "accountId": [ACCOUNT-ID-IN-YOUR-SYSTEM],
  "api-key": [API-KEY-THAT-GRANTS-ACCESS-TO-ACCOUNT-IN-YOUR-SYSTEM]
}'

Where:

[YOUR-GLOBAL-INSTALL-API-KEY] is the global api key for your system.

[TARGET-WHEREWOLF-APP-POOL-ID] is the id of the app pool you wish to install.

[ACCOUNT-ID-IN-YOUR-SYSTEM] is the id of the account in your system.

[API-KEY-THAT-GRANTS-ACCESS-TO-ACCOUNT-IN-YOUR-SYSTEM] is the api key you generate that grants access to the account in your system and allows Wherewolf to fetch booking data.