進行 API 呼叫
API 呼叫中的 PII 與專利資料
您可以使用以下 Vuforia 設定，控制所有 PII 與專利資料的可見度：
|
設定
|
「資訊」(Information)
|
||
|---|---|---|---|
|
停用此設定後，將適用下列情況：
• 會修改程序資訊 (程序標題、使用者註解)
• 會修改步驟資訊 (步驟描述、步驟標題、使用者註解和媒體意見反應)
• 會修改使用者資訊 (名字、姓氏、電子郵件和角色)
此設定的預設狀態為停用。
啟用此設定後，不會修改上述資料。
|
|||
|
啟用此設定後，傳回的資料會受到影響。
此設定的預設狀態為停用。
|
 |
如果兩種設定相互衝突，會以編輯或縮短的資訊為準。
|
API 呼叫
您可對 /customer-events/<orgid>/report API 進行 API 呼叫，此 API ㄏ為傳回指定組織的工作階段資料。接下來，即可使用查詢參數篩選結果。以下提供一些實用查詢參數供您參考：
• feedback
• serialNumber
• failures
• progress
如需上述參數相關的詳細資訊，請參閱〈可用參數〉。
 |
部分字元如未經編碼就無法運作，為取得最佳結果，建議對 URL 參數進行編碼。例如，如果序號為 'serial$number#with|special&chars'，則 URL 參數建議使用的安全編碼版本為 'serial%24number%23with%7Cspecial%26chars'。
|
請參考以下範例：
• 傳回所有程序資料
分頁顯示結果
API 回應會分頁顯示。儘管頁面大小可能不一且無法保證尺寸，但往往會包含約 100 個元素。
如有額外頁面可供使用，回應會包含一個 nextPagePostBody 元素。此元素會複製初始請求的參數以便使用，並在下一頁新增指標。
如要擷取下一頁，請使用 nextPagePostBody 作為請求主體，向相同的終點提交另一個 POST 請求。請繼續執行此流程，直到回應不再包含 nextPagePostBody 元素為止。
以下範例為包含了 nextPagePostBody 的範例輸出：
{
"items": [ ... ]
...
"nextPagePostBody": {
"granularity": "step",
"progress": [
"completed",
"abandoned",
"ongoing"
],
"startTime": "2025-04-21T22:00:00.000Z",
"endTime": "2025-10-22T21:59:59.999Z",
"latestStepState": true,
"page": 2
}
}
下一次要執行的 POST 呼叫如下：
POST https://vuforia.portal.ptc.com/customer-events/<orgId>/report
{
"granularity": "step",
"progress": [
"completed",
"abandoned",
"ongoing"
],
"startTime": "2025-04-21T22:00:00.000Z",
"endTime": "2025-10-22T21:59:59.999Z",
"latestStepState": true,
"page": 2
}