Guida rapida Ingest API

Carica un file e avvia un lavoro di elaborazione in tre chiamate HTTP.

21 mag 2026

L'Ingest API trasforma un file grezzo (PDF, immagine, audio, testo) in un documento ricercabile nella tua Libreria Vulgate. È un processo in due passaggi: carica il file, poi avvia un lavoro di elaborazione.

Il riferimento completo si trova in /developers/ingest/overview. Questa guida illustra il minimo necessario per caricare il tuo primo file da codice.

Passo 1 — Richiedere un URL di caricamento firmato

Vulgate usa URL di storage firmati così i caricamenti di file bypassano completamente il server API. Prima, richiedi un URL da /api/uploads:

curl -G "https://vulgate.ai/api/uploads" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "name=research-paper.pdf" \
  --data-urlencode "type=application/pdf"

Risposta:

{
  "url": "https://...signed-storage-url...",
  "method": "PUT",
  "headers": {
    "content-type": "application/pdf",
    "x-amz-meta-name": "research-paper.pdf"
  }
}

Conserva l'ID del file restituito negli header (x-amz-meta-name insieme alla parte del percorso dell'URL) — ti servirà nel passo 3. L'URL firmato è valido per un breve periodo.

Passo 2 — Caricare il file all'URL firmato

Invia il corpo del file come PUT all'URL firmato con gli header del passo 1. Non includere l'header di autenticazione Vulgate qui — la firma gestisce l'autenticazione:

curl -X PUT "<signed-url-from-step-1>" \
  -H "Content-Type: application/pdf" \
  -H "X-Amz-Meta-Name: research-paper.pdf" \
  --data-binary @research-paper.pdf

Il servizio di storage risponde con HTTP 200 e nessun corpo quando ha successo.

Passo 3 — Avviare un lavoro di elaborazione

Di' a Vulgate di iniziare a elaborare il file caricato facendo una POST a /api/jobs con l'ID file del passo 1:

curl -X POST "https://vulgate.ai/api/jobs" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [{ "id": "<file-id-from-step-1>" }]
  }'

Il lavoro viene eseguito in background. Una volta completato, il documento è ricercabile — chiama la Search API o la Chat API per interagire con esso.

Caricamenti multipart per file grandi

Il flusso a file singolo sopra funziona bene per file tipici. Per file molto grandi, usa gli endpoint multipart (POST /api/uploads). Vedi Caricare file per il riferimento completo.

Correlati

Cerca nell'assistenza