Comprar y gestionar PI

Puntos finales del ciclo de vida para trabajar con proxies en la cuenta. El mismo conjunto de operaciones funciona para los cuatro tipos de proxy (ipv4,ipv6,isp,mobile) con pequeñas peculiaridades por tipo indicadas en cada sección.

Conceptos

proxyType. Siempre uno deipv4,ipv6,isp,mobile. Obligatorio en todas las solicitudes como parámetro de consulta o campo del cuerpo.

id vsorderId. La mayoría de los tipos se dirigen a los proxies individualmente porid.IPv6 es la excepción - Los proxies IPv6 se compran, cotizan y renuevan pororderIdporque cada orden IPv6 se trata como un grupo indivisible.

mobile-sólo campos. Los proxies móviles tienen algunos conceptos adicionales: una lista de operadores, un tiempo de rotación por operador y un enlace de reinicio para rotar manualmente la IP. VéaseTarifas móviles.

Sobre de respuesta común. Cada punto final de esta página devuelve esta forma de nivel superior en caso de éxito - sólo los campos específicos de la operación difieren:

{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4"
}

Campo	Tipo	Descripción
`success`	booleano	Estado de funcionamiento.
`user`	cadena	Correo electrónico de la cuenta.
`balance`	número	Saldo de la cuenta después de la operación, en`currency`.
`currency`	cadena	Código de moneda ISO.
`proxyType`	cadena	Se hace eco del tipo solicitado.

Para todos los demás campos de nivel superior y formas de objeto proxy por tipo, véase cada operación a continuación.

Operación	Método	Ruta
Lista de proxies comprados	`GET`	`/get/proxies`
Tarifas móviles	`GET`	`/get/mobile/tariffs`
Calcular el precio de compra	`GET`	`/get/order/price`
Calcular el precio de la ampliación	`GET`	`/get/extend/price`
Hacer un pedido	`POST`	`/order`
Ampliar proxies	`POST`	`/extend`

Todas las rutas son relativas a/client-api/v1/<apiKey>/.

Lista de proxies comprados

GET/es-ES/client-api/v1/<apiKey>/get/proxies?proxyType=<type>

Devuelve todos los proxies activos del tipo solicitado.

Parámetro de consulta

Nombre	Tipo	Requerido	Descripción
`proxyType`	cadena	sí	Uno de:`ipv4`,`ipv6`,`isp`,`mobile`.

Ejemplo de solicitud

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/proxies?proxyType=ipv4"

Ejemplo de respuesta

Top-level añadecountOfProxy yproxies. Cambiar pestañas - la forma del objeto proxy difiere por tipo, e IPv6 se agrupa por orden.

json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "countOfProxy": 2,
  "proxies": [
    {
      "id": "id1",
      "ip": "185.81.112.215",
      "country": "GBR",
      "dateStart": "2022-08-29T14:55:38.293+00:00",
      "dateEnd":   "2022-08-30T23:59:38.293+00:00",
      "httpsPort": "49162",
      "socks5Port": "49163",
      "authInfo": { "login": "authLogin123", "password": "authPassword" }
    }
  ]
}

json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "countOfProxy": 2,
  "proxies": [
    {
      "id": "id1",
      "ip": "185.81.112.215",
      "country": "GBR",
      "dateStart": "2022-08-29T14:55:38.293+00:00",
      "dateEnd":   "2022-08-30T23:59:38.293+00:00",
      "httpsPort": "49162",
      "socks5Port": "49163",
      "authInfo": { "login": "authLogin123", "password": "authPassword" }
    }
  ]
}

json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv6",
  "countOfProxy": 2,
  "proxies": [
    {
      "orderId": "orderId1",
      "ips": [
        {
          "id": "id1",
          "ip": "140.82.53.23:10002",
          "country": "FRA",
          "dateStart": "2022-08-03T14:04:59.131+00:00",
          "dateEnd":   "2022-10-02T14:04:59.159+00:00",
          "protocol": "SOCKS5",
          "authInfo": { "login": "authLogin123", "password": "authPassword" }
        }
      ]
    }
  ]
}

