Estender por orderID

Ponto final:

POST/pt-BR/client/api/v1/{apiKey}/calculate/extend/order

Retorna o preço antes de estender os pedidos inteiros - todos os IPs nos pedidos especificados são estendidos. Sempre chame esse recurso antes da solicitação real de estender por IDs de pedido para que os problemas de validação venham à tona sem gastar saldo. Para calcular o preço da extensão de IPs específicos, useEstender por IPs.

Corpo da solicitação

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

Exemplo

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,MOBILEouISP - mudançaproxyType e usar os IDs de pedido 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": 25,
        "message": "Incorrect order IDs"
      },
      "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.