Crear gate
Abre un pedido nuevo de Residential Proxy; el uso se cobra de tu saldo por GB.
https://api.proxynet.io/api/v1/orders
Se aplican el mismo cálculo de precios, el mismo descuento del plan y la misma comprobación de stock y de saldo. Se admiten el protocolo, la ubicación, los dominios de destino o el modo de todos los sitios, y todas las opciones adicionales.
Si no se envían el nombre de usuario y la contraseña, se generan automáticamente y se devuelven en la respuesta (si el token también tiene proxies:read). Si no se envía el nombre del servicio, se genera con el formato del panel. Qué campos son válidos para cada tipo se indica en la tabla de la página Operaciones con cargo; los campos desconocidos se rechazan.
El pedido puede no activarse de inmediato (preparación, pedido anticipado o retraso del proveedor). Si meta.ready es false, meta.warning llega con contenido; antes de poner el servicio en uso, consulta periódicamente el endpoint Detalles del servicio hasta que state sea active.
Autorización
Se envía como Bearer <token>. Este endpoint requiere el permiso orders:write (Creación de pedidos); un token sin él recibe 403.
Encabezados
Un valor único para cada intento de pedido (p. ej., un UUID). Ante un tiempo de espera agotado, reintenta con el MISMO valor; no se cobra dos veces. Guarda el valor en una variable y no generes uno nuevo para el reintento.
Cuerpo
Tipo de servicio; en esta página, residential.
Conexiones ampliadas. En la familia ISP es un extra de pago: 100 conexiones simultáneas por IP en lugar de 50. En Residential/Mobile es gratuito: el límite de conexiones del gateway pasa de 500 a 1000; se ve en la respuesta como options.high_connection.
Residential/Mobile: país predeterminado a nivel de pedido, código ISO (TR, DE, US, GB, FR, IT, ES, NL, PL, RU). En la familia ISP, el país sale de locationId; si se envía allí, se rechaza.
Residential/Mobile, opcional: límite de tráfico (GB), mínimo 0,001. 0 significa sin límite fijo. Si no se envía, el uso queda limitado por tu saldo.
Opcional; si no se envía, se genera automáticamente y se devuelve en la respuesta. 3-40 caracteres: letras, números, _ o -. Para elegirlo tú mismo, tu plan debe permitirlo; si no lo permite, devuelve tier_required.
Opcional; si no se envía, se genera automáticamente. 6-40 caracteres; no se pueden usar @ . : ! ni espacios. No puede ser igual al nombre de usuario. Si usas dentro de una URL (p. ej., socks5://user:pass@host) una contraseña que contiene # / ? %, aplícale percent-encoding; las contraseñas que genera el sistema no contienen #.
Opcional. El nombre del servicio que se ve en el panel, como máximo 80 caracteres. Si no se envía, se genera con el formato del panel (p. ej., ISP Proxy #a1b2c3d4).