json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "mobile",
  "countOfProxy": 2,
  "proxies": [
    {
      "id": "id1",
      "ip": "61.62.63.64",
      "country": "FRA",
      "dateStart": "2022-08-30T14:54:25.414+00:00",
      "dateEnd":   "2022-09-29T23:59:25.414+00:00",
      "httpsPort": "7781",
      "socks5Port": "8891",
      "mobileOperator": "freemobilesas_france",
      "rotationTime": 0,
      "rebootLink": "https://proxy-ipv4.com/modem/reboot/448eac96-8546-4389-8f56-54b2b4798d12",
      "authInfo": { "login": "authLogin123", "password": "authPassword" }
    }
  ]
}

Campos de nivel superior

Campo	Tipo	Descripción
`countOfProxy`	número	Total de proxies del tipo solicitado.
`proxies`	matriz	Lista de proxies. Para IPv6, los elementos son grupos de órdenes que contienen`ips`.

Campos del objeto proxy

Campo	Tipo	Presente en	Descripción
`id`	cadena	Todos	ID de proxy. Utilícelo cuando amplíe IPv4, ISP o Móvil.
`orderId`	cadena	Sólo IPv6	ID de pedido. IPv6 sólo puede ampliarse por pedido completo - utilícelo paraampliar las operaciones.
`ips`	matriz	Sólo IPv6	Lista por orden de objetos proxy individuales.
`ip`	cadena	Todos	La dirección IP. Para IPv6, el valor incluye un puerto (p. ej.`140.82.53.23:10002`).
`country`	cadena	Todos	Código de país ISO 3166-1 alfa-3.
`dateStart` /`dateEnd`	cadena	Todos	Marcas de tiempo ISO 8601 para la ventana de alquiler.
`httpsPort` /`socks5Port`	cadena	IPv4, ISP, Móvil	Puertos para HTTP/HTTPS y SOCKS5.
`protocol`	cadena	Sólo IPv6	`HTTPS` o`SOCKS5` - fijado en el momento del pedido.
`mobileOperator`	cadena	Sólo móvil	Etiqueta de operador, por ejemplo`freemobilesas_france`.
`rotationTime`	número	Sólo móvil	Intervalo de rotación de IP en minutos.`0` significa rotación sólo por enlace.
`rebootLink`	cadena	Sólo móvil	URL para activar manualmente la rotación de IP.
`authInfo`	objeto	Todos	`{ login, password }` para la autenticación proxy.

Tarifas móviles

GET/es-ES/client-api/v1/<apiKey>/get/mobile/tariffs

Sólo móvil. Devuelve las combinaciones disponibles de país, operador y hora de rotación. Utilícelo para descubrirmobileOperator yrotationTime antes de llamar a Calcular precio de compra o Realizar pedido de proxies móviles.

Ejemplo de solicitud

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/mobile/tariffs"

Ejemplo de respuesta

{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "tariffs": [
    {
      "country": "GBR",
      "mobileOperator": [
        { "name": "Three", "rotationTime": [0, 5, 10] },
        { "name": "O2",    "rotationTime": [5, 10] }
      ]
    },
    {
      "country": "USA",
      "mobileOperator": [
        { "name": "AT&T Wireless", "rotationTime": [0, 5, 10] }
      ]
    }
  ]
}

Campos de respuesta

Campo	Tipo	Descripción
`tariffs`	matriz	Lista de partidas arancelarias por países.
`tariffs[].country`	cadena	Código de país ISO 3166-1 alfa-3.
`tariffs[].mobileOperator`	matriz	Operadores disponibles en este país.
`tariffs[].mobileOperator[].name`	cadena	Etiqueta de operador - pasar como`mobileOperator` en las solicitudes de pedidos.
`tariffs[].mobileOperator[].rotationTime`	matriz de números	Permitido`rotationTime` en minutos.`0` significa rotación sólo por enlace.

Calcular el precio de compra

GET/es-ES/client-api/v1/<apiKey>/get/order/price?<params>

Devuelve el coste total y el precio por proxy de un pedido hipotético. Utilizar antes de Realizar un pedido para aflorar problemas de validación sin gastar saldo.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
`proxyType`	cadena	sí	Uno de:`ipv4`,`ipv6`,`isp`,`mobile`.
`days`	número	sí	Periodo de alquiler. Obtener valores válidos dePeriodos de alquiler disponibles.
`country`	cadena	sí	Código ISO 3166-1 alfa-3. Obtener valores válidos dePaíses disponibles.
`count`	número	sí	Número de apoderados.Para IPv6, debe ser ≥ 10.
`goal`	cadena	condicional	Finalidad de uso. Obligatorio a menos que`customGoal` se envía.
`customGoal`	cadena	condicional	Propósito personalizado, ≥ 5 caracteres.Sólo móvil - utilizar cuando`goal` no se ajusta a ningún valor predefinido. Uno de`goal` o`customGoal` debe estar presente.
`mobileOperator`	cadena	sólo móvil	Etiqueta de operador deTarifas móviles.
`rotationTime`	número	sólo móvil	Intervalo de rotación en minutos desdeTarifas móviles.

