Ações com proxies

Gerencie os IPs em seus pedidos de proxy — liste-os, alterne-os, prorrogue-os ou anote-os.

Parâmetro comum. Cada endpoint nesta página opera em uma ordem específica. Passe o parâmetro `orderNumber` — obtenha-o em GET /proxy/list.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list

Retorna proxies ativos agrupados por tipo.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list/{type}

Retorna proxies ativos de um tipo. Suporta os mesmos parâmetros de consulta que /proxy/list

Parâmetros de caminho

Nome

Valor

Obrigatório

Descrição

Tipo

ipv4, ipv6, mobile, isp, mix, mix_isp, ou resident

Sim

Especifica o tipo de proxies a serem incluídos na lista baixada.

Autorização

<Your_API_Key>

Sim

Sua chave de API pessoal (Como obter)

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
mais recente	String	Não	`Y`retorna proxies do último pedido ativo quando `orderId` não é fornecida.
orderId	String	Não	Retornar um proxy a partir de um orderId ou OrderPart.number específico
país	String	Não	Nome do país na versão Alpha3 (FRA ou DEU re…)
fim	String	Não	`Y` retorna apenas `ENDED` proxies que ainda têm `dateEnd` no futuro. Caso contrário, proxies fechados serão excluídos.

Exemplo

Para recuperar proxies de todos os tipos:

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list

Para recuperar proxies de um tipo específico (por exemplo, IPv4):

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list/ipv4

Resposta

Todos os tipos de proxies

{
  "status": "success",
  "data": {
    "ipv4": [],
    "ipv6": [],
    "mobile": [],
    "isp": [],
    "mix": [],
    "mix_isp": [],
    "resident": []
  },
  "errors": []
}

Um tipo de proxy

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ]
    },
    "errors": []
}

