API para proxies residenciales
Ofrecemos proxies residenciales con pago por tráfico. Para que la API funcione correctamente es necesario comprar tráfico de proxies residenciales. Si se agota su tráfico, algunas solicitudes no funcionarán.
Solicitudes a la API
Para utilizar la API se requiere una clave. Puede consultarla en la página Perfil.
Formato general de la solicitud:
https://thesafety.us/getapi?key=[API ключ]&act=[имя запроса]
Tráfico restante
Para consultar el tráfico restante, utilice act=traffic
https://thesafety.us/getapi?key=[API ключ]&act=traffic
La respuesta tendrá el formato XML.
El campo auth = true si la clave API es válida.
El campo resident-traffic-in-mb muestra el tráfico restante en megabytes.
Lista de países, ciudades y estados
Puede obtener la lista actualizada mediante act=countries
https://thesafety.us/getapi?key=[API ключ]&act=countries
La respuesta tendrá el formato XML.
El campo auth = true si la clave API es válida.
El campo resident contiene las etiquetas country (nombre completo del país) y code (código del país). Para la API debe indicar code (código del país).
Para algunos países se indican ciudades en la etiqueta city y estados en la etiqueta state. Las ciudades y los estados aparecen en listas separadas por comas.
Generación de una lista de proxies
Puede obtener la lista de proxies mediante act=getresproxy
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy
La respuesta tendrá el formato text/plain. Esta solicitud proporcionará un proxy de cualquier país con una dirección IP dinámica. El país y la dirección IP se seleccionarán al azar en cada solicitud.
Parámetros adicionales:
| Parámetro | Comentario |
|---|---|
| &base= | Base de proxies:
Este parámetro se puede obtener mediante la solicitud act=countries Si solo hay una base de proxies, el parámetro puede no aparecer. |
| &type= | Tipo de proxy:
http = proxy HTTP/HTTPS socks5 = proxy Socks5 Si no se especifica type, se utiliza http de forma predeterminada. |
| $list= | Formato de la lista de proxies:
hpup = hostname:port:username:password hp@up = hostname:port@username:password uphp = username:password:hostname:port up@hp = username:password@hostname:port Si no se indica list, se utiliza hpup de forma predeterminada. |
| Selección del país, la ciudad y el estado | |
| &country= | Código de país de 2 letras [parámetro code de la solicitud act=countries] |
| &city= | Nombre de la ciudad [parámetro city de la solicitud act=countries]
El sistema intentará proporcionar direcciones IP en la ubicación indicada, pero no se garantiza. No lo utilice simultáneamente con el parámetro &state= Solo funciona si también se especifica el país &country= |
| &state= | Nombre del estado [parámetro state de la solicitud act=countries]
El sistema intentará proporcionar direcciones IP en la ubicación indicada, pero no se garantiza. No lo utilice simultáneamente con el parámetro &city= Solo funciona si también se especifica el país &country= |
| Obtención de una dirección IP estática | |
| &session=1 | Indica que se debe utilizar una dirección IP estática, definida en la contraseña del proxy mediante el parámetro session.
Si no se especifica session, siempre se proporciona 1 proxy con una dirección IP dinámica que cambia en cada solicitud. La dirección IP se cambia en el servidor proxy y el usuario no necesita realizar ninguna configuración adicional. |
| &amount= | Indica la cantidad de proxies que se deben generar.
Valores posibles desde 1 hasta 1000. Solo funciona junto con el parámetro &session=1 |
| &lifetime= | Tiempo tras el cual la dirección IP estática se sustituye por una nueva.
Valores posibles en segundos, minutos y horas: 5-59s, 1-59m, 1-24h Ejemplo: 30s - cambiar la dirección IP cada 30 segundos 10m - cambiar la dirección IP cada 10 minutos 6h - cambiar la dirección IP cada 6 horas El sistema intentará funcionar según el parámetro indicado, pero no se garantiza.
Solo funciona junto con el parámetro &session=1 |
Ejemplos de solicitudes:
Lista de 10 proxies HTTP/HTTPS con dirección IP estática en Alemania en formato up@hp
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=de&type=http&list=up@hp&session=1&amount=10
Proxies Socks5 con dirección IP dinámica en EE. UU. en formato hpup
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&type=socks5&list=hpup
Proxy HTTP/HTTPS con dirección IP dinámica en EE. UU., estado de Utah
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&state=utah
Proxy HTTP/HTTPS con dirección IP dinámica en Canadá, ciudad de Montreal
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=ca&city=montreal
¿Tiene sugerencias para mejorar la API? Contacte con nosotros.