Extender por orderID

Punto final:

POST/es-ES/client/api/v1/{apiKey}/calculate/extend/order

Devuelve el precio antes de extender órdenes enteras - cada IP en las órdenes especificadas se extiende. Llame siempre a esto antes de la solicitud de Extender por IDs de pedido para resolver problemas de validación sin gastar saldo. Para calcular el precio para extender IPs específicos en su lugar, utiliceAmpliar por IP.

Cuerpo de la solicitud

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

Ejemplo

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

ParaIPv6,MOBILEoISP - cambioproxyType y utilizar los ID de pedido 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": 25,
        "message": "Incorrect order IDs"
      },
      "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.