Referencia de la API
URL base, autenticación, formato de respuesta y todos los endpoints de la API de Proxynet.
La API de Proxynet te permite leer los servicios de proxy de tu organización desde tu propio sistema, abrir pedidos nuevos y gestionar los servicios existentes. Todas las solicitudes y respuestas son JSON; la autenticación se hace con un token Bearer.
URL base
https://api.proxynet.io/api/v1Usa esta dirección en todas las llamadas de servidor a servidor. La dirección del panel (app.proxynet.io) está protegida por Cloudflare y puede aplicar una verificación de navegador a las solicitudes que llegan desde algunas IP de servidor; api.proxynet.io solo sirve la API y no hace esa verificación. El token y las rutas son los mismos en ambas.
Autenticación
Añade el encabezado Authorization a cada solicitud. No se aceptan cookies, y el token no se puede enviar en la URL.
curl -H "Authorization: Bearer pxn_live_…" \
https://api.proxynet.io/api/v1/mePara crear tokens y conocer los permisos, consulta las páginas Autenticación y Tokens y permisos.
Formato de respuesta
Las respuestas correctas devuelven los datos en data; las listas llevan la información de paginación en meta.
{
"data": [ … ],
"meta": { "total": 6, "limit": 25, "offset": 0, "has_more": false }
}Los errores se devuelven con la misma estructura en todos los endpoints; ramifica tu código según el campo code, no según el texto del mensaje. La lista completa de códigos está en la página Errores.
Endpoints
Los endpoints siguen el ciclo de vida de un pedido: primero consulta en el catálogo qué puedes comprar, luego abre un pedido y sigue el servicio creado desde las páginas de su producto.
Organización
Catálogo y precios
- GET/catalogCatálogo · Devuelve en una sola respuesta todo lo que se puede comprar, con los precios de tu plan.
- GET/locationsUbicaciones · Devuelve las ubicaciones que se pueden elegir y el stock en tiempo real.
- GET/target-urlsDominios de destino · Devuelve los dominios que se pueden elegir en el modo por destinos.
- GET/stockComprobación de stock · Ejecuta la misma comprobación de stock que se hace al crear un pedido.
- GET/pricingCotización · Calcula el cargo para un tipo, una cantidad y unas opciones adicionales.
Pedidos
- GET/ordersLista de pedidos · Lista los servicios de proxy de la organización; los cinco tipos llegan juntos.
- POST/ordersCrear pedido · Abre el mismo pedido que se hace desde el panel y cobra de tu saldo.
- GET/orders/{id}Detalles del pedido · Devuelve el estado, los días restantes y los contadores de uso de un servicio.
Endpoints por producto
Las rutas son las mismas en todos los productos (/orders/…); las páginas de producto limitan el cuerpo y los ejemplos a los campos de ese producto. Para pasar a la misma operación de otro producto, usa el menú lateral.
| Operación | ISPPor IP | DatacenterPor IP | GamingPor IP | ResidentialPor GB | MobilPor GB |
|---|---|---|---|---|---|
| Crear gate | POST | POST | POST | POST | POST |
| Detalles del gate | GET | GET | GET | GET | GET |
| Actualizar gate | PATCH | PATCH | PATCH | PATCH | PATCH |
| Listas de acceso | GET | GET | GET | GET | GET |
| Generador de endpoints | — | — | — | GET | GET |
| Lista de proxies | GET | GET | GET | — | — |
| Renovación | POST | POST | POST | — | — |
| Renovación automática | PUT | PUT | PUT | — | — |
| Historial de uso | GET | GET | GET | GET | GET |
| Logs | GET | GET | GET | GET | GET |
En los productos por IP se eligen la ubicación y la cantidad, y el servicio se renueva por periodos de 30 días; en los productos por GB hay una única dirección de gateway, la segmentación por país o ciudad se hace con el Generador de endpoints y el uso se descuenta del saldo por GB.