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 in 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 🙂

 

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.