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

# CURL請求

<Tip>平台的所有代理產品均需要在海外網路環境下使用，海外網路環境需要客戶自行配置。</Tip>

本文展示如何使用 `curl` 透過Ip2up動態住宅代理IP發起請求，適用於終端或腳本中直接調用代理連接。

## V2 版本動態代理參數說明

**參數格式**

```yaml theme={null}
<帳戶名>-<代理類型>-<定位資訊>[-sid-<會話ID>]
```

**參數說明**

|      參數      |    說明    |  必填 | 備註                              |
| :----------: | :------: | :-: | :------------------------------ |
|      帳戶名     |   分配的帳號  | ✅ 是 | —                               |
|     代理類型     |   IP 類型  | ✅ 是 | 固定值：`res`                       |
|     定位資訊     |   地理位置   | ✅ 是 | 詳見下方“定位格式”                      |
| `sid-<會話ID>` | 固定 IP 會話 | ❌ 否 | 會話 ID 最多支援 9 位數字，若期間節點下線，系統自動補充 |

**定位格式**

|    級別   |             格式             |  代理類型寫法  | 範例                                        |
| :-----: | :------------------------: | :------: | :---------------------------------------- |
|   無定位   |            `any`           |   `res`  | `account-res-any`                         |
|    國家   |         `<country>`        |   `res`  | `account-res-us`                          |
|   國家+州  |     `<country>_<state>`    | `res_sc` | `account-res_sc-us_california`            |
| 國家+州+城市 | `<country>_<state>_<city>` | `res_sc` | `account-res_sc-us_california_losangeles` |

> **說明：**
>
> * 當定位資訊包含州或城市時，代理類型必須添加 `sc` 後綴（如 `res_sc`）
> * 所有地區名稱需使用小寫字母，且不含空格，例如：`us`、`california`、`losangeles`、`newsouthwales`

**案例示範**

```shell theme={null}
# 隨機，不固定節點
curl -x http://account-res-any:password@[ip]:[port] http://httpbin.org/ip

# 隨機，固定節點
curl -x http://account-res-any-sid-295592634:password@[ip]:[port] http://httpbin.org/ip

# 指定國家，不固定節點
curl -x http://account-res-us:password@[ip]:[port] http://httpbin.org/ip

# 指定國家，固定節點
curl -x http://account-res-us-sid-295592634:password@[ip]:[port] http://httpbin.org/ip

# 指定國家-地區，不固定節點
curl -x socks5://account-res_sc-us_california:password@[ip]:[port] http://httpbin.org/ip

# 指定國家-地區，固定節點
curl -x socks5://account-res_sc-us_california-sid-295592634:password@[ip]:[port] http://httpbin.org/ip

# 指定國家-地區-城市，不固定節點
curl -x http://account-res_sc-us_california_losangeles:password@[ip]:[port] http://httpbin.org/ip

# 指定國家-地區-城市，固定節點
curl -x http://account-res_sc-us_california_losangeles-sid-295592634:password@[ip]:[port] http://httpbin.org/ip

```

## V1 版本動態代理參數說明

**參數解釋**

|      名稱     |   類型   |  必填 | 備註                                      |
| :---------: | :----: | :-: | :-------------------------------------- |
|   account   | string |  是  | 帳號：**後台的認證帳號**                          |
|   country   |   int  |  是  | 國家Id：0代表混播 **\[當前混播僅對全球生效 非全球請指定國家Id]** |
|   province  |   int  |  是  | 地區 / 州 Id：0代表混播                         |
|     city    |   int  |  是  | 城市Id：0代表混播                              |
|   session   | string |  是  | 會話標識：後台生成                               |
| sessionTime |   int  |  是  | 會話時長 （分鐘） **0代表不固定會話**                  |
|     flag    |   Int  |  是  | 會話期間自動補充節點（1-是 0-否）\| **會話時間不為0才生效**    |

**案例示範**

```shell theme={null}

# 協議示範
規則：curl -x [protocol]://[ip]:[port] -U "[userName]:[password]" ipinfo.io
示例：curl -x http://192.168.46.222:12347 -U "op1233_0_0_0_rr123_1_1:hello123" ipinfo.io

# 案例示範

# 全球混播&不指定時長&不補充
curl -x [protocol]://[ip]:[port] -U "[account]_0_0_0_[session]_0_0:[password]" ipinfo.io

# 全球混播&指定時長&自動補充
curl -x [protocol]://[ip]:[port] -U "[account]_0_0_0_[session]_[sessionTime]_1:[password]" ipinfo.io

# 全球混播&指定時長&不自動補充
curl -x [protocol]://[ip]:[port] -U "[account]_0_0_0_[session]_[sessionTime]_0:[password]" ipinfo.io

# 指定國家&不指定時長&不補充
curl -x [protocol]://[ip]:[port] -U "[account]_[country]_0_0_[session]_0_0:[password]" ipinfo.io

# 指定國家和州&不指定時長&不補充
curl -x [protocol]://[ip]:[port] -U "[account]_[country]_[province]_0_[session]_0_0:[password]" ipinfo.io

# 指定國家和州和城市&不指定時長&不補充
curl -x [protocol]://[ip]:[port] -U "[account]_[country]_[province]_[city]_[session]_0_0:[password]" ipinfo.io
```