Este guia mostra como substituir um IP problemático por um novo. Você pode solicitar a substituição de IP de um proxy uma vez por dia. O processamento pode levar algum tempo.
Cada requisição usa sua chave de API pessoal do painel da sua conta (como obter sua chave de API). Nos exemplos abaixo, substitua YOUR_API_KEY pela sua própria chave. Para pagar com o saldo da conta, use paymentId = 1.
Passo 1 — Encontre os proxies a substituir
Liste seus proxies ativos e copie o id de cada um que deseja substituir. Anote o tipo de proxy.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Resposta
{
"status": "success",
"data": {
"items": [
{ "id": "0678564", "ip": "31.6.33.97", "country_alpha3": "BEL", "status_type": "ACTIVE", "can_prolong": true, "date_end": "23.07.2024" }
]
},
"errors": []
}
Passo 2 — Solicite a substituição
Envie a solicitação de substituição com os ids dos proxies, o type (motivo da substituição) e um comentário opcional. A resposta retorna os novos IPs.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Corpo da requisição
Nome | Tipo | Descrição |
ids | Number / Array | Um único ID ou um array de IDs em |
type | String | Motivo da substituição — veja os valores permitidos abaixo. |
comment (opcional) | String | Comentário opcional para incluir na solicitação. |
Valores permitidos de type: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM.
Exemplo
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Resposta
{
"status": "success",
"data": {
"ok": {
"ips": [ "31.6.33.97" ],
"msg": "Replacement request submitted"
}
},
"errors": []
}
Referência completa da API
Retrieve active proxy — liste seus proxies