Proxy-seller

Proxies y pedidos

Actualizado:

Permisos: cuenta:leer, cuenta:escribir, facturación:escribir

En este grupo

Herramienta

Para qué sirve

list_proxies

🟢 read

Tus proxies activos de un tipo: IP, puertos HTTP/SOCKS, credenciales, país, fecha de caducidad, estado de renovación automática y comentario.

export_proxies

🟢 read

Exporta los proxies como una lista lista para usar, con un proxy por línea.

get_reference

🟢 read

Países disponibles, periodos de alquiler y paquetes para un tipo de producto.

calc_order_cost

🟢 read

Precio y descuento para un nuevo pedido, sin realizarlo.

make_order

💳 pays

Realiza un nuevo pedido por poder.

list_orders

🟢 read

Tus pedidos, ordenados de más reciente a más antiguo, y los destinatarios de uso que ya figuran en la cuenta.

comprobar_estado_del_pedido

🟢 read

Comprueba si se han emitido los poderes de un encargo realizado.

calc_prolong_cost

🟢 read

Precio de renovación para proxies específicos, sin renovación.

make_prolong

💳 pays

Renovar los poderes de representación por un nuevo período.

replace_proxy

🟡 write

Solicita la sustitución de los proxies que no funcionan.

set_proxy_comment

🟡 write

Establece el mismo comentario en uno o varios proxies.

list_proxies

🟢 read-only · account:read

Tus proxies activos de un tipo: IP, puertos HTTP/SOCKS, credenciales, país, fecha de caducidad, estado de renovación automática y comentario. password se devuelve enmascarado a menos que se solicite lo contrario. Los proxies con status: "Ended" son finaliza pronto, no caducado — date_end es la fecha de caducidad real.

Parámetro

Tipo

Descripción

type obligatorio

tipo de proxy

Tipo de producto. mix es únicamente el paquete MIX de IPv4 y mix_isp El paquete ISP MIX: dos listados separados, por lo que «todos mis proxies MIX» se refiere a ambos. subresident aquí no se admite: utiliza list_resident_subuser_lists

orderId

cadena | entero

Solo un pedido

country

cadena

Código Alpha-3, p. ej.: USA

latest

booleano

Solo los proxies emitidos más recientemente

ends

booleano

Solo proxies que caducan próximamente

page, per_page

entero

Página a la que volver (por defecto 1) y el tamaño de la página (por defecto 50)

reveal

booleano

Volver password de forma clara en lugar de ••••. El asistente te lo confirmará primero; consulta Contraseñas de proxy y el proveedor de IA

Resultados: {items: [...]} — un objeto por proxy con id, ip, protocol, port_http, port_socks, login, password, country, country_alpha3, date_start, date_end, status, status_type, can_prolong, auto_renew, comment, order_id, order_number, base_order_number. La respuesta se muestra por páginas (50 por página de forma predeterminada) y contiene page, per_page, total, total_pages, además de un _note cuando haya más páginas. Para resident Los elementos son las listas de direcciones residenciales, no las direcciones IP. Para mix / mix_isp Se emite un único paquete para varios países: order_number y base_order_number incluir un sufijo específico para cada país (NS_…-dX_GBR, NS_…-dX_DEU) mientras que order_id se comparte — agrupar por order_id; a _note El resultado así lo indica. password es "••••" a menos que reveal: true. ⚠️ Datos confidenciales — El resultado incluye una advertencia que el asistente te repite.

export_proxies

🟢 read-only · account:read

Exporta los proxies como una lista lista para usar, un proxy por línea. Ocultados por defecto: ip:port. Con reveal: true las líneas se pueden conectar login:password@host:port.

Parámetro

Tipo

Descripción

type obligatorio

tipo de proxy, incl. subresident

Tipo de producto

ext

cadena

