Documentazione API

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

Autenticazione

L’API REST richiede un token Bearer con il permesso «csv:validate». I token vengono forniti alle integrazioni approvate; al momento non esiste un flusso pubblico self-service per ottenerli.

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
`file`	file	Il file CSV da validare (obbligatorio, max 10 MB)

Formato di risposta

{
  "success": true,
  "data": {
    "filename": "data.csv",
    "file_size": 2458,
    "processing_time": 0.12,
    "summary": {
      "quality_score": 92,
      "total_rows": 150,
      "columns": 8
    },
    "headers": ["id", "name", "email"],
    "issues": [],
    "issue_counts": {
      "errors": 0,
      "warnings": 0,
      "info": 0
    }
  }
}

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 /mcp/csv-check

Limiti di utilizzo

Le chiamate API autenticate sono limitate a 30 al minuto. Gli strumenti nel browser hanno limiti separati.