기술 자료

지원

Vivox Safe Text

Vivox Safe Text

증거 신고 API

Use the Evidence report API to retrieve select messages from a channel or direct message conversation.
읽는 시간 1분최근 업데이트: 21일 전
증거 신고 API를 사용하여 서버에서 선택한 메시지를 가져올 수 있습니다. 다음은 텍스트 증거 관리 요청의 포맷 방식을 보여 주는 예제입니다. 
curl "https://services.api.unity.com/vivox/text-evidence-management/v1/organizations/:yourOrgID/projects/:yourProjectID/text-evidence-report?target_uri=add-your-vivox-channel-uri" -u service-acct-username:service-account-password
target_uri
파라미터는 필수입니다. 이는 Vivox 채널 ID 또는 다이렉트 메시지 요청의 사용자 ID에 매핑됩니다. 다이렉트 메시지 요청에는 
target_uri
와 
sender_uri
가 포함되어야 하며, 두 값은 모두 사용자 URI입니다. 
target_uri
와 
sender_uri
의 순서는 중요하지 않습니다. 다이렉트 메시지 요청은 두 사용자 간의 전체 대화를 반환하기 때문입니다. 요청은 다음 선택적 쿼리 파라미터를 허용합니다.

파라미터

설명

sender_uri
Vivox 사용자 URI는 메시지 발송자별로 응답을 필터링하는 데 사용됩니다. 이 값은 다이렉트 메시지 요청에 필요합니다.
target_uri
메시지를 받는 엔티티(채널 또는 사용자)의 URI
start_ts
이 타임스탬프와 그 이후에 보고되는 모든 메시지는 UNIX 타임스탬프 포맷입니다.
end_ts
이 타임스탬프와 그 이전에 보고되는 모든 메시지는 UNIX 타임스탬프 포맷입니다.
as_file
응답을 파일로 반환할 true 또는 false 값입니다.
file_type
as_file이 true인 경우 파일 형식을 지정합니다. 기본값은 CSV입니다.
num_messages
반환할 메시지의 수입니다. 이 숫자를 입력하지 않으면 요청 쿼리마다 최대 500개의 메시지가 반환됩니다.
존재하는 메시지 수와 상관없이 쿼리마다 최대 500개의 메시지(message_ids)가 반환됩니다. 500개가 넘는 메시지를 가져오고 싶다면 더 이상 결과가 없을 때까지 후속 메시지 결과에 대한 새 쿼리를 전송하면 됩니다. 다음 메시지 결과 페이지를 가져오려면 결과에서 제공된 
next
값을 다음 쿼리에서 
start_ts
파라미터로 사용합니다. 
next
값이 null이면 더 이상 반환할 메시지가 없다는 의미입니다.