> For the complete documentation index, see [llms.txt](https://help.cliproxy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cliproxy.com/faq/traffic-api.md).

# How to quickly integrate and use Cliproxy traffic packages

#### Host and Port

**Host：** The IP or domain name of the connected Socks5 intermediate server.

**Port：** The Socks5 port that the intermediate server listens on.

**Function：**

* All clients connect to the same intermediate server.
* This server acts as a forwarding center for proxy requests.

**Special note**：Currently only us.cliproxy.io (United States) and sg.cliproxy.io (Singapore) are provided as intermediate servers. Please select an intermediate server that is closer to the region where the exit IP is located.

#### Account

**Format 1 (Sticky IP):**`username-region-region abbreviation-st-state name-sid-current session unique identifier-t-IP duration (`For example: test123456-region-US-st-Louisiana-sid-e6CXdJDm-t-15)

**Format 2 (Rotating IP)**:`username-region-region abbreviation-st-state name (`For example: test123456-region-US-st-Louisiana)

**Function:**

* The account part (`username`) is used to identify the user.
* The server parses the parameters of `username`, `region` and `st`, and selects the appropriate export according to the configuration.

**Special Note**:

* All parameters are separated by "-", of which **username** and **region** are **required** items, and other parameters can be empty. For example, format 1 can be **test123456-region-US-t-15** and format 2 can be **test123456-region-US**
* If the **current session identifier (sid)** changes, it will be considered a new request, and the intermediate server will automatically assign a **new IP**

#### Password

**Function:**Used for user authentication. Does not affect the selection of the egress IP, only for security verification.

#### Logical process

**Client connects to the Socks5 server**

* Use the specified host:port to connect.

**Server parses account information**

* Extracts `username` `region parameter` `session type` information
* Verifies whether `username` is valid.
* Finds whether the `egress IP` is available according to the `region parameter` (if not specified, the default policy is used for allocation).

**Password authentication**

* The server verifies whether `password` is correct.
* If the authentication fails, the connection is rejected.

**Egress IP selection**

* If the `egress IP geographic location` is explicitly specified in the account, the geographic location IP is used as the egress.
* If the `geolocation` is not specified, the egress IP is allocated according to the predefined policy (such as polling, load balancing, etc.).

**Connect to target server**

* The server initiates a connection to the target address based on the resolved exit IP and forwards traffic.

#### Typical Examples

| Cliproxy Account                                    | Connection exit IP location | 备注                                                                                                                                          |
| --------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| test123456-region-US-st-Louisiana-sid-e6CXdJDm-t-15 | Louisiana, USA              | When the sid changes, the egress IP will also change. If the sid does not change, the egress IP will automatically switch after 15 minutes. |
| test123456-region-SG-t-15                           | Singapore                   | null                                                                                                                                        |
| test123456-region-HK                                | Hongkong                    | Each request will connect to the target website with a new exit IP                                                                          |