Tipo incorreto de proxy

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list/{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Observe que, se nenhum tipo de proxy for especificado, todos os tipos disponíveis serão retornados para o seu perfil.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/download/{type}

Exportar IPs

Este endpoint da API permite que você baixe a lista dos seus proxies.

Parâmetros de caminho:

Nome	Valor	Obrigatório	Descrição
Tipo	`ipv4`, `ipv6`, `mobile`, `isp`, `mix`, `mix_isp`, ou `resident`	Sim	Especifica o tipo de proxies a serem incluídos na lista baixada.
Autorização	`<Your_API_Key>`	Sim	Sua chave de API pessoal (Como obter)

Parâmetros opcionais

Nome	Valor	Descrição
ext	txt csv	Especifica o formato no qual a lista de proxies será baixada.
	%login%:%senha%@%ip%:%porta%	Formato personalizado
proto	https socks5	Especifica o formato de porta de proxy de sua preferência para os proxies.
listId	Inteiro	ID da lista de proxies (apenas para residentes; se não for definido, retornará o IP de todas as planilhas)
package_key	String	Lista de proxies package_key (apenas para subresident)
país	String	Nome do país na versão Alpha3 (FRA ou EUA ou ...)
fim	String	`Y` - Lista de terminações

Exemplo

Para recuperar proxies de um tipo específico (por exemplo, IPv4):

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/download/ipv4?ext=txt&proto=https

Resposta

resposta: tipo de proxy incorreto

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Modificar

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/replace

Substitua os endereços IP

Alterne um IP sem perder o espaço na fila. Isso conta para a cota mensal de substituições.

Parâmetros de caminho

Nome	Valor	Obrigatório	Descrição
Autorização	`<Your_API_Key>`	Sim	Sua chave de API pessoal (Como obter)

Corpo da solicitação

Nome	Tipo	Descrição
ids	Número	Um único ID ou uma matriz de IDs entre '[ ]', separados por vírgulas
comentário	String	Comentário opcional a ser incluído na solicitação
tipo	String	Tipo de substituição

Exemplo

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/replace
{
    "ids": ["10"],
    "type": "CUSTOM",
    "comment": "Test replace IP"
}

Resposta

{
    "status": "success",
    "data": {
        "ok": {
            "ips": [
                "11.55.11.0"
            ],
            "msg": "Replacement request submitted"
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 503,
            "message": "Error api key",
            "customData": null
        },
        {
            "code": 503,
            "message": "IP not allowed",
            "customData": null
        },
        {
            "code": 503,
            "message": "Request limit reached",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set coorect type: NOT_WORK / INCORRECT_LOCATION / CANT_CHANGE_NETWORK / LOW_SPEED / CUSTOM",
            "customData": null
        }
    ]
}

Tipos de substituição: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM

POST https://proxy-seller.com/personal/api/v2/{apiKey}/prolong/calc/{type}

Prolongar IPs

Prorrogar a validade para IPs selecionados. Cobrança por IP por dia.

Este documento fornece um guia detalhado sobre como configurar a renovação automática para seus endereços IP de vários tipos. Observe que os endereços IP devem ser renovados dentro do prazo para manter os mesmos endereços.

Calcular extensão

Este endpoint ajuda você a calcular o custo. Os descontos por volume e períodos de aluguel são semelhantes aos oferecidos pelo nosso serviço.

Parâmetros de caminho

Nome

Valor

Obrigatório

Descrição

Autorização

<Your_API_Key>

Sim

Sua chave de API pessoal (Como obter)

Tipo

ipv4

ipv6

mobile

isp

mix

mix_isp

Sim

O tipo de proxy que você deseja estender

Corpo da solicitação

Nome	Tipo	Descrição
ids	Número	Um único ID ou uma matriz de IDs entre '[ ]', separados por vírgulas (como obter)
cupom	String	O comentário que você deseja adicionar
periodId	String	ID do período selecionado na solicitação /reference/list/{type}

Exemplo (por exemplo, ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/calc/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Resposta

{
    "status": "success",
    "data": {
        "warning": "",
        "balance": 498648.72,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login ",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/prolong/make/{type}

Prolongar IPs

Nesta seção, você aprenderá como criar um pedido de renovação.

Criar um pedido de renovação

Cria um pedido de extensão.

Parâmetros de caminho

Nome

Valor

Obrigatório

Descrição

Autorização

<Your_API_Key>

Sim

Sua chave de API pessoal (Como obter)

Tipo

ipv4

ipv6

mobile

isp

mix

mix_isp

Sim

O tipo de proxy que você deseja estender

Corpo da solicitação

Nome	Tipo	Descrição
ids	Número	Um único ID ou uma lista de IDs entre '[ ]', separados por vírgulas (como obter)
cupom	String	Código promocional.
periodId	String	ID do período selecionado na solicitação /reference/list/{type}
paymentId	String	IDs do sistema de pagamentos "69e799e7497b2c153b33faca" - equilíbrio, "69e799e8497b2c153b33faed" - cartão que você adicionou ao seu armário

Exemplo (por exemplo, ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/make/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Resposta

{
    "status": "success",
    "data": {
        "orderId": "69fa4b795a1f522c7a53d589",
        "total": 3.49,
        "listBaseOrderNumbers": [
            "TEST_1778011001948-uc_e_UUf2Z3RtGH"
        ],
        "balance": 1.00
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "base_order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "ip": "11.55.11.0",
                "port_http": null,
                "port_socks": null,
                "login": "x2alltop0qRU6",
                "password": "gwBwtL9LMM",
                "authIp": "",
                "country": "Germany",
                "date_start": "05.05.2026 19:56:42",
                "date_end": "10.08.2026 23:59:59",
                "comment": "",
                "status": "Active",
                "rotation": null,
                "link_reboot": "#",
                "can_prolong": true
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/comment/set

Adicionar comentários

Anexe uma nota de texto livre (máximo de 256 caracteres) para ajudar a identificar um IP na interface do usuário ou nas exportações.

Parâmetros de caminho

Nome	Valor	Obrigatório	Descrição
Autorização	`<Your_API_Key>`	Sim	Sua chave API pessoal (Como obter)

Corpo da solicitação

Nome	Tipo	Descrição
ids	Número	Um único ID ou uma lista de IDs entre '[ ]', separados por vírgulas (como obter)
comentário	String	O comentário que você deseja adicionar

Exemplo

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/comment/set
{
    "ids": ["10"],
    "comment": "My server"
}

Resposta

{
    "status": "success",
    "data": {
        "updated": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

Comum a todos os endpoints de proxy

URL base

https://proxy-seller.com/personal/api/v2/{YourApiKey}/

Autenticação
Chave de API no caminho da URL.
Modelo de erros
Erros de negócios retornam HTTP 200 com errors[] preenchido.

Depois de gerenciar seus IPs

Authorizationissue per-order credentialsOpen Order actionsbuy more proxies when you need additional IPsOpen Balancecheck funds before bulk prolongationOpen

Parâmetros de caminho

Parâmetros de consulta

Exemplo

Resposta

Parâmetros de caminho:

Parâmetros opcionais

Exemplo

Resposta

Modificar

Parâmetros de caminho

Corpo da solicitação

Exemplo

Resposta

Calcular extensão

Parâmetros de caminho

Corpo da solicitação

Exemplo (por exemplo, ipv4)

Resposta

Criar um pedido de renovação

Parâmetros de caminho

Corpo da solicitação

Exemplo (por exemplo, ipv4)

Resposta

Parâmetros de caminho

Exemplo

Resposta

Comum a todos os endpoints de proxy

URL base

Autenticação

Modelo de erros

Depois de gerenciar seus IPs

On this page