使用 Vuforia API 存取資料 > Vuforia API > 存取程序執行資料 > 進行 API 呼叫 > 傳回包含步驟資料之指定序號所有已完成及已提交的工作階段
  
傳回包含步驟資料之指定序號所有已完成及已提交的工作階段
如要傳回包含步驟資料之指定序號所有已完成及已提交的工作階段,請執行下列指令:
curl -X 'POST' 'https://vuforia.ptc.com/customer-events/<orgid>/report' \
-H 'accept: application/json' \
-H 'x-requested-with: fetch' \
-H 'x-api-key: <x-api-key secret>' \
-H 'Content-Type: application/json' \
-d '{ "serialNumber": <serial#>, "granularity": "step" }'
在預設情況下,如果擷取含有步驟等更細微資訊的執行資料,也會傳回為必備意見反應之步驟所產生的所有事件。例如,如果使用者在 Vuforia Vantage 執行程序並選取 「失敗」狀態,然後再將其變更為「通過」狀態,則會在同一步驟產生多個事件 (類似以下範例)。依 (步驟) numberendTime 排序事件。使用 (步驟) number 清單中的最新事件,即可找到步驟的最近事件。
* 
我們不建議使用 endTime 來判斷步驟的最新事件。系統日後會根據「將使用者資訊及日期從檢視者 Insights 中移除」設定縮短 endTime
傳回的結果應與以下範例相似:
{
"items": [
{
"sessionId": "ec4dfff9-d280-42c2-bff4-03d154924de9",
"procedure": {
"id": "2f0560f0-d5e9-11eb-9796-856502905bf2",
"title": "****",
"versionId": "a63e70d0150f3b2ba1cf9e81",
"versionName": "8.0",
"startTime": "2024-01-12T03:35:19.425Z",
"latestEventTimestamp": "2024-01-12T03:39:19.894Z",
"endTime": "2024-01-12T03:39:19.894Z",
"status": "incomplete",
"progress": "completed",
"feedback": "incomplete",
"serialNumber": "1234",
"requiresSerialNumber": true,
"steps": [
{
"lastVisitTime": "2024-01-12T03:35:19.463Z",
"status": "omitted",
"description": "****",
"number": 1,
"title": "****",
"ackType": "Confirmation"
},
{
"lastVisitTime": "2024-01-12T03:35:25.739Z",
"status": "confirmed",
"description": "****",
"number": 2,
"title": "****",
"ackType": "Confirmation",
"endTime": "2024-01-12T03:35:27.482Z"
},
{
"lastVisitTime": "2024-01-12T03:35:42.861Z",
"status": "pass",
"description": "****",
"number": 3,
"title": "****",
"ackType": "PassFail",
"endTime": "2024-01-12T03:36:13.211Z"
}
]
},
"user": {
"id": "7d496296-6a29-4f88-b9ca-d1f07e1c7e93",
"first_name": "****",
"last_name": "****",
"email": "****",
"role": "****"
}
}
],
"granularity": "step",
"fullCount": "1"
}
* 
stepsstatus 內容會顯示前線使用者對含有必要意見反應之步驟傳回的值。可能的值包括:
omitted - 前線使用者沒有為步驟提供必要的意見反應。
confirmed - 需要確認意見反應的步驟經前線使用者確認已完成其某一步驟。
pass - 前線使用者已在需要提供通過 / 失敗意見反應的步驟上選取「通過」
fail - 前線使用者已在需要提供通過 / 失敗意見反應的步驟上選取「失敗」