New Feature: Discovery API - Regional URL's for API calls¶
We're pleased to announce that V2 of iTero's Generic API can now implement Discovery API.
Discovery API prevents regional problems like ISP routing from affecting the end user experience and integration functionality. This helps prevent issues like false 'not paired' messages, orders not found, and more.
The regional value returned is retrieved from the clinic's or lab's address in the internal iTero system.
Some benefits of this endpoint:
- End users can work from outside their permanent address. Caller app will be routed to the correct region in cases where it is outside its intended geographical region, such as a business trip or other scenarios.
- If there is a change in the internal iTero base URL, the caller app will continue working since it references the regional URL and can't see the internal iTero URL.
- Therefore, changes from iTero's base URL will not break 3rd party applications.
Common questions:
How does this affect previous versions?
The old authorization flow still works normally. However, it is still at risk of being redirected to other regions. Moreover, the problem isn't as simple to fix since it's normally in the hands of the ISP.
How do I implement it?
One simple addition to the authorization flow will enable you to obtain the regional URL for all future API calls. No hardcoding necessary.
Is there any cost associated with this feature?
This feature is included in the API, no additional cost necessary.
How do I get this feature?
The feature is not turned on by default, please submit your request to iteroapisupport@aligntech.com, and we will be in contact with you.
To look at the specification, please visit: iTero Integrations Home Page