Tenant status
Applications should ensure they don't attempt to connect to a particular tenant when the tenant is unavailable. SuperOffice offers both a pull and a push approach to get tenant status.
When a tenant installation experience state changes, the application should pause and resume according to the tenant's availability.
Status page (pull)
Each tenant has a status page where you can check its state to ensure your application remains stable and responds accordingly. The URL is environment-specific and contains the context identifier. For example:
https://**sod**.superoffice.com/api/state/**Cust00000**
Notifications (push)
When a tenant installation changes, SuperOffice sends a notification to each approved application.
To receive notifications, application vendors must provide a State Change URL that specifies where SuperOffice sends notifications. For example:
https://www.awesomeapp.com/NotifyCustomerStateChange
Tip
Notifications offer the ability to mitigate any potential errors that might occur due to state changes.