txt (por defecto), csv, o una plantilla como %login%:%password%@%ip%:%port%. Sin reveal, txt se convierte en %ip%:%port%; csv (cuyo formato fijo ip;port;login;password (siempre contiene la contraseña) y una plantilla de nomenclatura %password% Se rechazarán hasta que confirmes la revelación

proto

https | socks5

Solo un tipo de puerto (no apto para uso residencial)

protocol

http | socks5

Solo para uso residencial (resident, subresident): la estructura de cada línea. Con txt una línea queda así socks5://login:password@host:port; csv mantiene sus columnas; una plantilla obtiene el valor en %protocol% (una plantilla no puede contener /, así que utiliza txt para scheme:// líneas). Sin ella, las líneas carecen de estructura. No es lo mismo que proto; no hay https. socks5 también admite UDP y HTTP/3 (QUIC)

host

res.proxy-seller.com | us.res.proxy-seller.com | asia.res.proxy-seller.com

Solo para uso residencial: la puerta de enlace en cada línea — Europa (por defecto), EE. UU. o Asia. Solo el punto de entrada; la ubicación de la IP de salida proviene de la configuración de la lista.

country

cadena

Código Alpha-3 (no apto para uso residencial)

ends

booleano

Solo proxies que caducan pronto (no para uso residencial)

listId

cadena | entero

ID de la lista residencial (resident y subresident); omitir la exportación de todas las listas

package_key

cadena

Clave del subpaquete, con type: "subresident"

maxLine

entero

Número máximo de líneas, solo para uso residencial

reveal

booleano

Volver a «conectable» login:password@host:port líneas en lugar de ip:port. El asistente te lo confirmará primero; consulta Contraseñas de proxy y el proveedor de IA

Resultados: Con una residencia protocol Las líneas reflejan el esquema: socks5://host:port Por defecto, socks5://login:password@host:port con reveal: true. Sin reveal Las líneas van seguidas de una nota que indica que se han omitido las contraseñas; el asistente se encarga de transmitir esta información, por lo que nunca se presenta una lista sin contraseñas como las credenciales que has solicitado. Solicitar csv te está pidiendo las contraseñas: el asistente te advierte de que el archivo incluirá tus credenciales de proxy en la conversación y te pide que lo confirmes antes de exportarlo.

get_reference

🟢 read-only · account:read

Países disponibles, plazos de alquiler y paquetes para un tipo de producto. Información necesaria antes de fijar el precio o realizar el pedido. Los países se indican con códigos alfa-3 (USA), los puntos son códigos cortos (1m). En el caso de los dispositivos móviles, también muestra los operadores y las opciones de rotación; en el caso de los particulares, las tarifas de tráfico.

Parámetro

Tipo

Descripción

type obligatorio

tipo de proxy

Tipo de producto

calc_order_cost

🟢 read-only · account:read

Precio y descuento para un nuevo pedido, sin realizarlo. Adopta los mismos parámetros que make_order.

make_order

💳 spends money · billing:write

Realiza un nuevo pedido por poder. Se cargará en el saldo. Si lo realizas dos veces, se crearán dos pedidos.

Parámetro

Tipo

Descripción

type obligatorio

tipo de proxy

Tipo de producto (utiliza make_resident_order (para tráfico residencial)

countryId obligatorio

cadena

De get_reference, p. ej. USA

periodId obligatorio

cadena

De get_reference, p. ej. 1m

quantity obligatorio

entero

Número de proxies (ipv6 (mínimo: 10)

paymentId obligatorio

cadena

balance o paddle_subscription

customTargetName

cadena

Para qué sirven los proxies, como nombre abreviado de un sitio web o servicio (Google, Instagram). Requerido para ipv4, ipv6, isp. Un destino que la cuenta nunca haya utilizado se considera un destino nuevo: un gestor lo aprueba manualmente y el pedido permanece pendiente hasta entonces, por lo que el asistente prefiere uno de los destinos ya existentes de la cuenta (list_orders → targets)

coupon

cadena

Código promocional

generateAuth

booleano

Genera un nombre de usuario y una contraseña para los nuevos proxies

protocol

HTTPS | SOCKS5

Anulación de protocolo

mobileServiceType

shared | dedicated

Solo para móviles, obligatorio

operatorId

cadena

Solo para móviles, obligatorio — operador de get_reference

rotationId

cadena

Solo para móviles, obligatorio — rotación en minutos desde get_reference

mixId

cadena

Solo MIX: código del paquete de get_reference

uptime

booleano

Solo IPv4/ISP — Modo de alta disponibilidad cuando esté disponible

Errores habituales: El pedido se ha pagado, pero permanece pendiente durante más de un minuto. Cuando su customTargetName es nuevo en la cuenta, provisioning.targetNote Así lo indica: el CRM ha creado un nuevo objetivo de uso que un responsable aprueba manualmente, y los poderes se emiten a continuación; no hay ningún problema con el pago ni con las acciones. Vuelve a comprobarlo más tarde con comprobar_estado_del_pedido, o reutiliza un destino ya existente la próxima vez.

list_orders

🟢 read-only · cuenta:leer

Tus pedidos, ordenados de más reciente a más antiguo —compras y renovaciones—, con sus ID, estado, importe, fechas, tipo de proxy y destino de uso, además de los distintos destinos de uso de la cuenta. Úsalo para elegir un customTargetName que la cuenta ya tiene antes de realizar el pedido, para encontrar el order_id valores a ipv6 / mix / mix_isp La renovación se realiza como orderIds, y para el historial de pedidos.

Parámetro

Tipo

Descripción

order_id

cadena | entero

Un encargo (order_id lo devuelve con sus prolongaciones; el valor numérico de una fila id devuelve esa fila)

start_date / end_date

cadena

Límites de la fecha de creación, yyyy-MM-dd o dd.MM.yyyy

status

PAYED | NOT_PAYED | RETURN

Filtro de estado de la máquina

is_extend

booleano

true solo prolongaciones, false solo compras

auto_order

booleano

true colocados a través de la API o renovados automáticamente, false introducido manualmente

page / limit

entero

Paginación: 50 filas por página de forma predeterminada; a _note indica cuándo hay más páginas. targets siempre cubre todos los pedidos coincidentes

Resultados: {metadata: {total_orders, total_pages, current_page, current_limit}, items: [{id, order_id, order_number, base_order_number, status, status_type, summ, date_insert, date_payed, payment_name, is_extend, auto_order, auth_way, auth_ip, protocol, items: [{order_part_id, type, quantity, target, target_section, time, price, name, ...}], ...}], targets: string[], _note?}. summ es una cadena de moneda ($12.50), las fechas se expresan según la norma ISO 8601; el destinatario del uso figura en cada parte del pedido (items[].items[].target); crear una rama en status_type, no status.

comprobar_estado_del_pedido

🟢 read-only · account:read

Comprueba si se han emitido los poderes de un encargo realizado, contando los poderes list_proxies Se aplica al pedido: para cada tipo, incluidos los paquetes MIX. Aunque un pedido MIX aún no incluye direcciones IP, los inicios de sesión por país en list_auth son las pruebas de respaldo (started). Se puede llamar repetidamente sin problema; devuelve un estado y los siguientes pasos. El armario etiqueta un paquete MIX según su order_part_id, que difiere de orderId; es decir, en el mismo orden.

Parámetro

Tipo

Descripción

type obligatorio

tipo de proxy

Tipo de producto

orderId obligatorio

cadena | entero

orderId de make_order

expectedQuantity

entero

Cantidad pedida, para detectar entregas parciales

baseOrderNumbers

string[]

Solo MIX — listBaseOrderNumbers de la make_order respuesta, utilizada como alternativa en caso de fallo en el inicio de sesión

Resultados: status es provisioned, partial, started (MIX: existen nombres de usuario, pero las direcciones IP aún no figuran en la lista) o pending. proxies[] son los registros emitidos con password enmascarado — utilizar list_proxies / export_proxies con reveal: true para las credenciales.

calc_prolong_cost

🟢 read-only · account:read

Precio de renovación para proxies específicos, sin renovación. Mismos parámetros que make_prolong.

Resultados: items son los proxies que se renovarían, password enmascarado.

make_prolong

💳 spends money · billing:write

Renovar los proxies por otro periodo. Se cargará el importe en la fuente de pago seleccionada. Si se realiza la llamada dos veces, se cobrará dos veces.

Parámetro

Tipo

Descripción

type obligatorio

ipv4 | ipv6 | mobile | isp | mix | mix_isp

Tipo de producto. Un paquete residencial no se renueva por periodos: compra tráfico con make_resident_order

periodId obligatorio

cadena

De get_reference

paymentId obligatorio

cadena

balance o un método de list_payments

ips

string[]

ipv4 / isp / mobile: direcciones proxy como list_proxies los muestra

ids

(cadena | entero)[]

ipv4 / isp / mobile: identificadores de proxy

orderIds

(cadena | entero)[]

ipv6 / mix / mix_isp: el order_id valores de list_proxies. Estos productos se venden y renuevan como pedidos completos: se renueva y se cobra cada proxy activo del pedido

coupon

cadena

Código promocional

El selector que se aplique dependerá de type: ipv4, isp y mobile tomar ids o ips; ipv6, mix y mix_isp tomar orderIds. En el caso de un tipo de pedido completo, aún puedes pasar ids o ips — la herramienta del asistente los resuelve según sus órdenes — pero la propia API solo acepta orderIds allí.

Errores habituales: Se rechaza una segunda renovación de un pedido que aún se está renovando antes del pago (código 57, «ya en curso»); no se cobra nada; espera y compruébalo. list_proxies en lugar de volver a intentarlo a ciegas. «No se ha aplicado la renovación, el pago se ha devuelto al saldo» significa que la renovación se ha anulado y el dinero ha vuelto al saldo.

replace_proxy

🟡 changes account state · account:write

Solicita la sustitución de los proxies que no funcionan. Cada proxy se puede sustituir una vez al día.

Parámetro

Tipo

Descripción

ids obligatorio

(cadena | entero)[]

ID de proxy

reason obligatorio

NOT_WORK | INCORRECT_LOCATION | CANT_CHANGE_NETWORK | LOW_SPEED | CUSTOM

Motivo

comment

cadena

Requerido cuando reason es CUSTOM

set_proxy_comment

🟡 changes account state · account:write

Establece el mismo comentario en uno o más proxies. Sustituye el comentario anterior; una cadena vacía lo borra.

Parámetro

Tipo

Descripción

ids obligatorio

(cadena | entero)[]

ID de proxy

comment obligatorio

cadena

Texto del comentario

Próximos pasos

On this page