NOVITÀ! |Una sola chiamata API, dati puliti in risposta. Nessuno scraper necessario.Ottieni 10.000 token gratuiti →

Piattaforma per sviluppatori

API e MCP FineProxy

Automatizzate le operazioni proxy dal vostro codice o collegate un agente AI. Scoprite cosa è supportato, quali misure di sicurezza si applicano e come eseguire l’audit di un’integrazione esistente prima di cambiare provider.

REST API49 operazioni OpenAPI
Server MCP49 strumenti agente
AccessoChiavi API con ambiti

Un’unica piattaforma, due modi per automatizzare

API e MCP utilizzano le stesse chiavi FineProxy con ambiti ed espongono gli stessi workflow cliente. Scegliete in base a chi li utilizzerà: la vostra applicazione o un agente AI.

REST · OpenAPI 3.1

Integrate FineProxy nella vostra applicazione

Utilizzate endpoint HTTP documentati da un backend, uno script, un processo CI, un pannello interno o un workflow no-code. La specifica client corrente è disponibile nella dashboard.

Ideale quando il vostro codice deve:
  • Eseguire workflow deterministici senza un modello AI
  • Convalidare la struttura di richieste e risposte rispetto a OpenAPI
  • Gestire autonomamente nuovi tentativi, code, log e deployment
Apri la documentazione API

JSON-RPC 2.0 · Streamable HTTP

Fornite a un agente AI un accesso controllato

Collegate Cursor, Claude, VS Code, Cline, n8n o un altro client MCP al server FineProxy. L’agente riceve gli strumenti consentiti dagli ambiti della chiave API.

Ideale quando volete che un agente:
  • Esamini inventario, servizi, utilizzo e cronologia dell’assistenza
  • Prepari preventivi ed esegua operazioni approvate sui servizi
  • Diagnostichi gli errori e spieghi le modifiche consigliate
Apri la configurazione MCP nella dashboard

Eseguite l’audit di un’integrazione esistente prima della migrazione

Scaricate un file Markdown, allegatelo a un agente di programmazione insieme al vostro repository ed eseguite il prompt di audit predisposto. La prima fase è di sola lettura: individua compatibilità, adattatori, ostacoli e il codice esatto da modificare.

Prompt di audit della migrazione in sola lettura
Leggi il FineProxy Agent Pack allegato ed esamina questo repository.

Non modificare il codice durante la prima fase.

Individua ogni punto in cui il provider proxy corrente viene configurato o richiamato. Confronta ciascun workflow con le funzionalità FineProxy documentate. Riporta:
1. Workflow pienamente compatibili.
2. Workflow che richiedono un adattatore o una trasformazione dei dati.
3. Comportamenti non supportati o non chiari.
4. Autorizzazioni API FineProxy necessarie.
5. File e percorsi del codice esatti da modificare.
6. Modifiche all’autenticazione e all’archiviazione dei secret.
7. Un piano di migrazione per fasi con rollback.
8. Test di integrazione necessari prima del passaggio definitivo.

Non inventare endpoint. Segnala come domanda tutto ciò che non è confermato dall’Agent Pack o dalla specifica OpenAPI corrente.

L’audit deve verificare

  1. 01Dove viene inizializzato e richiamato il provider corrente
  2. 02Differenze nell’autenticazione e nell’archiviazione dei secret
  3. 03Workflow di acquisto, rinnovo, annullamento e aggiornamento IP dei servizi
  4. 04Formati degli elenchi proxy, protocolli, porte e modalità di autorizzazione
  5. 05Selezione dei Paesi, allowlist e limiti di connessione
  6. 06Paginazione, nuovi tentativi, idempotenza, errori e gestione dei limiti di frequenza
  7. 07Dipendenze relative a fatturazione, analisi dell’utilizzo, assistenza e webhook
  8. 08Un piano di migrazione e test file per file senza modificare il codice

Per l’implementazione a livello di endpoint, fornite all’agente anche il file OpenAPI corrente scaricato dalla dashboard. Il FineProxy Agent Pack non contiene intenzionalmente credenziali o dati privati dell’account.

Cosa potete automatizzare

Il livello pubblico descrive workflow completi anziché riprodurre ogni endpoint. Utilizzate la specifica OpenAPI aggiornata per implementare le singole richieste.

01

Acquisto e provisioning

Consultate l’inventario disponibile, calcolate un mix esatto di Paesi ed effettuate un ordine dal portafoglio della dashboard.

  • Elencare i Paesi disponibili e l’inventario IP corrente
  • Calcolare il preventivo di un pacchetto multi-Paese senza impegnare fondi
  • Acquistare con un limite di prezzo e una chiave di idempotenza
02

Gestione dei servizi

Gestite i servizi attivi senza attendere un ticket di assistenza quando il piano supporta l’azione richiesta.

  • Rinnovare, sospendere, ripristinare o annullare i servizi
  • Sostituire o aggiungere IP e aggiornare le credenziali
  • Gestire rinnovo automatico, allowlist e componenti aggiuntivi di connessione
03

Analisi e diagnostica

Utilizzate la telemetria dell’account e dei servizi per analizzare carico, affidabilità e comportamento delle destinazioni.

  • Consultare panoramiche e serie temporali sull’utilizzo
  • Esaminare le principali destinazioni e categorie di errore
  • Ricevere diagnosi e raccomandazioni operative
04

