# 증거 신고 API

> 증거 신고 API를 사용하여 채널이나 다이렉트 메시지 대화에서 일부 메시지를 검색할 수 있습니다.

증거 신고 API를 사용하여 서버에서 선택한 메시지를 가져올 수 있습니다.

다음은 텍스트 증거 관리 요청의 포맷 방식을 보여 주는 예제입니다.

```text
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개의 메시지가 반환됩니다.           |

> **Note:**
>
> 지정된 수의 메시지가 있는 요청은 반환할 메시지가 더 있는 경우 결과의 다음 메시지를 가리키는 Unix 타임스탬프가 포함된 `next` 필드를 반환합니다.

존재하는 메시지 수와 상관없이 쿼리마다 최대 500개의 메시지(message\_ids)가 반환됩니다. 500개가 넘는 메시지를 가져오고 싶다면 더 이상 결과가 없을 때까지 후속 메시지 결과에 대한 새 쿼리를 전송하면 됩니다.

다음 메시지 결과 페이지를 가져오려면 결과에서 제공된 `next` 값을 다음 쿼리에서 `start_ts` 파라미터로 사용합니다. `next` 값이 null이면 더 이상 반환할 메시지가 없다는 의미입니다.