Acciones con proxies

Gestiona las direcciones IP de tus pedidos de proxy: enuméralas, rótalas, amplíalas o añádeles notas.

Parámetro común. Cada punto final de esta página funciona siguiendo un orden específico. Pasa el parámetro «orderNumber»; obténlo de GET /proxy/list.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list

Devuelve los proxies activos agrupados por tipo.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list/{type}

Devuelve los proxies activos de un tipo. Admite los mismos parámetros de consulta que /proxy/list

Parámetros de ruta

Nombre

Valor

Requisitos

Descripción

Tipo

ipv4, ipv6, mobile, isp, mix, mix_isp, o resident

Sí

Especifica el tipo de proxies que se deben incluir en la lista descargada.

Autorización

<Your_API_Key>

Sí

Tu clave API personal (Cómo conseguir)

Parámetros de consulta

Nombre	Tipo	Requisitos	Descripción
últimas novedades	Cadena	No	`Y`devuelve los proxies del último pedido activo cuando `orderId` No se proporciona.
orderId	Cadena	No	Devuelve un proxy a partir de un orderId o un OrderPart.number específicos
país	Cadena	No	Nombre del país en Alpha3 (FRA o DEU, por ejemplo…)
fin	Cadena	No	`Y` solo devuelve `ENDED` proxies que aún tienen `dateEnd` en el futuro. De lo contrario, se excluirán los proxies cerrados.

Ejemplo

Para recuperar proxies de todo tipo:

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list

Para recuperar proxies de un tipo específico (por ejemplo, IPv4):

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list/ipv4

Respuesta

Todo tipo de proxies

{
  "status": "success",
  "data": {
    "ipv4": [],
    "ipv6": [],
    "mobile": [],
    "isp": [],
    "mix": [],
    "mix_isp": [],
    "resident": []
  },
  "errors": []
}

Un tipo de proxy

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ]
    },
    "errors": []
}

