Proxy-IPv4

Comprar e gerenciar IP

Atualizado:

Pontos de extremidade do ciclo de vida para trabalhar com proxies na conta. O mesmo conjunto de operações funciona para todos os quatro tipos de proxy (ipv4,ipv6,isp,mobile) com pequenas peculiaridades por tipo mencionadas em cada seção.

Conceitos

proxyType. Sempre um dosipv4,ipv6,isp,mobile. Necessário em todas as solicitações como um parâmetro de consulta ou um campo do corpo.

id vsorderId. A maioria dos tipos aborda os proxies individualmente porid.O IPv6 é a exceção - Os proxies IPv6 são comprados, listados e renovados pororderIdporque cada ordem IPv6 é tratada como um grupo indivisível.

mobile-somente campos. Os proxies móveis têm alguns conceitos adicionais: uma lista de operadoras, um tempo de rotação por operadora e um link de reinicialização para alternar manualmente o IP. VejaTarifas de celular.

Envelope de resposta comum. Todos os endpoints desta página retornam essa forma de nível superior em caso de sucesso - apenas os campos específicos da operação diferem:

{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4"
}

Campo

Tipo

Descrição

success

booleano

Status da operação.

user

string

E-mail da conta.

balance

número

Saldo da conta após a operação, emcurrency.

currency

string

Código ISO da moeda.

proxyType

string

Ecoa o tipo solicitado.

Para todos os outros campos de nível superior e formas de objeto proxy por tipo, consulte cada operação abaixo.

Operação

Método

Caminho

Lista de proxies comprados

GET

/get/proxies

Tarifas de celular

GET

/get/mobile/tariffs

Calcular o preço de compra

GET

/get/order/price

Calcular o preço da extensão

GET

/get/extend/price

Fazer um pedido

POST

/order

Ampliar proxies

POST

/extend

Todos os caminhos são relativos a/client-api/v1/<apiKey>/.

Lista de proxies comprados

GET/pt-BR/client-api/v1/<apiKey>/get/proxies?proxyType=<type>

Retorna todos os proxies ativos do tipo solicitado.

Parâmetro de consulta

Nome

Tipo

Necessário

Descrição

proxyType

string

sim

Um de:ipv4,ipv6,isp,mobile.

Exemplo de solicitação

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/proxies?proxyType=ipv4"

Exemplo de resposta

Adições de nível superiorcountOfProxy eproxies. Guias de troca - o formato do objeto proxy difere por tipo, e o IPv6 é agrupado por ordem.

json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "countOfProxy": 2,
  "proxies": [
    {
      "id": "id1",
      "ip": "185.81.112.215",
      "country": "GBR",
      "dateStart": "2022-08-29T14:55:38.293+00:00",
      "dateEnd":   "2022-08-30T23:59:38.293+00:00",
      "httpsPort": "49162",
      "socks5Port": "49163",
      "authInfo": { "login": "authLogin123", "password": "authPassword" }
    }
  ]
}
json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "countOfProxy": 2,
  "proxies": [
    {
      "id": "id1",
      "ip": "185.81.112.215",
      "country": "GBR",
      "dateStart": "2022-08-29T14:55:38.293+00:00",
      "dateEnd":   "2022-08-30T23:59:38.293+00:00",
      "httpsPort": "49162",
      "socks5Port": "49163",
      "authInfo": { "login": "authLogin123", "password": "authPassword" }
    }
  ]
}
json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv6",
  "countOfProxy": 2,
  "proxies": [
    {
      "orderId": "orderId1",
      "ips": [
        {
          "id": "id1",
          "ip": "140.82.53.23:10002",
          "country": "FRA",
          "dateStart": "2022-08-03T14:04:59.131+00:00",
          "dateEnd":   "2022-10-02T14:04:59.159+00:00",
          "protocol": "SOCKS5",
          "authInfo": { "login": "authLogin123", "password": "authPassword" }
        }
      ]
    }
  ]
}
json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "mobile",
  "countOfProxy": 2,
  "proxies": [
    {
      "id": "id1",
      "ip": "61.62.63.64",
      "country": "FRA",
      "dateStart": "2022-08-30T14:54:25.414+00:00",
      "dateEnd":   "2022-09-29T23:59:25.414+00:00",
      "httpsPort": "7781",
      "socks5Port": "8891",
      "mobileOperator": "freemobilesas_france",
      "rotationTime": 0,
      "rebootLink": "https://proxy-ipv4.com/modem/reboot/448eac96-8546-4389-8f56-54b2b4798d12",
      "authInfo": { "login": "authLogin123", "password": "authPassword" }
    }
  ]
}

