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.com

Release 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-23 per scegliere una versione. Il valore è una data. Senza header ottieni la versione più vecchia ancora supportata, oggi 2026-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 400 con il codice UNSUPPORTED_VERSION. Una versione ritirata riceve 410 con il codice VERSION_RETIRED.
  • Una versione in via di dismissione risponde con gli header Deprecation e Sunset: 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.

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

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
GET/easydogana/health

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 400 UNSUPPORTED_VERSION, a retired one with 410 VERSION_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

GET
/easydogana/health
Caricamento...

Risposta 200

{}

Esempio generato dallo schema.

Was this page helpful?