API AI Engine
L'AI Engine di EasyDogana classifica i prodotti nei codici doganali TARIC, individua i dazi applicabili e normalizza i dati grezzi di prodotto. Questo riferimento è generato dalla specifica OpenAPI del motore.
Invia ogni richiesta in HTTPS all'host di produzione qui sotto.
URL di base
https://ai-engine.parcelabs.comRelease AI Engine v1.4.0 (52e527e)
L'AI Engine usa OAuth 2.0 client credentials. Chiedi a ParceLabs un client ID e un secret con gli scope che ti servono, richiedi un access token all'endpoint del token, poi invialo come Authorization: Bearer <access_token> in ogni chiamata. Richiedi un nuovo token quando scade. Tieni il client secret sul tuo server: mai in un browser o in un'app mobile.
Richiedi un access token
curl -X POST "https://auth.parcelabs.com/oauth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d grant_type=client_credentials \
-d client_id="$CLIENT_ID" \
-d client_secret="$CLIENT_SECRET" \
-d scope="ai-engine:easydogana:catalogue:parse"La versione dell'API si sceglie con un header della richiesta, non con il percorso. I percorsi non hanno versione, per esempio /easydogana/classify.
-
Invia l'header opzionale
ParceLabs-Version: 2026-10-23per scegliere una versione. Il valore è una data. Senza header ottieni la versione più vecchia ancora supportata, oggi2026-10-23. Una richiesta non passa mai da sola a una versione più nuova. -
Ogni risposta riporta la versione risolta nell'header
ParceLabs-Version. -
Una versione sconosciuta riceve
400con il codiceUNSUPPORTED_VERSION. Una versione ritirata riceve410con il codiceVERSION_RETIRED. -
Una versione in via di dismissione risponde con gli header
DeprecationeSunset: usali per pianificare il passaggio. - Una versione precedente resta supportata per almeno 12 mesi dopo il rilascio di una più recente.
Ogni operazione richiede uno scope nell'access token. Chiedi solo gli scope che la tua integrazione usa.
ai-engine:easydogana:catalogue:parseParse CSV, XLSX or JSON product catalogues, with optional description translation and no storage or classification.
Usato da: Parse a catalogue file without classification or storage
ai-engine:easydogana:classify:readClassify products, refine a classification, look up HS codes and search the nomenclature by free text.
Usato da: Classify a product, Classify up to 100 products, Refine a previous classification, Look up an HS code, Search the TARIC nomenclature by free text
ai-engine:easydogana:normalize:readNormalize product payloads into TARIC-ready text bundles.
Usato da: Normalize a product payload, Normalize up to 100 product payloads
Gli errori usano i codici di stato HTTP standard. Il corpo è un oggetto ErrorDetail, tranne quando la richiesta non rispetta lo schema: in quel caso lo stato è 422 e detail contiene una lista di oggetti ValidationError.
ErrorDetail
Body of every error returned through FastAPI's `HTTPException`.
- Name
detail- Type
- string
- obbligatorio
- Description
Human-readable reason. Not a stable machine code.
HTTPValidationError
- Name
detail- Type
- array of ValidationError
- Description
ValidationError
- Name
ctx- Type
- object
- Description
- Name
input- Type
- any
- Description
- Name
loc- Type
- array of string | integer
- obbligatorio
- Description
- Name
msg- Type
- string
- obbligatorio
- Description
- Name
type- Type
- string
- obbligatorio
- Description
Module heartbeat
Module heartbeat.
A lightweight liveness probe. Deep TARIC index diagnostics live at the top-level `/health/indices` endpoint.
Nessuna autenticazione richiesta.
Parametri
- Name
ParceLabs-Version- Type
- string
- Description
API version as a date (
YYYY-MM-DD). Omit it to get the oldest supported version; it never moves to a newer one on its own. An unknown value is answered with 400UNSUPPORTED_VERSION, a retired one with 410VERSION_RETIRED. Every response echoes the resolved version in the same header.Valori ammessi:
2026-10-23. Predefinito:2026-10-23.
Risposte
200Successful Responsemap of string
Richiesta
Caricamento...
Risposta 200
{}Esempio generato dallo schema.