Ampliación automática por IP

Punto final:

POST/es-ES/client/api/v1/{apiKey}/extend/auto1/{apiKey}/resource/{id}

Activa la renovación automática para direcciones IP específicas. Cuando está activada, las IP se prorrogarán automáticamente porrentPeriodDays antes de que caduquen. Para activar la prórroga automática en órdenes completas, utilice Prórroga automática por ID de orden.

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 activar la ampliación automática. Obténgalos deObtener direcciones IP.
`rentPeriodDays`*	número	Duración de la prórroga en días para cada renovación automática. Obtener valores válidos dePeríodo de alquiler.
`autoExtend`*	booleano	`true` para activar la ampliación automática,`false` para desactivar.

Ejemplo

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

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. Cambia de pestaña para ver cada escenario.

{
      "success": true,
      "proxyType": "IPv4",
      "rentPeriodDays": 30,
      "quantity": 1,
      "ipAddressIds": ["1111111111111111"],
      "balance": 5,
      "currency": "USD",
      "error": null
    }

{
      "success": false,
      "proxyType": null,
      "rentPeriodDays": 0,
      "quantity": 0,
      "ipAddressIds": [],
      "balance": 5,
      "currency": "USD",
      "error": {
        "code": 4,
        "message": "Incorrect proxy type"
      }
    }

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.
`rentPeriodDays`	número	Se hace eco del periodo solicitado.`0` por error.
`quantity`	número	Número de IPs a las que se aplicó el cambio.`0` por error.
`ipAddressIds`	matriz	Se hace eco de los ID solicitados. Matriz vacía en caso de error.
`balance`	número	Saldo de la cuenta en`currency`.
`currency`	cadena	Código de divisa ISO (por ejemplo`USD`).
`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.