Ampliar por IP

Punto final:

POSTPOST /client/api/v1/{apiKey}/calculate/extend

Devuelve el precio antes de extender direcciones IP específicas. Llame siempre a esta opción antes de la petición Extend by IP addresses para resolver problemas de validación sin gastar saldo. Para calcular el precio de la ampliación de pedidos completos, utilice Ampliar por ID de pedido.

Nombre	Tipo	Descripción
apiKey*	Cadena	Su clave personal de API.

Cuerpo de la solicitud

Nombre	Tipo	Descripción
proxyType*	Cadena	Uno de:`IPv4`,`IPv6`,`MOBILE`,`ISP`.
ipAddressIds*	matriz	ID de direcciones IP para ampliar. Obténgalos deObtener direcciones IP.
rentPeriodDays*	número	Duración de la prórroga en días. Obtener valores válidos dePeríodo de alquiler.
código promocional*	Cadena	Código promocional de descuento. Obtenga valores válidos a partir deCódigos promocionales.

Nota paraIPv6: todas las IP del mismo pedido deben ampliarse juntas - no se permite la ampliación parcial. Pase cadaipAddressIds de la orden en una sola solicitud.

Ejemplo

curl -X POST https://youproxy.io/client/api/v1/$KEY/calculate/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "IPv4",
    "ipAddressIds": ["1111111111111111", "2222222222222222"],
    "rentPeriodDays": 30,
    "promoCode": "SAVE10"
  }'

ParaIPv6,MOBILEoISP - cambioproxyType y utilizar los ID correspondientes deObtener direcciones IP. Por lo demás, la forma del cuerpo es idéntica.

Respuesta

La misma forma para todos los tipos de proxy -proxyType se hace eco del valor solicitado. Cambie de pestaña para ver cada escenario.

{
      "success": true,
      "proxyType": "IPv4",
      "balance": 7.18,
      "price": 2.65,
      "currency": "USD",
      "discount": 0,
      "promoCodeStatus": null,
      "error": null,
      "warnings": null
    }

{
      "success": true,
      "proxyType": "IPv4",
      "balance": 7.18,
      "price": 8.30,
      "currency": "USD",
      "discount": 0,
      "promoCodeStatus": null,
      "error": null,
      "warnings": [
        {
          "code": 16,
          "message": "Insufficient funds on balance"
        }
      ]
    }

{
      "success": true,
      "proxyType": "IPv4",
      "balance": 7.18,
      "price": 2.65,
      "currency": "USD",
      "discount": 0,
      "promoCodeStatus": "VALID",
      "error": null,
      "warnings": null
    }

{
      "success": true,
      "proxyType": "IPv4",
      "balance": 7.18,
      "price": 2.65,
      "currency": "USD",
      "discount": 0,
      "promoCodeStatus": "NO_VALID",
      "error": null,
      "warnings": null
    }

{
      "success": false,
      "proxyType": null,
      "balance": 0.65,
      "price": null,
      "currency": "USD",
      "discount": null,
      "promoCodeStatus": null,
      "error": {
        "code": 24,
        "message": "Incorrect ip addresses"
      },
      "warnings": null
    }

Campos de respuesta

Campo	Tipo	Descripción
`success`	booleano	`true` en el éxito,`false` si`error` está poblada.
`proxyType`	cadena \| null	Se hace eco del tipo solicitado.`null` por error.
`balance`	número	Saldo de la cuenta en`currency`.
`price`	número \| null	Coste de ampliación calculado.`null` por error.
`currency`	cadena	Código de divisa ISO (por ejemplo`USD`).
`discount`	número \| null	Porcentaje de descuento aplicado (por ejemplo`10` = 10%).`0` si no hay código promocional.
`promoCodeStatus`	cadena \| null	`VALID`,`NO_VALID`o`null` si no`promoCode` enviado.
`warnings`	array \| null	Problemas de no bloqueo. Si está presente, la extensión no pasará con los datos actuales.
`error`	objeto \| null	`{ code, message }` en caso de fallo. VéasePosibles errores para los códigos.

El estado HTTP es200 OK tanto para las respuestas correctas como para las erróneassuccess: false para detectar fallos, no el código HTTP.

Punto final:

Cuerpo de la solicitud

Ejemplo

Respuesta

Campos de respuesta

On this page