Campos de nível superior

Campo

Tipo

Descrição

countOfProxy

número

Total de proxies do tipo solicitado.

proxies

matriz

Lista de proxies. Para IPv6, os itens são grupos de ordens contendoips.

Campos do objeto proxy

Campo

Tipo

Presente em

Descrição

id

string

Todos

ID do proxy. Use-o ao estender o IPv4, ISP ou Mobile.

orderId

string

Somente IPv6

ID do pedido. O IPv6 só pode ser estendido por pedido inteiro - use isso paraampliar operações.

ips

matriz

Somente IPv6

Lista por ordem de objetos proxy individuais.

ip

string

Todos

O endereço IP. Para IPv6, o valor inclui uma porta (por exemplo140.82.53.23:10002).

country

string

Todos

Código de país ISO 3166-1 alfa-3.

dateStart /dateEnd

string

Todos

Carimbos de data e hora ISO 8601 para a janela de aluguel.

httpsPort /socks5Port

string

IPv4, ISP, Móvel

Portas para HTTP/HTTPS e SOCKS5.

protocol

string

Somente IPv6

HTTPS ouSOCKS5 - fixado no momento do pedido.

mobileOperator

string

Somente celular

Etiqueta do operador, por exemplofreemobilesas_france.

rotationTime

número

Somente celular

Intervalo de rotação de IP em minutos.0 significa rotação somente por link.

rebootLink

string

Somente celular

URL para acionar manualmente a rotação de IP.

authInfo

objeto

Todos

{ login, password } para autenticação de proxy.

Tarifas de celular

GET/pt-BR/client-api/v1/<apiKey>/get/mobile/tariffs

Somente celular. Retorna as combinações disponíveis de país, operadora e horário de rotação. Use isso para descobrirmobileOperator erotationTime antes de chamar Calculate purchase price (Calcular preço de compra) ou Place an order (Fazer um pedido) para proxies móveis.

Exemplo de solicitação

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/mobile/tariffs"

Exemplo de resposta

{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "tariffs": [
    {
      "country": "GBR",
      "mobileOperator": [
        { "name": "Three", "rotationTime": [0, 5, 10] },
        { "name": "O2",    "rotationTime": [5, 10] }
      ]
    },
    {
      "country": "USA",
      "mobileOperator": [
        { "name": "AT&T Wireless", "rotationTime": [0, 5, 10] }
      ]
    }
  ]
}

Campos de resposta

Campo

Tipo

Descrição

tariffs

matriz

Lista de entradas tarifárias em nível de país.

tariffs[].country

string

Código de país ISO 3166-1 alfa-3.

tariffs[].mobileOperator

matriz

Operadoras disponíveis no país.

tariffs[].mobileOperator[].name

string

Etiqueta de operador - passar comomobileOperator em solicitações de pedidos.

tariffs[].mobileOperator[].rotationTime

matriz de números

PermitidorotationTime valores em minutos.0 significa rotação somente por link.

Calcular o preço de compra

GET/pt-BR/client-api/v1/<apiKey>/get/order/price?<params>

Retorna o custo total e o preço por proxy de um pedido hipotético. Use antes de fazer um pedido para identificar problemas de validação sem gastar saldo.

Parâmetros de consulta

Nome

Tipo

Necessário

Descrição

proxyType

string

sim

Um de:ipv4,ipv6,isp,mobile.

days

número

sim

Período de aluguel. Obtenha valores válidos dePeríodos de aluguel disponíveis.

country

string

sim

Código ISO 3166-1 alfa-3. Obtenha valores válidos dePaíses disponíveis.

count

número

sim

Número de procurações.Para IPv6, deve ser ≥ 10.

