Dynamics 365 Business Central: multiple production environments and web service endpoints

One of the most interesting features announced for the Wave 2 release of Dynamics 365 Business Central is the possibility to create multiple production environments for each tenant (this will include the option for environments to be on different country-specific or region-specific versions of Dynamics 365 Business Central).

In order to support this upcoming feature, endpoints of all web services (SOAP, OData, APIs) are actually updated to version 2.0.

The endpoints with version 1.0 (that many of you are still using now) will continue to work and they will permit you always to work with a single production environment (called Production) and with a single sandbox environment.

The 1.0 endpoints have the following format:

https://api.businesscentral.dynamics.com/v1.0/<Tenant ID>/api/v1.0/<entity>

Instead, the newly introduced 2.0 endpoints now supports a new environment name parameter, that must always be specified in order to redirect the call to the right Dynamics 365 Business Central environment.

The new 2.0 endpoint format is as follows:

https://api.businesscentral.dynamics.com/v2.0/<Tenant ID>/<Environment Name>/api/v1.0/<entity>

You can start using the new endpoint just now and the recommendation (if you have external applications that talks with a Dynamics 365 Business Central tenant) is to update your service endpoints now in order to be ready to support the new changes.

As an example, you can use a 2.0 endpoint now to retrieve customers for a specific company inn the production environment (actually only 1 and called Production) by sending a GET request to the following url:

https://api.businesscentral.dynamics.com/v2.0/<Tenant ID>/production/api/v1.0/companies(<CompanyID>)/customers

Please use the new endpoints as soon as possible if you want to be prepared for the upcoming future

 

Comment List
Related
Recommended