Goki API
Marketplace Apps
Read this document if you are developing an app that should be listed in the Goki marketplace and can be used by all properties in the world. If you want to limit your app you need to follow this document.

What is a Marketplace App?

Most likely you want to use this type of integration, as you want your app to be listed in the marketplace and used by any property in the world. If you are a PMS integrating with Goki this is the option you need to read.
In order to get your marketplace app requests authenticated you need 2 tokens:
  1. 1.
    client-token: A unique token for your marketplace app.
  2. 2.
    access-token: A unique token for the property which is using your app

Client Token

You need to contact our integration team at [email protected] to register your marketplace app in Goki (staging environment). Once your app is created by the integration team, all properties including your test property (which you use for development) can see it on the marketplace list.
In order to create your marketplace app you need to provide the below information:
  • App Name
  • Support email address
  • App icon (500x500px)
  • Short summary (Maximum 10 words).
  • Long summary (Around 2-4 lines).

Access Token

To secure the properties data per integration, we generate a unique access-token per integration. Each property can find its unique access token in the settings > marketplace > your-app-icon > access token.
Each property has a different access-token and they can change it at any time. It is recommended you implement a user interface and let the property managers enter it themselves.
How to get access token for a test property
Please note the authentication headers are not shown in API calls, but they are mandatory based on the type of integration you are building.