Merge pull request #78641 from KingdomOfEnds/dt-refresh

swagger doc refreshed

Author: American-Dipper

articles/digital-twins/how-to-use-swagger.md

@@ -6,7 +6,7 @@ manager: alinast
 ms.service: digital-twins
 services: digital-twins
 ms.topic: conceptual
-ms.date: 12/31/2018
+ms.date: 06/03/2019
 ms.author: v-adgera
 ms.custom: seodec18
 ---
@@ -37,15 +37,15 @@ The automatically generated Swagger reference material supplies a quick overview
 
 A concise summary describes the API.
 
-![Swagger top][1]
+[![Swagger top](media/how-to-use-swagger/swagger_management_top.PNG)](media/how-to-use-swagger/swagger_management_top.PNG#lightbox)
 
 Management API object models are also listed.
 
-![Swagger models][2]
+[![Swagger models](media/how-to-use-swagger/swagger_management_models.PNG)](media/how-to-use-swagger/swagger_management_models.PNG#lightbox)
 
 You can select each listed object model for a more detailed summary of key attributes.
 
-![Swagger model][3]
+[![Swagger model](media/how-to-use-swagger/swagger_management_model.PNG)](media/how-to-use-swagger/swagger_management_model.PNG#lightbox)
 
 The generated Swagger object models are convenient to see all available Azure Digital Twins [objects and APIs](./concepts-objectmodel-spatialgraph.md). Developers can use this resource when they build solutions on Azure Digital Twins.
 
@@ -59,7 +59,7 @@ Each listed endpoint also includes the required request information, such as the
 * Required parameter data types.
 * HTTP method to access the resource.
 
-![Swagger endpoints][4]
+[![Swagger endpoints](media/how-to-use-swagger/swagger_management_endpoints.PNG)](media/how-to-use-swagger/swagger_management_endpoints.PNG#lightbox)
 
 To see a more detailed overview, select each resource.
 
@@ -69,19 +69,19 @@ One of the powerful functionalities Swagger provides is the ability to test an A
 
 After you select a specific endpoint, you see **Try it out**.
 
-![Swagger try][5]
+[![Swagger try](media/how-to-use-swagger/swagger_management_try.PNG)](media/how-to-use-swagger/swagger_management_try.PNG#lightbox)
 
 Expand that section to bring up input fields for each required and optional parameter. Enter the correct values, and select **Execute**.
 
-![Swagger tried][6]
+[![Swagger tried](media/how-to-use-swagger/swagger_management_tried.PNG)](media/how-to-use-swagger/swagger_management_tried.PNG#lightbox)
 
 After you execute the test, you can validate the response data.
 
 ## Swagger response data
 
 Each listed endpoint also includes response body data to validate your development and tests. These examples include the status codes and JSON you want to see for successful HTTP requests.
 
-![Swagger response][7]
+[![Swagger response](media/how-to-use-swagger/swagger_management_response.PNG)](media/how-to-use-swagger/swagger_management_response.PNG#lightbox)
 
 The examples also include error codes to help debug or improve failing tests.
 
@@ -113,31 +113,22 @@ To learn more about interactively testing requests protected by OAuth 2.0, see t
 
 5. Copy the ID of your Azure AD app.
 
-6. Click the Authorize button on your swagger page.
+After completing the Azure Active Directory registration:
 
-    ![Swagger authorize button](../../includes/media/digital-twins-permissions/swagger-select-authorize-btn.png)
+6. Click the **Authorize** button on your swagger page.
 
-7. Paste the application ID into the client_id field.
+    [![Click the Swagger authorize button](media/how-to-use-swagger/swagger-select-authorize-btn.png)](media/how-to-use-swagger/swagger-select-authorize-btn.png#lightbox)
 
-    ![Swagger client_id field](../../includes/media/digital-twins-permissions/swagger-auth-form.png)
+7. Paste the application ID into the **client_id** field.
 
-    ![Swagger grant application permissions](../../includes/media/digital-twins-permissions/swagger-grant-application-permissions.png)
+    [![Swagger client_id field](media/how-to-use-swagger/swagger-auth-form.png)](media/how-to-use-swagger/swagger-auth-form.png#lightbox)
 
-8. You should now see the Bearer authentication token passed in the authorization header and the identity of the logged in user displayed in the result.
+8. You will then be redirected to the following success modal.
 
-    ![Swagger token result](../../includes/media/digital-twins-permissions/swagger-token-example.png)
+    [![Swagger redirect modal](media/how-to-use-swagger/swagger_auth_redirect.PNG)](media/how-to-use-swagger/swagger_auth_redirect.PNG#lightbox)
 
 ## Next steps
 
 - To read more about Azure Digital Twins object models and the spatial intelligence graph, read [Understand Azure Digital Twins object models](./concepts-objectmodel-spatialgraph.md).
 
-- To learn how to authenticate with your Management API, read [Authenticate with APIs](./security-authenticating-apis.md).
-
-<!-- Images -->
-[1]: media/how-to-use-swagger/swagger_management_top.PNG
-[2]: media/how-to-use-swagger/swagger_management_models.PNG
-[3]: media/how-to-use-swagger/swagger_management_model.PNG
-[4]: media/how-to-use-swagger/swagger_management_endpoints.PNG
-[5]: media/how-to-use-swagger/swagger_management_try.PNG
-[6]: media/how-to-use-swagger/swagger_management_tried.PNG
-[7]: media/how-to-use-swagger/swagger_management_response.PNG
+- To learn how to authenticate with your Management API, read [Authenticate with APIs](./security-authenticating-apis.md).