Announced on | New API Rollout on | Old API Deprecated on |
March 2, 2023 | March 2, 2023 | September 1, 2023 |
Zendesk is pleased to announce a new and improved Status API.
What's changing?
Two things are changing. The legacy Status API is being deprecated and a new Status API is replacing it.
Specifically, the following legacy Status API endpoints are being deprecated:
- List components:
https://status.zendesk.com/api/components?domain={subdomain}.zendesk.com
- Show component status:
https://status.亚博zendesk.com/api/components/{成分nt_id_or_tag}?domain={subdomain}.zendesk.com
- List subcomponents:
https://status.亚博zendesk.com/api/components/{成分nt_id_or_tag}/subcomponents?domain={subdomain}.zendesk.com
- Show subcomponent status:
https://status.亚博zendesk.com/api/components/{成分nt_id_or_tag}/subcomponents{subcomponent_id_or_tag}?domain={subdomain}.zendesk.com
Those deprecated endpoints are being replaced with the following new Status API endpoints:
- List active incidents:
https://status.zendesk.com/api/incidents/active
- Show active incidents:
https://status.zendesk.com/api/incidents/{incident_id}
- List maintenance incidents:
https://status.zendesk.com/api/incidents/maintenance
Why is Zendesk making this change?
There are many advantages to moving towards these new endpoints. First, we're adding the ability for users to check for maintenance incidents via the API. This isn't currently possible.
Most importantly, however, the new endpoints improve the user experience of identifying incidents affecting your account by reducing the number of API queries required to check for incident impacts. For example, using the legacy Status API endpoints, it would require three queries to check the incident status of the Ticketing subcomponent of Support. One toget the Supportcomponent_id
, one toget the Ticketingsubcomponent_id
, and one using those id values toshow the status of the subcomponent. With the new endpoints, the information can be retrieved with a single query toshow active incidents.
What do I need to do?
If you're using the legacy Status API endpoints listed above, you must migrate to the new endpoints prior to the deprecation date. After this date, the legacy Status API endpoints won't be accessible and your requests won't be processed. For more information, see our detailed usage guide.
If you have any questions,contactZendesk Customer Support.
0 Comments
Pleasesign into leave a comment.