Merge pull request #2 from PatrickFarley/face-updates

Face updates

Author: JinyuID

articles/ai-services/computer-vision/concept-face-liveness-quick-link.md

@@ -7,33 +7,32 @@ manager: nitinme
 
 ms.service: azure-ai-vision
 ms.subservice: azure-ai-face
-ms.custom:
 ms.topic: conceptual
 ms.date: 05/15/2025
 ms.author: pafarley
 feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
-# Face Liveness Quick Link (Preview)
+# Face Liveness quick link (Preview)
 
 This article explains the concept of Face liveness quick link, its usage flow, and related concepts.
 
 ## Introduction
 
-Azure Liveness Quick Link is an optional integration path for [Face liveness detection](concept-face-liveness-detection.md). It exchanges a liveness session’s session-authorization-token for a single use URL that hosts the capture experience on an Azure operated page. The service returns to a developer supplied callback endpoint after finishing the operation. 
+Azure Face Liveness quick link is an optional integration path for [Face liveness detection](concept-face-liveness-detection.md). It exchanges a liveness session’s session-authorization-token for a single-use URL that hosts the face capture experience on an Azure-operated page. The service returns to a developer-supplied callback endpoint after finishing the operation. 
 
-Azure Liveness Quick Link provides multiple benefits to customers: 
-- No need to embed the liveness client SDK. Easier integration in application side.
-- No need to keep track of liveness client SDK updates. Azure operated websites always use the latest and greatest version of liveness detection.
+Azure Liveness quick link provides multiple benefits to customers: 
+- You don't need to embed the liveness client SDK. That allows for easier integration on the application side.
+- You don't need to keep track of liveness client SDK updates. Azure-operated websites always use the latest version of liveness detection.
 
 ## How it works
 
-You can utilize the liveness quick link website liveness.face.azure.com to turn a liveness session into a shareable, single use link:
+You can use the liveness quick link website, `liveness.face.azure.com`, to turn a liveness session into a shareable, single use link:
 
 :::image type="content" source="media/liveness/liveness-quick-link-diagram.png" alt-text="A diagram illustrates liveness quick link work flow":::
 
-1.	Start a session server side. Your backend asks Face API for a new liveness session and receives a short lived authorization token that represents that session.
-2.	Swap the token for a link. Your backend sends the token to the Quick Link service, which creates a one time URL tied to the session. here are examples to post request:
+1.	Start a session with your server-side code. Your application backend requests a new liveness session from the Face API and receives a short-lived authorization token that represents that session.
+2.	Swap the session token for a link. Your application backend sends the token to the quick link service, which creates a one-time URL connected to the session. Here are examples of the post request:
 
     #### [C#](#tab/csharp)
     ```csharp
@@ -113,16 +112,20 @@ You can utilize the liveness quick link website liveness.face.azure.com to turn
     curl --request POST \
       --url https://liveness.face.azure.com/api/s \
       --header 'authorization: Bearer <session-authorization-token>'
-    ```    
-
-An example response:
-```json
-{
-  "url": "/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f"
-}
-```
-Compose the returned url after liveness quick link web site `https://liveness.face.azure.com/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f`
-
-3.	Send the link to the user. You can redirect the browser, show a button, or display a QR code—anything that gets the user to open the link on a camera enabled device.
-4.	Azure hosts the capture. When the link opens, the Azure operated page guides the user through the liveness check sequence using the latest Liveness Web Client.
-5.	Get the outcome callback. As soon as the check finishes—or if the user abandons or times out—Quick Link notify to your callback endpoint so your application can decide what happens next.
+    ```
+
+---
+
+    The following is an example response:
+    
+    ```json
+    {
+      "url": "/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f"
+    }
+    ```
+
+    Use that value to construct the liveness quick link web page: `https://liveness.face.azure.com/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f`
+
+1. Send the link to the user. You can redirect the browser, show a button, or display a QR code—anything that lets the user open the link on a camera-enabled device.
+1. Azure hosts the capture experience. When the link opens, the Azure-operated page guides the user through the liveness check sequence using the latest Liveness web client.
+1. Get the outcome callback. As soon as the check finishes—or if the user abandons or times out—the quick link service notifies your callback endpoint so your application can decide what happens next.