goal

string

condicional

Finalidade do uso. Obrigatório, a menos quecustomGoal é enviado.

customGoal

string

condicional

Finalidade personalizada, ≥ 5 caracteres.Somente celular - usar quandogoal não se encaixa em nenhum valor predefinido. Um degoal oucustomGoal deve estar presente.

mobileOperator

string

somente celular

Etiqueta de operador deTarifas de celular.

rotationTime

número

somente celular

Intervalo de rotação em minutos deTarifas de celular.

Exemplos

bash
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\
bash
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\
Note `count=10` — IPv6 requires at least 10.

bash
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\
?proxyType=mobile&days=7&goal=instagram&country=FRA&count=1\
&mobileOperator=freemobilesas_france&rotationTime=5"

Exemplo de resposta

{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "days": 7,
  "count": 2,
  "goal": "instagram",
  "amount": 2.78,
  "price": 1.39
}

Para celulares, a resposta também ecoamobileOperator erotationTime.

Campos de resposta

Campo

Tipo

Descrição

days,count,goal

misto

Ecoa os valores solicitados.

amount

número

Custo total emcurrency.

price

número

Custo por proxy.

mobileOperator,rotationTime

misto

Somente celular - ecoa os valores solicitados.

Calcular o preço da extensão

GET/pt-BR/client-api/v1/<apiKey>/get/extend/price?<params>

Retorna o custo total e o preço por proxy para estender os proxies existentes. Usar antes deAmpliar proxies.

Parâmetros de consulta

Nome

Tipo

Necessário

Descrição

proxyType

string

sim

Um de:ipv4,ipv6,isp,mobile.

days

número

sim

Período de renovação. Os mesmos valores válidos para a compra.

IpId

string

para IPv4, ISP, Móvel

IDs de proxy separados por vírgula.

orderId

string

para IPv6

IDs de pedidos separados por vírgula. O IPv6 estende os pedidos inteiros.

Exemplos

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv4&days=7&IpId=id1,id2,id3"
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv4&days=7&IpId=id1,id2,id3"
Uses `orderId` instead of `IpId`.
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv6&days=30&orderId=orderId1,orderId2"
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv4&days=7&IpId=id1,id2,id3"

Exemplo de resposta

{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv4",
      "days": 7,
      "count": 3,
      "amount": 9.13,
      "price": 3.04,
      "ipId": ["id1", "id2", "id3"]
    }
{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv4",
      "days": 7,
      "count": 3,
      "amount": 9.13,
      "price": 3.04,
      "ipId": ["id1", "id2", "id3"]
    }
Adds `ordersId` (the requested order IDs) and expanded `ipId` (every
proxy contained in those orders).
{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv6",
      "days": 30,
      "count": 20,
      "amount": 123.42,
      "price": 6.17,
      "ordersId": ["orderId1", "orderId2"],
      "ipId": ["id1", "id2", "id3", "id4", "id5", "id6", "id7", "id8", "id9", "id10",
               "id11", "id12", "id13", "id14", "id15", "id16", "id17", "id18", "id19", "id20"]
    }
{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv4",
      "days": 7,
      "count": 3,
      "amount": 9.13,
      "price": 3.04,
      "ipId": ["id1", "id2", "id3"]
    }

Campos de resposta

Campo

Tipo

Descrição

days

número

Ecoa o período solicitado.

count

número

Total de proxies que estão sendo estendidos. Para IPv6 - soma dos proxies nos pedidos solicitados.

amount

número

Custo total da extensão.

price

número

Custo de extensão por proxy.

ipId

matriz

IDs de proxy incluídos nesta extensão. Para IPv6, expandido a partir dos pedidos solicitados.

ordersId

matriz

Somente IPv6 - ecoa as IDs de pedido solicitadas.

Fazer um pedido

POST/pt-BR/client-api/v1/<apiKey>/order

Corpo da solicitação

Nome

Tipo

Necessário

Descrição

proxyType

string

sim

Um de:ipv4,ipv6,isp,mobile.

days

número

sim

Período de aluguel.

country

string

sim

Código ISO 3166-1 alfa-3.

count

número

sim

