Proxy e ordini
Updated:
Autorizzazioni: account:read, account:write, fatturazione:scrivi
In questo gruppo
Strumento | Cosa fa | |
|---|---|---|
🢢 | I tuoi proxy attivi di un tipo: IP, porte HTTP/SOCKS, credenziali, paese, data di scadenza, stato di rinnovo automatico e commento. | |
🢢 | Esportare i proxy sotto forma di elenco pronto all’uso, un proxy per riga. | |
🢢 | Paesi disponibili, periodi di noleggio e pacchetti per una determinata tipologia di prodotto. | |
🢢 | Prezzo e sconto per un nuovo ordine, senza effettuare l’ordine stesso. | |
đź’ł | Effettua un nuovo ordine proxy. | |
🢢 | I tuoi ordini, in ordine cronologico dal più recente al più vecchio, e i destinatari già presenti sull’account. | |
🢢 | Verifica se i proxy relativi a un ordine effettuato sono stati emessi. | |
🢢 | Prezzo di rinnovo per proxy specifici, senza rinnovo. | |
đź’ł | Rinnovare le deleghe per un altro periodo. | |
🟡 | Richiedere la sostituzione dei proxy non funzionanti. | |
🟡 | 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 |
|---|---|---|
| tipo di proxy | Tipo di prodotto. |
| stringa | numero intero | Un solo ordine |
| string | Codice Alpha-3, ad es. |
| booleano | Solo le deleghe rilasciate piĂą di recente |
| booleano | Solo proxy in scadenza a breve |
| numero intero | Pagina di ritorno (predefinita |
| booleano | Torna indietro |
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 |
|---|---|---|
| tipo di proxy, incl. | Tipo di prodotto |
| string |
|
|
| Un solo tipo di porta (non per uso residenziale) |
|
| Solo uso residenziale ( |
|
| 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 |
| string | Codice Alpha-3 (non per uso residenziale) |
| booleano | Solo proxy in scadenza a breve (non per uso residenziale) |
| stringa | numero intero | ID elenco residenziale ( |
| string | Chiave del sottopacchetto, con |
| numero intero | Numero massimo di righe, solo testo |
| booleano | Restituisci "connectable" |
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 |
|---|---|---|
| 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 |
|---|---|---|
| tipo di proxy | Tipo di prodotto (utilizzare make_resident_order (per il traffico residenziale) |
| string | Da get_reference, ad es. |
| string | Da get_reference, ad es. |
| numero intero | Numero di proxy ( |
| string |
|
| string | A cosa servono i proxy, come nome abbreviato di un sito o servizio (Google, Instagram). Richiesto per |
| string | Codice promozionale |
| booleano | Generare nome utente e password per i nuovi proxy |
|
| Deroga al protocollo |
|
| Solo per dispositivi mobili, obbligatorio |
| string | Solo per dispositivi mobili, obbligatorio — operatore da get_reference |
| string | Solo per dispositivi mobili, obbligatorio — rotazione in minuti da get_reference |
| string | Solo MIX — codice del pacchetto da get_reference |
| 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 |
|---|---|---|
| stringa | numero intero | Un ordine ( |
| string | Limiti di data di creazione, |
|
| Filtro stato macchina |
| booleano |
|
| booleano |
|
| numero intero | Impaginazione: 50 righe per pagina per impostazione predefinita; a |
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 |
|---|---|---|
| tipo di proxy | Tipo di prodotto |
| stringa | numero intero |
|
| numero intero | QuantitĂ ordinata, per rilevare consegne parziali |
| string[] | Solo MIX — |
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 |
|---|---|---|
|
| Tipo di prodotto. Un pacchetto residenziale non viene rinnovato periodicamente — acquista traffico con make_resident_order |
| string | |
| string |
|
| string[] |
|
| (stringa | numero intero)[] |
|
| (stringa | numero intero)[] |
|
| 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 |
|---|---|---|
| (stringa | numero intero)[] | ID proxy |
|
| Motivazione |
| string | Richiesto quando |
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 |
|---|---|---|
| (stringa | numero intero)[] | ID proxy |
| string | Testo del commento |