...
- In Maxxton software go to the "Channel managerIntegration Manager".
- In the menu on the left panel select "API users".
You can add integrations by clicking the Add integration button in the top right corner
- Company/user details: Fill in all fields with the details from the company that this API user will use and click "create API user".
Use a generic email for the company as this will probably later be used to inform on maintenance/changes to the REST API - Now the API user is created and we are going to configure the settings. Click "Next step" to proceed
- Admin organization: Choose which admin organization the new API user should have access to and click "Next step".
You can choose to grand access to all admin organizations or select the specific - The API user is totally configured and created now. The next step is to create an API key for the API user to be used to access the REST API. Click "Create credentials" to do this
- Application information: Fill in the name of the application that the API key will be used for and click "Next step" to proceed
- Distribution channel: Assign a specific distribution channel to be used by this API key(select "Use a predefined distribution channel") or keep it empty(select "Define distribution channel in API call") to give it access to the information of all distribution channels.
This means only data from the selected distribution channel will be available from the API. For example reservations, will only return the reservations created by the selected distributionchannel. Also for creating reservations only the selected distributionchannel can be used. This is the recommended way - Reservation Category: Assign a specific reservation category to be used by this API key(select "Use a predefined reservation category") or keep it empty(select "Define reservation category in API call") to give it access to creating reservations with only a specific reservation category or all available reservation categories by specifying this in the create reservation request.
- Release status: Choose which release statuses should be accessible from the specific API key. The lower the status the more data will be returned.
- Permissions: Choose the permissions for the API key. This will give access to the API endpoints using the provided permissions. In this way, you can limit the data available for the API key.
- For each permission there are 4 options: GET, PUT, POST and DELETE. The GET is to fetch(GET) data from the API, PUT will give the possibility to update existing data, POST will give the possibility to create new data(for example new reservations), DELETE will give the possibility to delete existing information.
- By clicking on the top icons you can give access to all endpoints at once. - After selecting all the permissions the API key should have access to click "Create credential" to create the API key.
- You will be provided with the client_id, API key, concern id, and an example authentication call. This can be used to authenticate to the API. See for more details on authenticating the documentation
- Click close to close the wizard and the API user and the key is available and can be used by the company/user who is going to build something against the Maxxton REST API.
...