Ejemplos

bash
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\

bash
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\

Note `count=10` — IPv6 requires at least 10.

bash
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\
?proxyType=mobile&days=7&goal=instagram&country=FRA&count=1\
&mobileOperator=freemobilesas_france&rotationTime=5"

Ejemplo de respuesta

{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "days": 7,
  "count": 2,
  "goal": "instagram",
  "amount": 2.78,
  "price": 1.39
}

Para los móviles, la respuesta se hace eco ademásmobileOperator yrotationTime.

Campos de respuesta

Campo	Tipo	Descripción
`days`,`count`,`goal`	mixto	Se hace eco de los valores solicitados.
`amount`	número	Coste total en`currency`.
`price`	número	Coste por proxy.
`mobileOperator`,`rotationTime`	mixto	Sólo móvil - se hace eco de los valores solicitados.

Calcular el precio de la ampliación

GET/es-ES/client-api/v1/<apiKey>/get/extend/price?<params>

Devuelve el coste total y el precio por proxy para ampliar los proxies existentes. Utilizar antes deAmpliar proxies.

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
`proxyType`	cadena	sí	Uno de:`ipv4`,`ipv6`,`isp`,`mobile`.
`days`	número	sí	Periodo de renovación. Mismos valores válidos que para la compra.
`IpId`	cadena	para IPv4, ISP, Móvil	ID de proxy separados por comas.
`orderId`	cadena	para IPv6	ID de pedido separados por comas. IPv6 amplía los pedidos completos.

Ejemplos

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv4&days=7&IpId=id1,id2,id3"

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv4&days=7&IpId=id1,id2,id3"

Uses `orderId` instead of `IpId`.
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv6&days=30&orderId=orderId1,orderId2"

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv4&days=7&IpId=id1,id2,id3"

Ejemplo de respuesta

{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv4",
      "days": 7,
      "count": 3,
      "amount": 9.13,
      "price": 3.04,
      "ipId": ["id1", "id2", "id3"]
    }

{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv4",
      "days": 7,
      "count": 3,
      "amount": 9.13,
      "price": 3.04,
      "ipId": ["id1", "id2", "id3"]
    }

Adds `ordersId` (the requested order IDs) and expanded `ipId` (every
proxy contained in those orders).
{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv6",
      "days": 30,
      "count": 20,
      "amount": 123.42,
      "price": 6.17,
      "ordersId": ["orderId1", "orderId2"],
      "ipId": ["id1", "id2", "id3", "id4", "id5", "id6", "id7", "id8", "id9", "id10",
               "id11", "id12", "id13", "id14", "id15", "id16", "id17", "id18", "id19", "id20"]
    }

{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv4",
      "days": 7,
      "count": 3,
      "amount": 9.13,
      "price": 3.04,
      "ipId": ["id1", "id2", "id3"]
    }

Campos de respuesta

Campo	Tipo	Descripción
`days`	número	Se hace eco del periodo solicitado.
`count`	número	Total de proxies que se amplían. Para IPv6: suma de proxies en todos los pedidos solicitados.
`amount`	número	Coste total de la ampliación.
`price`	número	Coste de extensión por proxy.
`ipId`	matriz	ID de proxy incluidos en esta extensión. Para IPv6, ampliado a partir de los pedidos solicitados.
`ordersId`	matriz	Sólo IPv6 - se hace eco de los ID de pedido solicitados.

Hacer un pedido

POST/es-ES/client-api/v1/<apiKey>/order

Cuerpo de la solicitud

