> ## 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` | 請求業務失敗時為`空字串` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.