> ## Documentation Index
> Fetch the complete documentation index at: https://docs.go2proxy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 動態代理IP提取

> 動態代理IP提取API介面介紹。

<Note>透過動態代理API提取出的IP，僅能使用白名單認證。</Note>

* API介面位址：[https://api.go2proxy.com/v1/dynamic/proxies](https://api.go2proxy.com/v1/dynamic/proxies)

* 請求方式：GET

* QPS限制：單訂單1秒訪問1次

## 1.參數

| 參數名       | 必填 | 類型       | 說明                |
| :-------- | :- | :------- | :---------------- |
| app\_id   | 是  | `string` | API存取憑證：AppID     |
| signature | 是  | `string` | API存取憑證：AppSecret |
| orderid   | 是  | `string` | 訂單號               |
| num       | 是  | `int`    | 本次提取IP數量（1-1000）  |
| period    | 是  | `int`    | IP有效時間（1-30）      |
| region    | 否  | `string` | 國家編碼，不填為`全球混播`    |

## 2.回傳範例

```python 程式碼範例 theme={null}
{
    "code": 0,
    "msg": "success",
    "data": {
        "count": 2,
        "proxy_list": [
            {
                "ip": "43.130.57.106",
                "port": 10001
            },
            {
                "ip": "43.130.57.106",
                "port": 10002
            }
        ]
    }
}
```

## 3.回傳參數說明

| 參數名  | 類型          | 說明                   |
| :--- | :---------- | :------------------- |
| code | `int`       | 請求業務狀態，0為成功，非0均為業務失敗 |
| msg  | `string`    | 請求業務描述               |
| data | `"" or map` | 請求業務失敗時為`空字串`        |