Número de procurações.Para IPv6, deve ser ≥ 10.

goal

string

sim

Finalidade do uso.

authType

string

sim

login ouip.

authIp

string

condicional

IP listado como permitido para autenticação. Necessário quandoauthType éip.

protocol

string

Somente IPv6

HTTPS ouSOCKS5.

mobileOperator

string

somente celular

Etiqueta de operadora das tarifas móveis.

rotationTime

número

somente celular

Intervalo de rotação em minutos das tarifas móveis.

Exemplo de solicitação

curl -X POST https://proxy-ipv4.com/client-api/v1/API_KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv4",
        "days": 90,
        "goal": "instagram",
        "country": "GBR",
        "count": 2,
        "authType": "login"
      }'
curl -X POST https://proxy-ipv4.com/client-api/v1/API_KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv4",
        "days": 90,
        "goal": "instagram",
        "country": "GBR",
        "count": 2,
        "authType": "login"
      }'
Adds `protocol`. Requires `count >= 10`.

curl -X POST https://proxy-ipv4.com/client-api/v1/API_KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv6",
        "days": 30,
        "goal": "instagram",
        "country": "GBR",
        "count": 10,
        "authType": "login",
        "protocol": "SOCKS5"
      }'
Adds `mobileOperator` and `rotationTime`.

curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "mobile",
        "days": 30,
        "goal": "instagram",
        "country": "FRA",
        "count": 1,
        "authType": "login",
        "mobileOperator": "freemobilesas_france",
        "rotationTime": 5
      }'
When `authType=ip`, add `authIp`. Works for any `proxyType`.

curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv4",
        "days": 90,
        "goal": "instagram",
        "country": "GBR",
        "count": 2,
        "authType": "ip",
        "authIp": "203.0.113.42"
      }'

Exemplo de resposta

{
  "success": true,
  "user": "[email protected]",
  "balance": 4.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "orderNumber": "DV-16620211552356-jA"
}

Campos de resposta

Campo

Tipo

Descrição

orderNumber

string

O número do novo pedido. Use-o para procurar proxies emLista de proxies comprados - Para IPv6, aparece comoorderId em respostas.

balance

número

Saldo remanescente após a cobrança.

Ampliar proxies

POST/pt-BR/client-api/v1/<apiKey>/extend

Renova as procurações existentes e cobra o saldo.

Corpo da solicitação

Nome

Tipo

Necessário

Descrição

proxyType

string

sim

Um de:ipv4,ipv6,isp,mobile.

days

número

sim

Período de renovação.

IpId

matriz de cadeias de caracteres

para IPv4, ISP, Móvel

IDs de proxy a serem estendidos.

orderId

matriz de cadeias de caracteres

para IPv6

IDs de pedidos a serem estendidos.

Exemplo de solicitação

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv4",
    "days": 30,
    "IpId": ["id1", "id2"]
  }'
```

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv4",
    "days": 30,
    "IpId": ["id1", "id2"]
  }'
```

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv4",
    "days": 30,
    "IpId": ["id1", "id2"]
  }'
```

Uses `orderId` array.

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv6",
    "days": 30,
    "orderId": ["orderId1"]
  }'
```

Exemplo de resposta

{
  "success": true,
  "user": "[email protected]",
  "balance": 4.09,
  "currency": "USD"
}

Campos de resposta

Campo

Tipo

Descrição

balance

número

Saldo remanescente após a cobrança.

On this page

Conceitos
Lista de proxies comprados
Parâmetro de consulta
Exemplo de solicitação
Exemplo de resposta
Campos de nível superior
Campos do objeto proxy
Tarifas de celular
Exemplo de solicitação
Exemplo de resposta
Campos de resposta
Calcular o preço de compra
Parâmetros de consulta
Exemplos
Exemplo de resposta
Campos de resposta
Calcular o preço da extensão
Parâmetros de consulta
Exemplos
Exemplo de resposta
Campos de resposta
Fazer um pedido
Corpo da solicitação
Exemplo de solicitação
Exemplo de resposta
Campos de resposta
Ampliar proxies
Corpo da solicitação
Exemplo de solicitação
Exemplo de resposta
Campos de resposta