Fatturazione e assistenza

Collegate le operazioni proxy ai relativi workflow finanziari e di assistenza.

  • Consultare le fatture e scaricarle in PDF
  • Avviare un deposito nel portafoglio e verificarne lo stato
  • Creare, leggere, rispondere e chiudere ticket di assistenza
05

Accesso proxy

Recuperate le impostazioni necessarie alle applicazioni per connettersi tramite i proxy acquistati.

  • Leggere la configurazione di connessione dei proxy a rotazione
  • Modificare login e password del servizio
  • Gestire i limiti di connessione per IP nell’allowlist
06

Eventi e account

Mantenete sincronizzati i sistemi esterni ed esaminate le informazioni dell’account rilevanti per la sicurezza.

  • Configurare i webhook e la gestione delle consegne
  • Leggere dati del profilo, IP del chiamante e cronologia degli accessi
  • Gestire chiavi API con autorizzazioni selezionate in modo granulare

Cosa non farà la piattaforma

L’automazione FineProxy è intenzionalmente soggetta a limiti. L’accesso è determinato dalla chiave, dal piano di servizio, dall’inventario disponibile e da controlli di sicurezza espliciti.

Nessun accesso al di fuori degli ambiti concessi

Uno strumento o un endpoint non può leggere o modificare una risorsa se la chiave API non include l’autorizzazione richiesta.

Nessuna spesa senza wallet:spend

Acquisti, rinnovi e aggiornamenti IP a pagamento restano indisponibili in assenza dell’ambito finanziario.

Nessuna azione distruttiva senza conferma

Le operazioni irreversibili richiedono un flag di conferma esplicito. Non possono verificarsi come effetto collaterale di una richiesta di lettura.

Nessun accesso al codice sorgente tramite MCP

FineProxy MCP opera sull’account cliente. Per eseguire l’audit di uno script, il vostro agente di programmazione deve ricevere separatamente l’accesso allo script o al repository.

Nessuna garanzia per l’inventario non disponibile

La disponibilità e le quantità per Paese vengono verificate rispetto all’inventario corrente. L’automazione non può ordinare risorse non disponibili.

Nessuna API partner per i partner non attivi

La specifica partner e gli endpoint di reportistica vengono mostrati soltanto quando l’account ha lo stato di partner attivo.

Collegate un agente in pochi minuti

Create una chiave API dedicata nella dashboard, selezionate soltanto gli ambiti necessari all’agente e inserite la configurazione MCP nel vostro client. Conservate la chiave reale in un secret o in una variabile d’ambiente.

mcp.json
{
  "mcpServers": {
    "fineproxy": {
      "url": "https://fineproxy.org/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}

OpenAPI 3.1

Utilizzate la specifica aggiornata per l’implementazione

La dashboard mostra la specifica client OpenAPI 3.1 curata, esempi di richieste, schemi di risposta e snippet client generati. I partner attivi ricevono inoltre una specifica partner separata.

Visualizza il riferimento API interattivo

Scegliete il set minimo di autorizzazioni utile

Gli accessi in lettura e scrittura sono separati. Iniziate con ambiti di sola lettura per l’analisi preliminare e gli audit di migrazione, quindi aggiungete l’accesso in scrittura o finanziario soltanto al workflow che lo richiede.

customer:read

Leggere il profilo cliente e le informazioni dell’account.

customer:write

Aggiornare le informazioni del cliente.

wallet:read

Visualizzare il saldo e i dati del portafoglio.

wallet:deposit

Creare e monitorare depositi nel portafoglio.

wallet:spend

Consentire all’automazione di spendere i fondi del portafoglio.

services:read

Visualizzare servizi, impostazioni proxy e stato dei servizi.

services:write

Creare o modificare servizi e componenti aggiuntivi.

tickets:read

Leggere i ticket di assistenza e i relativi messaggi.

tickets:write

Creare, aggiornare, rispondere o chiudere ticket.

catalog:read

Leggere prodotti, opzioni, Paesi e inventario corrente.

usage:read

Leggere i dati sull’utilizzo dei servizi e le analisi diagnostiche.

webhooks

Creare e gestire sottoscrizioni webhook.

Impostazioni di sicurezza predefinite da mantenere

  • Create una chiave API separata per ogni applicazione o agente, in modo da poterla revocare in modo indipendente.
  • Iniziate un audit con ambiti di sola lettura. Aggiungete services:write o wallet:spend soltanto dopo aver esaminato il piano proposto.
  • Conservate le chiavi in variabili d’ambiente o in un gestore di secret, mai nel codice sorgente, nei prompt, negli screenshot o nella configurazione MCP sottoposta a commit.
  • Utilizzate il totale previsto indicato nel preventivo per gli acquisti. Una variazione di prezzo fa rifiutare l’operazione anziché addebitare silenziosamente un importo maggiore.
  • Riutilizzate una chiave di idempotenza quando ripetete una richiesta finanziaria scaduta, affinché la stessa operazione non possa essere addebitata due volte.
  • Verificate le firme dei webhook e la cronologia delle consegne prima di integrare gli eventi in un workflow critico.

Iniziate dalla visibilità, poi concedete il controllo

Un audit di sola lettura determina se la migrazione è fattibile senza esporre accessi finanziari o in scrittura. Una volta approvato il piano, create una chiave di produzione con ambiti limitati e implementate in base alla specifica OpenAPI aggiornata.