Estender por IPs

Ponto final:

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

Retorna o preço antes de estender endereços IP específicos. Sempre chame essa opção antes da solicitação real de Estender por endereços IP para detectar problemas de validação sem gastar saldo. Para calcular o preço da extensão de pedidos inteiros, use Extend by orders ID.

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

Corpo da solicitação

Nome	Tipo	Descrição
proxyType*	Cordas	Um de:`IPv4`,`IPv6`,`MOBILE`,`ISP`.
ipAddressIds*	matriz	IDs de endereço IP para estender. Obtenha-os emObter endereços IP.
aluguelPeríodoDias*	número	Duração da extensão em dias. Obtenha valores válidos dePeríodo de aluguel.
código promocional*	Cordas	Código promocional de desconto. Obtenha valores válidos a partir deCódigos promocionais.

Nota paraIPv6: todos os IPs da mesma ordem devem ser estendidos juntos - a extensão parcial não é permitida. Passe todos osipAddressIds do pedido em uma única solicitação.

Exemplo

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

Resposta

Mesmo formato para todos os tipos de proxy -proxyType ecoa o valor solicitado. Alterne as guias para ver cada cenário.

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

Campo	Tipo	Descrição
`success`	booleano	`true` no sucesso,`false` se`error` é preenchido.
`proxyType`	string \| null	Ecoa o tipo solicitado.`null` por erro.
`balance`	número	Saldo da conta em`currency`.
`price`	número \| nulo	Custo de extensão calculado.`null` por erro.
`currency`	string	Código de moeda ISO (por exemplo`USD`).
`discount`	número \| nulo	Porcentagem de desconto aplicada (por exemplo.`10` = 10%).`0` se não houver código promocional.
`promoCodeStatus`	string \| null	`VALID`,`NO_VALID`ou`null` se não houver`promoCode` enviado.
`warnings`	array \| null	Problemas de não bloqueio. Se estiverem presentes, a extensão não será executada com os dados atuais.
`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.

Ponto final:

Corpo da solicitação

Exemplo

Resposta

Campos de resposta

On this page