Proxies y pedidos
Actualizado:
Permisos: cuenta:leer, cuenta:escribir, facturación:escribir
En este grupo
Herramienta | Para qué sirve | |
|---|---|---|
🟢 | Tus proxies activos de un tipo: IP, puertos HTTP/SOCKS, credenciales, país, fecha de caducidad, estado de renovación automática y comentario. | |
🟢 | Exporta los proxies como una lista lista para usar, con un proxy por línea. | |
🟢 | Países disponibles, periodos de alquiler y paquetes para un tipo de producto. | |
🟢 | Precio y descuento para un nuevo pedido, sin realizarlo. | |
💳 | Realiza un nuevo pedido por poder. | |
🟢 | Tus pedidos, ordenados de más reciente a más antiguo, y los destinatarios de uso que ya figuran en la cuenta. | |
🟢 | Comprueba si se han emitido los poderes de un encargo realizado. | |
🟢 | Precio de renovación para proxies específicos, sin renovación. | |
💳 | Renovar los poderes de representación por un nuevo período. | |
🟡 | Solicita la sustitución de los proxies que no funcionan. | |
🟡 | 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 |
|---|---|---|
| tipo de proxy | Tipo de producto. |
| cadena | entero | Solo un pedido |
| cadena | Código Alpha-3, p. ej.: |
| booleano | Solo los proxies emitidos más recientemente |
| booleano | Solo proxies que caducan próximamente |
| entero | Página a la que volver (por defecto |
| booleano | Volver |
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 |
|---|---|---|
| tipo de proxy, incl. | Tipo de producto |
| cadena |
|
|
| Solo un tipo de puerto (no apto para uso residencial) |
|
| Solo para uso residencial ( |
|
| 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. |
| cadena | Código Alpha-3 (no apto para uso residencial) |
| booleano | Solo proxies que caducan pronto (no para uso residencial) |
| cadena | entero | ID de la lista residencial ( |
| cadena | Clave del subpaquete, con |
| entero | Número máximo de líneas, solo para uso residencial |
| booleano | Volver a «conectable» |
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 |
|---|---|---|
| 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 |
|---|---|---|
| tipo de proxy | Tipo de producto (utiliza make_resident_order (para tráfico residencial) |
| cadena | De get_reference, p. ej. |
| cadena | De get_reference, p. ej. |
| entero | Número de proxies ( |
| cadena |
|
| cadena | Para qué sirven los proxies, como nombre abreviado de un sitio web o servicio (Google, Instagram). Requerido para |
| cadena | Código promocional |
| booleano | Genera un nombre de usuario y una contraseña para los nuevos proxies |
|
| Anulación de protocolo |
|
| Solo para móviles, obligatorio |
| cadena | Solo para móviles, obligatorio — operador de get_reference |
| cadena | Solo para móviles, obligatorio — rotación en minutos desde get_reference |
| cadena | Solo MIX: código del paquete de get_reference |
| 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 |
|---|---|---|
| cadena | entero | Un encargo ( |
| cadena | Límites de la fecha de creación, |
|
| Filtro de estado de la máquina |
| booleano |
|
| booleano |
|
| entero | Paginación: 50 filas por página de forma predeterminada; a |
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 |
|---|---|---|
| tipo de proxy | Tipo de producto |
| cadena | entero |
|
| entero | Cantidad pedida, para detectar entregas parciales |
| string[] | Solo MIX — |
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 |
|---|---|---|
|
| Tipo de producto. Un paquete residencial no se renueva por periodos: compra tráfico con make_resident_order |
| cadena | |
| cadena |
|
| string[] |
|
| (cadena | entero)[] |
|
| (cadena | entero)[] |
|
| 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 |
|---|---|---|
| (cadena | entero)[] | ID de proxy |
|
| Motivo |
| cadena | Requerido cuando |
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 |
|---|---|---|
| (cadena | entero)[] | ID de proxy |
| cadena | Texto del comentario |