API 호출
API 호출의 PII 및 독점 데이터
다음 Vuforia 설정에 따라 모든 PII 및 독점 데이터의 표시 유형을 제어할 수 있습니다.
|
설정
|
정보
|
||
|---|---|---|---|
|
이 설정을 비활성화하면 다음 사항이 적용됩니다.
• 절차 정보(절차 제목, 사용자 설명)가 삭제됩니다.
• 단계 정보(단계 설명, 단계 제목, 사용자 설명 및 미디어 피드백)가 삭제됩니다.
• 사용자 정보(이름, 성, 이메일 및 역할)가 삭제됩니다.
이 설정은 기본적으로 비활성화되어 있습니다.
이 설정을 활성화하면 위의 데이터가 삭제되지 않습니다.
|
|||
|
이 설정을 활성화하면 반환된 데이터가 영향을 받습니다.
이 설정은 기본적으로 비활성화되어 있습니다.
|
 |
이러한 두 설정이 서로 충돌하는 경우 정보의 삭제 또는 단축이 우선시됩니다.
|
API 호출
/customer-events/<orgid>/report 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
}