Proxy-seller

Proxy e ordini

Updated:

Autorizzazioni: account:read, account:write, fatturazione:scrivi

In questo gruppo

Strumento

Cosa fa

list_proxies

🢢 read

I tuoi proxy attivi di un tipo: IP, porte HTTP/SOCKS, credenziali, paese, data di scadenza, stato di rinnovo automatico e commento.

export_proxies

🢢 read

Esportare i proxy sotto forma di elenco pronto all’uso, un proxy per riga.

get_reference

🢢 read

Paesi disponibili, periodi di noleggio e pacchetti per una determinata tipologia di prodotto.

calc_order_cost

🢢 read

Prezzo e sconto per un nuovo ordine, senza effettuare l’ordine stesso.

make_order

đź’ł pays

Effettua un nuovo ordine proxy.

list_orders

🢢 read

I tuoi ordini, in ordine cronologico dal più recente al più vecchio, e i destinatari già presenti sull’account.

check_order_status

🢢 read

Verifica se i proxy relativi a un ordine effettuato sono stati emessi.

calc_prolong_cost

🢢 read

Prezzo di rinnovo per proxy specifici, senza rinnovo.

make_prolong

đź’ł pays

Rinnovare le deleghe per un altro periodo.

replace_proxy

🟡 write

Richiedere la sostituzione dei proxy non funzionanti.

set_proxy_comment

🟡 write

Inserire lo stesso commento su uno o piĂą proxy.

list_proxies

🢢 read-only · account:read

I tuoi proxy attivi di un tipo: IP, porte HTTP/SOCKS, credenziali, paese, data di scadenza, stato di rinnovo automatico e commento. password viene restituito mascherato a meno che non lo si richieda espressamente. I proxy con status: "Ended" sono a breve, non scaduto — date_end è la data di scadenza effettiva.

Parametro

Tipo

Descrizione

type obbligatorio

tipo di proxy

Tipo di prodotto. mix è solo il pacchetto IPv4 MIX e mix_isp il pacchetto ISP MIX — due elenchi distinti, quindi “tutti i miei proxy MIX” indica entrambi. subresident non è supportato qui: utilizzare list_resident_subuser_lists

orderId

stringa | numero intero

Un solo ordine

country

string

Codice Alpha-3, ad es. USA

latest

booleano

Solo le deleghe rilasciate piĂą di recente

ends

booleano

Solo proxy in scadenza a breve

page, per_page

numero intero

Pagina di ritorno (predefinita 1) e dimensione della pagina (impostazione predefinita 50)

reveal

booleano

Torna indietro password in modo chiaro invece di ••••. L’assistente ti chiederà prima conferma — vedi Password proxy e il provider di IA

Risultati: {items: [...]} — un oggetto per proxy con id, ip, protocol, port_http, port_socks, login, password, country, country_alpha3, date_start, date_end, status, status_type, can_prolong, auto_renew, comment, order_id, order_number, base_order_number. La risposta è suddivisa in pagine (50 per pagina per impostazione predefinita) e contiene page, per_page, total, total_pages, oltre a un _note quando sono presenti più pagine. Per resident gli oggetti sono gli elenchi residenziali, non gli indirizzi IP. Per mix / mix_isp un unico pacchetto viene distribuito in diversi paesi: order_number e base_order_number accompagnati da un suffisso specifico per ogni paese (NS_…-dX_GBR, NS_…-dX_DEU) mentre order_id è condivisa — raggruppare per order_id; a _note Il risultato lo conferma. password è "••••" a meno che reveal: true. ⚠️ Dati sensibili — il risultato include un avviso che l’assistente ti ripete.

export_proxies

🢢 read-only · account:read

Esportare i proxy come elenco pronto all’uso, un proxy per riga. Mascherati per impostazione predefinita: ip:port. Con reveal: true le linee sono collegabili login:password@host:port.

Parametro

Tipo

Descrizione

type obbligatorio

tipo di proxy, incl. subresident

Tipo di prodotto

ext

string

