|
1 |
| -# Modify existing code to use Global Discovery Web API |
| 1 | +# Modify existing code to use Discovery Web API |
2 | 2 |
|
3 | 3 | The Discovery Service Web API can be used to discover instances for your users. If you currently use Organization Service SDK to discover your instances, you can follow the steps in this document to start consuming the Web API.
|
4 | 4 | A detailed description of the Web API can be found on the [Discovery Service Web API](/powerapps/developer/common-data-service/webapi/discover-url-organization-web-api) page.
|
5 | 5 |
|
6 |
| -If you currently use the Web API, it is recommended that you make sure to point to the Global Discovery service endpoint (https://globaldisco.crm.dynamics.com) of the Discovery service. |
| 6 | +If you currently use the Web API, it is recommended that you make sure to point to the global Discovery service endpoint (https://globaldisco.crm.dynamics.com) of the Discovery service. |
7 | 7 | The rest of this document describes the changes that might be needed to use the Web API
|
8 | 8 |
|
9 | 9 | ## Authentication
|
10 | 10 | The Discovery Service Web API supports authentication with OAuth 2.0 access tokens.
|
11 |
| -If your code uses WS-Trust SAML tokens, you will need to change code acquire OAuth 2.0 token from Azure AD, and pass it to the Global Discovery Service Web API call. |
| 11 | +If your code uses WS-Trust SAML tokens, you will need to change code acquire OAuth 2.0 token from Azure AD, and pass it to the Discovery Service Web API call. |
12 | 12 |
|
13 | 13 | ## OData API calls
|
14 | 14 | The calls below are supported by the Web API. These follow the OData v4 standard and
|
@@ -40,7 +40,7 @@ Response
|
40 | 40 | ```http
|
41 | 41 | GET https://globaldisco.crm.dynamics.com/api/discovery/v2.0/Instances(<guid>)
|
42 | 42 | ```
|
43 |
| -- Get a single instance by name |
| 43 | +- Get a single instance by unique name |
44 | 44 | ```http
|
45 | 45 | GET https://globaldisco.crm.dynamics.com/api/discovery/v2.0/Instances(UniqueName='myorg')
|
46 | 46 | ```
|
@@ -75,7 +75,7 @@ UniqueName|UniqueName
|
75 | 75 | UrlName|UrlName
|
76 | 76 |
|
77 | 77 | ## Deprecated API call
|
78 |
| -The WCF SDK call GetUserIdByExternalId is not supported in the Web API. |
| 78 | +The Organization Service SDK call GetUserIdByExternalId is not supported in the Web API. |
79 | 79 |
|
80 | 80 | ## See Also
|
81 | 81 | [Discovery Services](/powerapps/developer/common-data-service/discovery-service)
|
|
0 commit comments