Business Central エンドポイント
Microsoft Dynamics 365 Business Central は、データに接続するための複数の異なるエンドポイントを、次の2つのカテゴリに分けてサポートしています。Common Service エンドポイントとWeb Services エンドポイントです。 各カテゴリ内では、各エンドポイントのセットはProduction エンドポイントとTesting エンドポイントに分割されます。 Production エンドポイントにはOAuth 接続が必要ですが、Testing エンドポイントにはUser およびAccessKey 経由で接続できます。 Production エンドポイントとTesting エンドポイントは同じデータにアクセスし、相互作用することに注意してください。両者の主な違いは、許可される認証の種類です。
Note： クラウド版ではBasic 認証はサポートされなくなりました。
デフォルトでは、https://businesscentral.dynamics.com/ URL が指定されている場合、OrganizationURL はCommon Service Production エンドポイントへの解決を試みます。 ただし、これはEndpointType を変更することで設定ができます。 さらに、https://api.businesscentral.dynamics.com/ を指定すると、EndpointType およびUseSandbox の両方がオーバーライドされ、Microsoft Dynamics 365 Business Central は指定されたOrganizationURL をそのまま使用します。
Common Service エンドポイント
Common Service エンドポイントには、Microsoft Dynamics 365 Business Central に関連付けられたビジネスデータが含まれています。 例えば、アカウント、受注、売上請求はすべてCommon Service にあります。
Common Service エンドポイント：Production
- https://api.businesscentral.dynamics.com/v2.0/{environment name}/api/v2.0
- https://api.businesscentral.dynamics.com/v1.0/api/v2.0
- https://api.businesscentral.dynamics.com/v2.0/sandbox/api/v2.0
Common Service エンドポイント：Testing
- https://api.businesscentral.dynamics.com/v2.0/{tenant id}/{environment name}/api/v2.0
- https://api.businesscentral.dynamics.com/v1.0/{tenant id}/api/v2.0
- https://api.businesscentral.dynamics.com/v2.0/{tenant id}/sandbox/api/v2.0
Note： Tenant Id はBusiness Central アプリを利用できるAzure のテナントのID です。 これを見つけるには、次のいずれかを実行します：
- portal.azure.com にログインし、ユーザー名を選択してSwitch Directory に移動します。
- portal.azure.com にログインし、Active Directory に移動して、概要に移動します。
https://businesscentral.dynamics.com/{tenant id}/admin にある環境名を探してください。
Web Services エンドポイント
Web Service エンドポイントには、Microsoft Dynamics 365 Business Central でカスタム公開されたものがすべて含まれます。 これには、KPI、レポート、個々のエンティティ、もしくはその他のフィードが含まれる場合があります。 これらのエンドポイントで公開されている情報を確認するには、Service に移動し、虫眼鏡をクリックしてWeb Services と検索します。
Web Services エンドポイント - Production
- https://api.businesscentral.dynamics.com/v1.0/ODataV4/
Web Services エンドポイント - Testing
- https://api.businesscentral.dynamics.com/v1.0/{tenant id}/ODataV4/
Custom API エンドポイント
カスタムAPI エンドポイントに接続するには、OrganizationURL をカスタムベースURL に設定します。形式は次のとおりです。 https://api.businesscentral.dynamics.com/v2.0/{tenant}/api/{API publisher}/{API group}/{API version}