5 minuti

Quickstart

Integra l'API ANAME AI nella tua applicazione in 5 step.

1. Ottieni una API Key

Scrivi a support@anameai.com indicando la tua organizzazione e il volume stimato. Riceverai una chiave in 24h.

2. Scegli l'endpoint

19 endpoint dedicati per tipo documento italiano + 1 auto-detect + 1 nota generica. Se conosci il tipo, usa l'endpoint dedicato (skip classifier, -1-2s).

endpoint

POST /api/v1/extract/atto_vendita_it      # Rogito notarile
POST /api/v1/extract/mutuo_ipotecario_it  # Mutuo ipotecario
POST /api/v1/extract/visura_catastale_it  # Visura catastale
POST /api/v1/extract/busta_paga_it        # Busta paga
POST /api/v1/extract/auto                 # Auto-detect (classifier AI)
...e altri 18 tipi

3. Upload il documento

bash

curl -X POST https://api.anameai.com/api/v1/extract/atto_vendita_it \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@rogito.pdf"

4. Polling status

Chiama ogni 3-5 secondi fino a status: completed. Il polling non consuma quota API.

bash

curl https://api.anameai.com/api/v1/jobs/550e8400-... \
  -H "X-API-Key: YOUR_API_KEY"

5. Ricevi il JSON strutturato

Lo schema JSON dipende dal tipo documento. Ogni campo e tipizzato (string, float, array, nested).

json

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "document_type": "atto_vendita_it",
  "processing_time_seconds": 38.5,
  "entities": {
    "document_type": "atto_vendita_it",
    "country": "IT",
    "notaio_nome": "Mario Rossi",
    "data_atto": "2024-03-15",
    "prezzo_vendita": 250000.0,
    "venditori": [
      { "nome": "Luigi", "cognome": "Bianchi", "codice_fiscale": "BNCLGU..." }
    ],
    "immobili": [
      { "foglio": "12", "particella": "345", "subalterno": "1", "categoria": "A/2" }
    ]
  }
}