住宅代理 API
我们提供按流量计费的住宅代理。要使 API 正常运行，需要 购买住宅代理流量。如果流量已用完，部分请求将无法使用。
API 请求
使用 API 需要密钥。您可在以下页面查看 个人资料.
请求的一般格式：
https://thesafety.us/getapi?key=[API ключ]&act=[имя запроса]
剩余流量
使用 act=traffic 检查剩余流量
https://thesafety.us/getapi?key=[API ключ]&act=traffic
响应格式为 XML。
如果 API 密钥正确，auth 字段为 true。
resident-traffic-in-mb 字段显示剩余流量，单位为兆字节。
国家、城市和州列表
使用 act=countries 可获取最新列表
https://thesafety.us/getapi?key=[API ключ]&act=countries
响应格式为 XML。
如果 API 密钥正确，auth 字段为 true。
resident 字段包含 country（国家全名）和 code（国家代码）标签。使用 API 时需指定 code（国家代码）。
某些国家/地区的城市列于 city 标签中，州列于 state 标签中。城市和州均以逗号分隔。
生成代理列表
可通过 act=getresproxy 获取代理列表
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy
响应格式为 text/plain。此请求会返回任意国家/地区的动态 IP 代理。每次请求都会随机选择国家/地区和 IP 地址。
附加参数：
| 参数 | 备注 |
|---|---|
| &base= | 代理池：
可通过 act=countries 请求获取此参数 如果只有一个代理池，可能不包含该参数。 |
| &type= | 代理类型：
http = HTTP/HTTPS 代理 socks5 = Socks5 代理 如果未指定 type，则默认使用 http。 |
| $list= | 代理列表格式：
hpup = hostname:port:username:password hp@up = hostname:port@username:password uphp = username:password:hostname:port up@hp = username:password@hostname:port 如果未指定 list，则默认使用 hpup。 |
| 选择国家、城市、州 | |
| &country= | 2 字母国家/地区代码 [act=countries 请求中的 code 参数] |
| &city= | 城市名称 [act=countries 请求中的 city 参数]
系统会尽量分配指定位置的 IP 地址，但无法保证。 请勿与以下参数同时使用 &state= 仅在指定国家/地区时有效 &country= |
| &state= | 州名称 [act=countries 请求中的 state 参数]
系统会尽量分配指定位置的 IP 地址，但无法保证。 请勿与以下参数同时使用 &city= 仅在指定国家/地区时有效 &country= |
| 获取静态 IP 地址 | |
| &session=1 | 指定使用静态 IP 地址，该地址通过代理密码中的 session 参数生成。
如果未指定 session，则始终返回 1 个动态 IP 代理，其 IP 地址会随每次请求更改。IP 地址更改由代理服务器实现，无需用户进行额外设置。 |
| &amount= | 指定要生成的代理数量。
可用值范围为 1 至 1000. 仅与以下参数一起使用时有效 &session=1 |
| &lifetime= | 静态 IP 地址更换为新地址之前的有效时间。
可使用以秒、分钟和小时为单位的参数： 5-59s, 1-59m, 1-24h 示例： 30s - 每 30 秒更改一次 IP 地址 10m - 每 10 分钟更改一次 IP 地址 6h - 每 6 小时更改一次 IP 地址 系统会尽量按照指定参数运行，但无法保证。
仅与以下参数一起使用时有效 &session=1 |
请求示例：
位于德国的 10 个静态 IP HTTP/HTTPS 代理列表，格式为 up@hp
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=de&type=http&list=up@hp&session=1&amount=10
位于美国的动态 IP Socks5 代理，格式为 hpup
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&type=socks5&list=hpup
位于美国犹他州的动态 IP HTTP/HTTPS 代理
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&state=utah
位于加拿大 Montreal 市的动态 IP HTTP/HTTPS 代理
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=ca&city=montreal
有改进 API 的建议？请联系我们。