Documentazione API

Integra la validazione CSV nelle tue applicazioni con la nostra API REST o il nostro server MCP.

Autenticazione

Le richieste API richiedono un token Bearer. Includi il tuo token nell'header Authorization di ogni richiesta.

Authorization: Bearer YOUR_API_TOKEN

Validare un file CSV

Carica un file CSV per la validazione. Il file viene elaborato e i risultati vengono restituiti immediatamente.

POST /api/v1/csv-validator/process

Parametri della richiesta:

Parametro	Tipo	Descrizione
`csv_file`	file	Il file CSV da validare (obbligatorio, max 10 MB)

Formato di risposta

{
  "success": true,
  "file_name": "data.csv",
  "file_size": "2.4 KB",
  "share_token": "abc123...",
  "share_url": "https://csv.example.com/csv-validator/abc123",
  "results": {
    "encoding": "UTF-8",
    "delimiter": ",",
    "has_header": true,
    "total_rows": 150,
    "total_columns": 8,
    "quality_score": 92,
    "issues": [],
    "headers": ["id", "name", "email", ...],
    "column_types": {"id": "integer", "name": "string", ...}
  }
}

Ottenere un risultato di validazione

GET /api/v1/csv-validator/{token}

Recupera un risultato di validazione precedentemente generato tramite il suo token di condivisione.

Server MCP (Model Context Protocol)

Il nostro server MCP permette agli agenti IA e agli LLM di scoprire e utilizzare lo strumento di validazione CSV in modo programmatico. Invia richieste di discovery e invocazione degli strumenti agli endpoint MCP.

POST /api/mcp/tools/list
POST /api/mcp/tools/call

Limiti di utilizzo

Gli utenti anonimi gratuiti ottengono 100 validazioni al giorno. I titolari di token API ottengono limiti più alti in base al loro piano. Gli header dei limiti di utilizzo sono inclusi in ogni risposta.