Tipo de proxy incorrecto

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list/{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Ten en cuenta que, si no se especifica ningún tipo de proxy, se mostrarán todos los tipos disponibles para tu perfil.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/download/{type}

Exportar direcciones IP

Este punto final de la API te permite descargar la lista de tus proxies.

Parámetros de la ruta:

Nombre	Valor	Requisitos	Descripción
Tipo	`ipv4`, `ipv6`, `mobile`, `isp`, `mix`, `mix_isp`, o `resident`	Sí	Especifica el tipo de proxies que se deben incluir en la lista descargada.
Autorización	`<Your_API_Key>`	Sí	Tu clave API personal (Cómo conseguir)

Parámetros opcionales

Nombre	Valor	Descripción
ext	txt csv	Especifica el formato en el que se descargará la lista de proxies.
	%login%:%password%@%ip%:%port%	Formato personalizado
proto	https socks5	Especifica el formato de puerto de proxy que prefieres para los proxies.
listId	Número entero	ID de la lista de proxies (solo para residentes; si no se establece, se devolverá la IP de todas las hojas)
package_key	Cadena	Lista de proxies package_key (solo para subresidentes)
país	Cadena	Nombre del país en Alpha3 (FRA, USA o ...)
fin	Cadena	`Y` - Lista de sustitutos de terminación

Ejemplo

Para recuperar proxies de un tipo específico (por ejemplo, IPv4):

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/download/ipv4?ext=txt&proto=https

Respuesta

Respuesta: tipo de proxy incorrecto

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Modificar

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/replace

Sustituir direcciones IP

Rotar una IP sin perder la plaza en la lista de espera. Cuenta para la cuota mensual de sustituciones.

Parámetros de ruta

Nombre	Valor	Requisitos	Descripción
Autorización	`<Your_API_Key>`	Sí	Tu clave API personal (Cómo conseguir)

Cuerpo de la solicitud

Nombre	Tipo	Descripción
ids	Número	Un único ID o una lista de ID entre corchetes «[ ]», separados por comas
comentario	Cadena	Comentario opcional para incluir con la solicitud
tipo	Cadena	Tipo de sustitución

Ejemplo

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/replace
{
    "ids": ["10"],
    "type": "CUSTOM",
    "comment": "Test replace IP"
}

Respuesta

{
    "status": "success",
    "data": {
        "ok": {
            "ips": [
                "11.55.11.0"
            ],
            "msg": "Replacement request submitted"
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 503,
            "message": "Error api key",
            "customData": null
        },
        {
            "code": 503,
            "message": "IP not allowed",
            "customData": null
        },
        {
            "code": 503,
            "message": "Request limit reached",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set coorect type: NOT_WORK / INCORRECT_LOCATION / CANT_CHANGE_NETWORK / LOW_SPEED / CUSTOM",
            "customData": null
        }
    ]
}

Tipos de sustitución: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM

POST https://proxy-seller.com/personal/api/v2/{apiKey}/prolong/calc/{type}

Prolong IPs

Ampliar la vigencia en las direcciones IP seleccionadas. Se factura por día y por IP.

Este documento ofrece una guía detallada sobre cómo configurar la renovación automática de tus direcciones IP de diversos tipos. Ten en cuenta que las direcciones IP deben renovarse a tiempo para mantener las mismas direcciones.

Calcular la extensión

Este punto de referencia te ayuda a calcular el coste. Los descuentos por volumen y por periodos de alquiler son similares a los que ofrece nuestro servicio.

Parámetros de ruta

Nombre

Valor

Requisitos

Descripción

Autorización

<Your_API_Key>

Sí

Tu clave API personal (Cómo conseguir)

Tipo

ipv4

ipv6

mobile

isp

mix

mix_isp

Sí

El tipo de proxy que deseas ampliar

Cuerpo de la solicitud

Nombre	Tipo	Descripción
ids	Número	Un único ID o una lista de ID entre corchetes «[ ]», separados por comas (cómo obtenerlos)
cupón	Cadena	El comentario que quieres añadir
periodId	Cadena	ID del periodo que has seleccionado en la solicitud /reference/list/{type}

Ejemplo (p. ej., ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/calc/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Respuesta

{
    "status": "success",
    "data": {
        "warning": "",
        "balance": 498648.72,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login ",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/prolong/make/{type}

Prolong IPs

En esta sección aprenderás a crear un pedido de renovación.

Crear un pedido de renovación

Crea un pedido de ampliación.

Parámetros de ruta

Nombre

Valor

Requisitos

Descripción

Autorización

<Your_API_Key>

Sí

Tu clave API personal (Cómo conseguir)

Tipo

ipv4

ipv6

mobile

isp

mix

mix_isp

Sí

El tipo de proxy que deseas ampliar

Cuerpo de la solicitud

Nombre	Tipo	Descripción
ids	Número	Un único ID o una lista de ID entre corchetes «[ ]», separados por comas (cómo obtenerlo)
cupón	Cadena	Código promocional.
periodId	Cadena	ID del periodo que has seleccionado en la solicitud /reference/list/{type}
paymentId	Cadena	Identificadores del sistema de pagos «69e799e7497b2c153b33faca» - equilibrio, «69e799e8497b2c153b33faed» - tarjeta que has añadido a tu vitrina

Ejemplo (p. ej., ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/make/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Respuesta

{
    "status": "success",
    "data": {
        "orderId": "69fa4b795a1f522c7a53d589",
        "total": 3.49,
        "listBaseOrderNumbers": [
            "TEST_1778011001948-uc_e_UUf2Z3RtGH"
        ],
        "balance": 1.00
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "base_order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "ip": "11.55.11.0",
                "port_http": null,
                "port_socks": null,
                "login": "x2alltop0qRU6",
                "password": "gwBwtL9LMM",
                "authIp": "",
                "country": "Germany",
                "date_start": "05.05.2026 19:56:42",
                "date_end": "10.08.2026 23:59:59",
                "comment": "",
                "status": "Active",
                "rotation": null,
                "link_reboot": "#",
                "can_prolong": true
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/comment/set

Añadir comentarios

Adjunta una nota de texto libre (máximo 256 caracteres) para ayudar a identificar un IP en la interfaz de usuario o en las exportaciones.

Parámetros de ruta

Nombre	Valor	Requisitos	Descripción
Autorización	`<Your_API_Key>`	Sí	Tu clave API personal (Cómo conseguirlo)

Cuerpo de la solicitud

Nombre	Tipo	Descripción
ids	Número	Un único ID o una lista de ID entre «[ ]», separados por comas (cómo obtenerlos)
comentario	Cadena	El comentario que quieres añadir

Ejemplo

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/comment/set
{
    "ids": ["10"],
    "comment": "Мой сервер"
}

Respuesta

{
    "status": "success",
    "data": {
        "updated": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

Común a todos los puntos finales de proxy

URL base

https://proxy-seller.com/personal/api/v2/{YourApiKey}/

Autenticación
Clave API en la ruta de la URL.
Modelo de errores
Los errores de negocio devuelven un código HTTP 200 con errors[] poblado.

Una vez que hayas gestionado tus direcciones IP

Authorizationissue per-order credentialsOpen Order actionsbuy more proxies when you need additional IPsOpen Balancecheck funds before bulk prolongationOpen

Parámetros de ruta

Parámetros de consulta

Ejemplo

Respuesta

Parámetros de la ruta:

Parámetros opcionales

Ejemplo

Respuesta

Modificar

Parámetros de ruta

Cuerpo de la solicitud

Ejemplo

Respuesta

Calcular la extensión

Parámetros de ruta

Cuerpo de la solicitud

Ejemplo (p. ej., ipv4)

Respuesta

Crear un pedido de renovación

Parámetros de ruta

Cuerpo de la solicitud

Ejemplo (p. ej., ipv4)

Respuesta

Parámetros de ruta

Ejemplo

Respuesta

Común a todos los puntos finales de proxy

URL base

Autenticación

Modelo de errores

Una vez que hayas gestionado tus direcciones IP

On this page