Vai al contenuto
STANDARD APERTI

Un solo modo per descrivere un'auto.
Aperto a tutti.

AVS, l'AutoUncle Vehicle Schema, è un JSON Schema aperto e versionato per descrivere un'auto: cos'è, come è costruita e come è equipaggiata. Usatelo nei vostri sistemi, validatelo in sette linguaggi e sviluppate su un'API che parla lo stesso modello di identità.

AVS · AUTOUNCLE VEHICLE SCHEMA

Solo fatti.
Ogni livello un fatto a sé.

AVS ha due tipi di documento: un documento di tipo descrive un'auto così come è costruita, per esempio una BMW 320e G20 Sedan con M Sport; un documento di veicolo descrive una singola auto fisica di quel tipo, con il suo VIN, contachilometri, colore e storia. Con licenza Apache-2.0, senza dati di catalogo al suo interno.

Fatti, non opinioni

AVS dice cos'è l'auto. Quanto vale e dove è in vendita appartengono ad altro.

Ciò che è ignoto resta fuori

Sono obbligatori solo marca e modello. Nulla viene indovinato, e l'assenza deve essere dichiarata.

Qualsiasi sistema di codici

Ogni record di catalogo elenca i suoi ID in qualsiasi schema, come AutoUncle, Wikidata o KBA HSN/TSN, e nessuno è privilegiato.

Convenzioni UE

Le unità fanno parte dei nomi dei campi, i valori seguono il Certificato di conformità UE e la WLTP, e paesi, valute e VIN usano codici ISO.

Leggete lo schema ↗
examples/type-bmw-320e-g20-m-sport.json
{
  "avs": { "version": "0.3", "kind": "type" },
  "identity": {
    "brand": {
      "name": "BMW",
      "ids": [
        { "scheme": "autouncle", "value": "b-example0001" },
        { "scheme": "wikidata", "value": "Q26678" }
      ]
    },
    "model": {
      "name": "3 Series",
      "localNames": { "DK": "3-serie" }
    },
    "generation": { "name": "3 Series (G20/G21)", "code": "G20" },
    "drivetrain": {
      "name": "320e (204 Hp) Plug-in Hybrid Steptronic"
    }
  },
  "specification": {
    "powertrain": {
      "energy": ["petrol", "electricity"],
      "electrification": "phev",
      "powerKw": 150, "torqueNm": 300
    }
  },
  "equipment": {
    "trim": {
      "name": "M Sport",
      "variations": ["M Sportpakke", "M-Sport"]
    }
  }
}
Un estratto dell'esempio BMW 320e nel repository AVS.
IL MODELLO DI IDENTITÀ

La stessa struttura
su cui si basa la nostra API.

Marca, modello, generazione e fase, poi carrozzeria e motorizzazione come fatti indipendenti, e allestimento, pacchetti e optional per nome. Le nostre API identificano le auto lungo lo stesso percorso, da marca e modello a generazione, motorizzazione e allestimento, con ID stabili che potete salvare in AVS nello schema autouncle.

VALIDATORI

Validate AVS
in sette linguaggi.

Ogni pacchetto include lo schema e un validatore che restituisce ogni errore con un JSON Pointer che lo localizza. Sono generati dallo schema, mai scritti a mano, e la loro versione coincide sempre con quella dello schema.

LinguaggioPacchettoValidazione
Rubyautouncle-avsAVS.validate(doc)
TypeScript / JavaScript@autouncle/avsvalidate(doc)
Pythonautouncle-avsavs.validate(doc)
Gogithub.com/AutoUncle/avs/packages/goavs.Validate(b)
Java / JVMcom.autouncle:avsAvs.validate(json)
.NETAutoUncle.AvsAvsSchema.Validate(json)
PHPautouncle/avsAvs::validate($doc)
L'API

Standard in ogni livello
dell'API.

Contratto OpenAPI

Generate un client tipizzato nel vostro linguaggio dal documento OpenAPI, e validate le richieste rispetto a esso.

Problem details

Gli errori sono documenti problem RFC 9457 con un codice stabile, un riferimento al campo e una correzione suggerita.

Codici ISO

Paesi ISO 3166, valute ISO 4217 e VIN ISO 3779, nelle richieste e nei risultati.

Idempotente per design

Ogni valutazione accetta una chiave di idempotenza, così una richiesta ripetuta non viene mai addebitata due volte.

MCP per agenti

La stessa API come strumenti per agenti AI, più una skill di integrazione e llms.txt per gli assistenti di programmazione.

Riferimento API →

SVILUPPATE SU QUESTA BASE

Descrivete le auto una volta.
Usatele ovunque.

Leggete lo schema, generate un client dal contratto OpenAPI e valutate la vostra prima auto con una chiave di test gratuita.

Ottenete la vostra chiave API →