Nombre	Tipo	Requerido	Descripción
`proxyType`	cadena	sí	Uno de:`ipv4`,`ipv6`,`isp`,`mobile`.
`days`	número	sí	Periodo de alquiler.
`country`	cadena	sí	Código ISO 3166-1 alfa-3.
`count`	número	sí	Número de apoderados.Para IPv6, debe ser ≥ 10.
`goal`	cadena	sí	Finalidad de uso.
`authType`	cadena	sí	`login` o`ip`.
`authIp`	cadena	condicional	IP permitida para la autenticación. Obligatorio cuando`authType` es`ip`.
`protocol`	cadena	Sólo IPv6	`HTTPS` o`SOCKS5`.
`mobileOperator`	cadena	sólo móvil	Etiqueta de operador de tarifas móviles.
`rotationTime`	número	sólo móvil	Intervalo de rotación en minutos de las tarifas móviles.

Ejemplo de solicitud

curl -X POST https://proxy-ipv4.com/client-api/v1/API_KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv4",
        "days": 90,
        "goal": "instagram",
        "country": "GBR",
        "count": 2,
        "authType": "login"
      }'

curl -X POST https://proxy-ipv4.com/client-api/v1/API_KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv4",
        "days": 90,
        "goal": "instagram",
        "country": "GBR",
        "count": 2,
        "authType": "login"
      }'

Adds `protocol`. Requires `count >= 10`.

curl -X POST https://proxy-ipv4.com/client-api/v1/API_KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv6",
        "days": 30,
        "goal": "instagram",
        "country": "GBR",
        "count": 10,
        "authType": "login",
        "protocol": "SOCKS5"
      }'

Adds `mobileOperator` and `rotationTime`.

curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "mobile",
        "days": 30,
        "goal": "instagram",
        "country": "FRA",
        "count": 1,
        "authType": "login",
        "mobileOperator": "freemobilesas_france",
        "rotationTime": 5
      }'

When `authType=ip`, add `authIp`. Works for any `proxyType`.

curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv4",
        "days": 90,
        "goal": "instagram",
        "country": "GBR",
        "count": 2,
        "authType": "ip",
        "authIp": "203.0.113.42"
      }'

Ejemplo de respuesta

{
  "success": true,
  "user": "[email protected]",
  "balance": 4.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "orderNumber": "DV-16620211552356-jA"
}

Campos de respuesta

Campo	Tipo	Descripción
`orderNumber`	cadena	El número de la nueva orden. Utilícelo para buscar apoderados enLista de proxies comprados - para IPv6 aparece como`orderId` en las respuestas.
`balance`	número	Saldo restante después del cargo.

Ampliar proxies

POST/es-ES/client-api/v1/<apiKey>/extend

Renueva los poderes existentes y cobra el saldo.

Cuerpo de la solicitud

Nombre	Tipo	Requerido	Descripción
`proxyType`	cadena	sí	Uno de:`ipv4`,`ipv6`,`isp`,`mobile`.
`days`	número	sí	Periodo de renovación.
`IpId`	matriz de cadenas	para IPv4, ISP, Móvil	ID de proxy para ampliar.
`orderId`	matriz de cadenas	para IPv6	ID de pedido para ampliar.

Ejemplo de solicitud

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv4",
    "days": 30,
    "IpId": ["id1", "id2"]
  }'
```

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv4",
    "days": 30,
    "IpId": ["id1", "id2"]
  }'
```

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv4",
    "days": 30,
    "IpId": ["id1", "id2"]
  }'
```

Uses `orderId` array.

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv6",
    "days": 30,
    "orderId": ["orderId1"]
  }'
```

Ejemplo de respuesta

{
  "success": true,
  "user": "[email protected]",
  "balance": 4.09,
  "currency": "USD"
}

Campos de respuesta

Campo	Tipo	Descripción
`balance`	número	Saldo restante después del cargo.

Comprar y gestionar PI

Conceptos

Lista de proxies comprados

Parámetro de consulta

Ejemplo de solicitud

Ejemplo de respuesta

Campos de nivel superior

Campos del objeto proxy

Tarifas móviles

Ejemplo de solicitud

Ejemplo de respuesta

Campos de respuesta

Calcular el precio de compra

Parámetros de consulta

Ejemplos

Ejemplo de respuesta

Campos de respuesta

Calcular el precio de la ampliación

Parámetros de consulta

Ejemplos

Ejemplo de respuesta

Campos de respuesta

Hacer un pedido

Cuerpo de la solicitud

Ejemplo de solicitud

Ejemplo de respuesta

Campos de respuesta

Ampliar proxies

Cuerpo de la solicitud

Ejemplo de solicitud

Ejemplo de respuesta

Campos de respuesta

On this page