# 玩家证据报告 API

> 使用玩家证据报告 API 获取玩家参与的对话列表。

玩家证据报告 API 返回用户参与的对话列表以及可选的时间过滤器。

以下是玩家证据请求的一个示例：

```text
curl https://services.api.unity.com/vivox/text-evidence-management/v1/organizations/<organization_id>/projects/<project_id>/player-evidence-report?user_uri=sip:your-issuer.john.@yourvivoxdomainname.vivox.com -u service-acct-username:service-account-password
```

`user_uri` 是必填字段，映射到相关用户的 sip URI。

玩家证据报告 API 接受以下可选查询参数：

| 参数                  | 描述                                                                                                                      |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `start_ts`          | 一个 Unix 时间戳，用于过滤用户上次活动发生在此时间戳及之后的对话。                                                                                    |
| `end_ts`            | 一个 Unix 时间戳，用于过滤用户上次活动发生在此时间戳及之前的对话。                                                                                    |
| `num_conversations` | 要在响应中返回的对话数。                                                                                                            |
| `request_start_ts`  | 此参数用于第一页之后的分页请求。在响应有效负载中返回其值。玩家的最近活动对响应中的对话进行排序，响应中的 next 值表示要获取的下一个对话中的玩家最近活动。用户正在聊天的情况下，`request_start_ts` 参数可保持页面准确。 |