txt (impostazione predefinita), csv, oppure un modello come %login%:%password%@%ip%:%port%. Senza reveal, txt diventa %ip%:%port%; csv (il cui layout fisso ip;port;login;password (contiene sempre la password) e un modello di denominazione %password% vengono rifiutati finché non confermi la rivelazione

proto

https | socks5

Un solo tipo di porta (non per uso residenziale)

protocol

http | socks5

Solo uso residenziale (resident, subresident): la struttura di ogni riga. Con txt una riga diventa socks5://login:password@host:port; csv mantiene le sue colonne; un modello ricava il valore da %protocol% (un modello non può contenere /, quindi utilizzare txt per scheme:// righe). Senza di essa le righe non hanno uno schema. Non è la stessa cosa di proto; non c'è https. socks5 supporta anche UDP e HTTP/3 (QUIC)

host

res.proxy-seller.com | us.res.proxy-seller.com | asia.res.proxy-seller.com

Solo uso residenziale: il gateway in ogni riga — Europa (impostazione predefinita), Stati Uniti o Asia. Solo il punto di ingresso; la posizione IP di uscita proviene dalle impostazioni dell’elenco

country

string

Codice Alpha-3 (non per uso residenziale)

ends

booleano

Solo proxy in scadenza a breve (non per uso residenziale)

listId

stringa | numero intero

ID elenco residenziale (resident e subresident); ometti l’esportazione di tutti gli elenchi

package_key

string

Chiave del sottopacchetto, con type: "subresident"

maxLine

numero intero

Numero massimo di righe, solo testo

reveal

booleano

Restituisci "connectable" login:password@host:port righe invece di ip:port. L’assistente ti chiederà prima conferma — vedi Password proxy e il provider di IA

Risultati: Con un indirizzo di residenza protocol le righe riportano lo schema: socks5://host:port per impostazione predefinita, socks5://login:password@host:port con reveal: true. Senza reveal le righe sono seguite da una nota che indica che le password sono state omesse — l’assistente lo comunica, quindi un elenco privo di password non viene mai presentato come le credenziali che avete richiesto. Richiedere csv ti sta chiedendo le password: l’assistente ti avverte che il file inserirà le tue credenziali del proxy nella conversazione e ti chiede di confermare prima di esportarlo.

get_reference

🢢 read-only · account:read

Paesi disponibili, periodi di noleggio e pacchetti per una determinata tipologia di prodotto. Informazioni necessarie prima di stabilire i prezzi o effettuare un ordine. I paesi sono indicati con i codici alfa-3 (USA), i punti sono codici abbreviati (1m). Per i dispositivi mobili vengono restituiti anche gli operatori e le opzioni di rotazione; per i clienti residenziali, le tariffe di traffico.

Parametro

Tipo

Descrizione

type obbligatorio

tipo di proxy

Tipo di prodotto

calc_order_cost

🢢 read-only · account:read

Prezzo e sconto per un nuovo ordine, senza effettuare l’ordine stesso. Utilizza gli stessi parametri di make_order.

make_order

💳 spends money · billing:write

Effettua un nuovo ordine proxy. L'importo verrĂ  addebitato sul saldo. Effettuando la richiesta due volte si creeranno due ordini.

Parametro

Tipo

Descrizione

type obbligatorio

tipo di proxy

Tipo di prodotto (utilizzare make_resident_order (per il traffico residenziale)

countryId obbligatorio

string

Da get_reference, ad es. USA

periodId obbligatorio

string

Da get_reference, ad es. 1m

quantity obbligatorio

numero intero

Numero di proxy (ipv6 (minimo 10)

paymentId obbligatorio

string

balance oppure paddle_subscription

customTargetName

string

A cosa servono i proxy, come nome abbreviato di un sito o servizio (Google, Instagram). Richiesto per ipv4, ipv6, isp. Una destinazione che l’account non ha mai utilizzato è considerata una nuova destinazione: un responsabile deve approvarla manualmente e l’ordine rimane in sospeso fino a quel momento, pertanto l’assistente preferisce una delle destinazioni già presenti nell’account (list_orders → targets)

coupon

string

Codice promozionale

generateAuth

booleano

Generare nome utente e password per i nuovi proxy

protocol

HTTPS | SOCKS5

Deroga al protocollo

mobileServiceType

shared | dedicated

Solo per dispositivi mobili, obbligatorio

operatorId

string

Solo per dispositivi mobili, obbligatorio — operatore da get_reference

rotationId

string

Solo per dispositivi mobili, obbligatorio — rotazione in minuti da get_reference

mixId

string

Solo MIX — codice del pacchetto da get_reference

uptime

booleano

Solo IPv4/ISP — Modalità ad alta disponibilità, ove disponibile

Errore tipico: l'ordine è stato pagato ma rimane in sospeso per più di un minuto. Quando il suo customTargetName è nuovo sull'account, provisioning.targetNote così dice: il CRM ha creato un nuovo obiettivo di utilizzo che un responsabile approva manualmente, e solo dopo vengono emessi i proxy — non c’è nulla di sbagliato nel pagamento o nelle azioni. Ricontrollare in seguito con check_order_status, oppure riutilizzare una traduzione esistente la prossima volta.

list_orders

🢢 read-only · account:read

I tuoi ordini, dal più recente al più vecchio — acquisti e rinnovi — con i relativi ID, stato, importo, date, tipo di proxy e destinazione d’uso, oltre alle destinazioni d’uso specifiche dell’account. Usalo per scegliere un customTargetName che l’account possiede già prima di effettuare l’ordine, per trovare il order_id valori a ipv6 / mix / mix_isp il rinnovo richiede orderIds, e per la cronologia degli ordini.

Parametro

Tipo

Descrizione

order_id

stringa | numero intero

Un ordine (order_id lo restituisce con le sue estensioni; il valore numerico di una riga id restituisce quella riga)

start_date / end_date

string

Limiti di data di creazione, yyyy-MM-dd oppure dd.MM.yyyy

status

PAYED | NOT_PAYED | RETURN

Filtro stato macchina

is_extend

booleano

true solo estensioni, false solo acquisti

auto_order

booleano

true inseriti tramite l’API o rinnovati automaticamente, false inserito manualmente

page / limit

numero intero

Impaginazione: 50 righe per pagina per impostazione predefinita; a _note indica quando sono presenti altre pagine. targets copre sempre ogni ordine corrispondente

Risultati: {metadata: {total_orders, total_pages, current_page, current_limit}, items: [{id, order_id, order_number, base_order_number, status, status_type, summ, date_insert, date_payed, payment_name, is_extend, auto_order, auth_way, auth_ip, protocol, items: [{order_part_id, type, quantity, target, target_section, time, price, name, ...}], ...}], targets: string[], _note?}. summ è una stringa relativa alla valuta ($12.50), le date sono nel formato ISO 8601; l’oggetto di utilizzo si trova su ciascuna parte dell’ordine (items[].items[].target); creare un ramo su status_type, non status.

check_order_status

🢢 read-only · account:read

Verifica se le delese relative a un ordine effettuato sono state emesse, contando il numero delle delese list_proxies vale per l’ordine — per ogni tipo, pacchetti MIX inclusi. Sebbene un ordine MIX non elenchi ancora alcun IP, gli accessi per paese in list_auth costituiscono le prove di riserva (started). Può essere chiamato ripetutamente in tutta sicurezza; restituisce uno stato e i passaggi successivi. Il cabinet etichetta un pacchetto MIX in base al suo order_part_id, che differisce da orderId; ovvero lo stesso ordine.

Parametro

Tipo

Descrizione

type obbligatorio

tipo di proxy

Tipo di prodotto

orderId obbligatorio

stringa | numero intero

orderId da make_order

expectedQuantity

numero intero

QuantitĂ  ordinata, per rilevare consegne parziali

baseOrderNumbers

string[]

Solo MIX — listBaseOrderNumbers da make_order risposta, utilizzata come soluzione alternativa per il login

Risultati: status è provisioned, partial, started (MIX: gli accessi esistono, gli IP non sono ancora elencati) oppure pending. proxies[] sono i record emessi con password mascherato — utilizzare list_proxies / export_proxies con reveal: true per le credenziali.

calc_prolong_cost

🢢 read-only · account:read

Prezzo di rinnovo per proxy specifici, senza rinnovo. Stessi parametri di make_prolong.

Risultati: items sono i proxy che verrebbero rinnovati, password mascherato.

make_prolong

💳 spends money · billing:write

Rinnova le deleghe per un altro periodo. L'addebito viene effettuato sulla fonte di pagamento selezionata. Se la richiesta viene effettuata due volte, l'addebito viene effettuato due volte.

Parametro

Tipo

Descrizione

type obbligatorio

ipv4 | ipv6 | mobile | isp | mix | mix_isp

Tipo di prodotto. Un pacchetto residenziale non viene rinnovato periodicamente — acquista traffico con make_resident_order

periodId obbligatorio

string

Da get_reference

paymentId obbligatorio

string

balance oppure un metodo da list_payments

ips

string[]

ipv4 / isp / mobile: indirizzi proxy come list_proxies li mostra

ids

(stringa | numero intero)[]

ipv4 / isp / mobile: ID proxy

orderIds

(stringa | numero intero)[]

ipv6 / mix / mix_isp: il order_id valori da list_proxies. Questi prodotti vengono venduti e rinnovati come ordini completi: ogni proxy attivo dell’ordine viene rinnovato e addebitato

coupon

string

Codice promozionale

Il selettore da applicare dipende da type: ipv4, isp e mobile prendere ids oppure ips; ipv6, mix e mix_isp prendere orderIds. Per un tipo di ordine completo è comunque possibile passare ids oppure ips — lo strumento dell’assistente li risolve secondo le istruzioni ricevute — ma l’API stessa accetta solo orderIds lì.

Errore tipico: un secondo rinnovo di un ordine che è ancora in fase di rinnovo viene rifiutato prima del pagamento (codice 57, “già in corso”) — non viene addebitato nulla; attendere e ricontrollare list_proxies piuttosto che riprovare alla cieca. «Il rinnovo non è stato applicato, l’importo è stato riaccreditato sul saldo» significa che il rinnovo è stato annullato e che l’importo è tornato sul saldo.

replace_proxy

🟡 changes account state · account:write

Richiedere la sostituzione dei proxy non funzionanti. Ogni proxy può essere sostituito una volta al giorno.

Parametro

Tipo

Descrizione

ids obbligatorio

(stringa | numero intero)[]

ID proxy

reason obbligatorio

NOT_WORK | INCORRECT_LOCATION | CANT_CHANGE_NETWORK | LOW_SPEED | CUSTOM

Motivazione

comment

string

Richiesto quando reason è CUSTOM

set_proxy_comment

🟡 changes account state · account:write

Imposta lo stesso commento su uno o piĂą proxy. Sostituisce il commento precedente; una stringa vuota lo cancella.

Parametro

Tipo

Descrizione

ids obbligatorio

(stringa | numero intero)[]

ID proxy

comment obbligatorio

string

Testo del commento

Prossimi passi

On this page