> For the complete documentation index, see [llms.txt](https://doc.thordata.com/interface-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/interface-documentation/zh-hk/gong-gong-api/dai-li-yong-hu/huo-qu-dai-li-yong-hu-lie-biao.md).

# 獲取代理用戶列表

### 基礎信息

**接口說明：**通過接口獲取Thordata住宅代理、無限代理伺服器、移動代理的代理用戶列表

**請求地址：**<https://openapi.thordata.com/api/proxy-users/user-list>

**請求方式：**<mark style="color:green;">GET</mark>

### 請求參數

**Params：**

| 參數名稱         | 參數类型   | 是否必須 | 描述                                                                                      |
| ------------ | ------ | ---- | --------------------------------------------------------------------------------------- |
| `token`      | string | 必須   | 請登入[**儀表板 >> 菜單 >> 我的賬戶**](https://dashboard.thordata.com/account-settings)查看您的token參數值 |
| `proxy_type` | number | 必須   | 選擇代理類型：1是住宅代理，2是無限代理伺服器，3移動代理（默認為1）                                                     |

### 響應示例

```json
{
    "code": 200,
    "data": {
        "limit": 100,
        "remaining_limit": 99,
        "user_count": 1,
        "list": [
            {
                "created_time": "2025-01-01",
                "username": "user123"
                "password": "password123",
                "status": true,
                "traffic_limit": 0,
                "usage_traffic": 0,
            }
        ]
    },
    "msg": "ok"
}
```

{% hint style="info" %}
若返回的code值非200，請查閱[**錯誤碼說明**](/interface-documentation/zh-hk/cuo-wu-ma/cuo-wu-ma-shuo-ming.md)列表並進行修改
{% endhint %}

<table><thead><tr><th width="206">参数名称</th><th>参数类型</th><th>是否必須</th><th>描述</th></tr></thead><tbody><tr><td><code>code</code></td><td>number</td><td>非必須</td><td>-</td></tr><tr><td><code>data</code></td><td>object</td><td>非必須</td><td>-</td></tr><tr><td><code>limit</code></td><td>number</td><td>必須</td><td>代理用戶可創建上限數量</td></tr><tr><td><code>remaining_limit</code></td><td>number</td><td>必須</td><td>代理用戶剩餘可創建數量</td></tr><tr><td><code>user_count</code></td><td>number</td><td>必須</td><td>代理用戶已創建數量</td></tr><tr><td><code>created_time</code></td><td>string</td><td>必須</td><td>代理用戶創建時間</td></tr><tr><td><code>username</code></td><td>string</td><td>必須</td><td>代理用戶名</td></tr><tr><td><code>password</code></td><td>string</td><td>必須</td><td>代理用戶密碼</td></tr><tr><td><code>status</code></td><td>string</td><td>必須</td><td>代理用戶狀態，true為啟用，false為禁用</td></tr><tr><td><code>traffic_limit</code></td><td>number</td><td>必須</td><td>代理用戶流量限制（MB），0為不限制</td></tr><tr><td><code>usage_traffic</code></td><td>number</td><td>必須</td><td>代理用戶總使用流量（MB）</td></tr><tr><td><code>msg</code></td><td>string</td><td>非必須</td><td>-</td></tr></tbody></table>