Application Installation for a Location

Request

Step 2 of the two-step installation handshake — the partner confirms the installation and delivers integration settings.

Host: this partner callback is served from the https://app.alteg.io > root — not under https://api.alteg.io/api/v1. The full URL is > https://app.alteg.io/marketplace/partner/callback.

After the owner grants access with Connect an Application to a Location the application–location link is pending. Send this callback with your Partner Token (Account settings) to move the link to active, link the system user, and apply the integration settings below.

Confirmation window: you have 1 hour after the owner connects to send this callback. If you do not confirm in time, the link stays pending and the owner must reconnect. Verify the resulting status with Application Status Data for Any Location.

See the end-to-end Install & test your app before moderation guide.

Security

BearerPartner

Acceptstringrequired

e.g. application/vnd.api.v2+json

Example:application/vnd.api.v2+json

Bodyapplication/json

salon_idnumberrequired

Location ID.

Example:123

application_idnumberrequired

Application ID.

Example:123

api_keynumber

API-key for messaging module.

Example:"2f181e2a-5c22-4ae7-9d9b-07104f312c28"

webhook_urlsArray of strings

Webhooks array

Example:

[
  "https://example.com/webhook"
]

curl -i -X POST \
  https://developer.alteg.io/_mock/en/developers/openapi/marketplace/partner/callback \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "salon_id": 123,
    "application_id": 123,
    "api_key": "2f181e2a-5c22-4ae7-9d9b-07104f312c28",
    "webhook_urls": [
      "https://example.com/webhook"
    ]
  }'

Responses

All parameters installed

Response

No content