Extensão automática por IPs

Ponto final:

POST/pt-BR/client/api/v1/{apiKey}/extend/auto1/{apiKey}/resource/{id}

Ativa a renovação automática para endereços IP específicos. Quando ativado, os IPs serão automaticamente estendidos porrentPeriodDays antes de expirarem. Para ativar a extensão automática em pedidos inteiros, use Auto-extend by order IDs.

Nome	Tipo	Descrição
apiKey*	Cordas	Sua chave de API pessoal.

Corpo da solicitação

Nome	Tipo	Descrição
`proxyType`*	string	Um de:`IPv4`,`IPv6`,`MOBILE`,`ISP`.
`ipAddressIds`*	matriz	IDs de endereço IP para ativar a extensão automática. Obtenha-os emObter endereços IP.
`rentPeriodDays`*	número	Duração da extensão em dias para cada renovação automática. Obtenha valores válidos dePeríodo de aluguel.
`autoExtend`*	booleano	`true` para ativar a extensão automática,`false` para desativar.

Exemplo

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,MOBILEouISP - mudançaproxyType e usar as IDs correspondentes deObter endereços IP. O formato da carroceria é idêntico.

Resposta

A mesma forma para todos os tipos de proxy. Alterne as guias para ver cada cenário.

{
      "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 resposta

Campo	Tipo	Descrição
`success`	booleano	`true` no sucesso,`false` se`error` é preenchido.
`proxyType`	string \| null	Ecoa o tipo solicitado.`null` por erro.
`rentPeriodDays`	número	Ecoa o período solicitado.`0` por erro.
`quantity`	número	Número de IPs aos quais a alteração foi aplicada.`0` por erro.
`ipAddressIds`	matriz	Ecoa as IDs solicitadas. Matriz vazia em caso de erro.
`balance`	número	Saldo da conta em`currency`.
`currency`	string	Código de moeda ISO (por exemplo`USD`).
`error`	objeto \| nulo	`{ code, message }` em caso de falha. VejaPossíveis erros para códigos.

O status HTTP é200 OK para respostas de sucesso e de erro - verifiquesuccess: false para detectar falhas, e não o código HTTP.