Crear pedido
Abre el mismo pedido que se hace desde el panel y cobra de tu saldo.
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.
Obligatorio para ISP, Datacenter y Gaming. Obtenlo del endpoint GET /locations. El país se determina automáticamente a partir de la ubicación.
Obligatorio para ISP, Datacenter y Gaming, 1-1000. Si no hay stock, pasa a ser un pedido anticipado y requiere al menos 250.
ISP y Datacenter: el modo de acceso es obligatorio. true = todos los sitios (extra de pago); con false se necesita una lista targetUrls no vacía (por destinos). Si no se envía ninguno de los dos, la solicitud se rechaza; así no se cobra un modo que no elegiste. No se usa en Gaming.
ISP y Datacenter, modo por destinos: dominios de la lista GET /target-urls. No se envía si unlimitedAccess es true.
ISP, Datacenter y Gaming. auto: HTTP y SOCKS5 en el mismo puerto, además de UDP ASSOCIATE; http: solo HTTP/HTTPS; socks5: solo SOCKS5. Si no se envía, se usa auto en ISP y Datacenter, y socks5 en Gaming (default_protocol en la respuesta de GET /catalog). También se acepta el alias parentUpstreamProtocol (AUTO, HTTP o SOCKS; sin distinguir mayúsculas y minúsculas); envía solo uno de los dos. No se envía en Residential/Mobile; allí HTTP y SOCKS5 funcionan a la vez, en puertos distintos.
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.
Solo familia ISP: cupo adicional en la lista de IP autorizadas, con un cargo extra por pedido. En Residential/Mobile devuelve 400 invalid_request.
Familia ISP: IP no consecutivas (dispersas), con cargo extra.
Familia ISP: 2× de ancho de banda, con cargo extra.
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).