OpenAPI-contract
Genereer uit het OpenAPI-document een getypeerde client in uw taal en valideer aanvragen ertegen.
OPEN STANDAARDEN
Eén manier om een auto te beschrijven.
Open voor iedereen.
AVS, het AutoUncle Vehicle Schema, is een open JSON Schema met versiebeheer om een auto te beschrijven: wat hij is, hoe hij is gebouwd en waarmee hij is uitgerust. Gebruik het in uw eigen systemen, valideer het in zeven talen en bouw op een API die hetzelfde identiteitsmodel spreekt.
AVS · AUTOUNCLE VEHICLE SCHEMA
Alleen feiten.
Elk niveau een apart feit.
AVS kent twee soorten documenten: een typedocument beschrijft een auto zoals hij gebouwd is, zoals een BMW 320e G20 Sedan met M Sport; een voertuigdocument beschrijft één fysieke auto van dat type, met zijn VIN, kilometerstand, kleur en historie. Gelicentieerd onder Apache-2.0, zonder catalogusdata.
Feiten, geen meningen
AVS zegt wat de auto is. Wat hij waard is en waar hij te koop staat, hoort ergens anders thuis.
Onbekend blijft weg
Alleen merk en model zijn verplicht. Er wordt niets geraden, en dat iets ontbreekt, moet expliciet worden vermeld.
Elk codesysteem
Elk catalogusrecord vermeldt zijn ID's in elk gewenst schema, zoals AutoUncle, Wikidata of KBA HSN/TSN, en geen enkel schema heeft voorrang.
EU-conventies
Eenheden maken deel uit van de veldnamen, waarden volgen het EU-certificaat van overeenstemming (CoC) en WLTP, en landen, valuta en VIN's gebruiken ISO-codes.
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"]
}
}
}HET IDENTITEITSMODEL
Dezelfde structuur
die onze API gebruikt.
Merk, model, generatie en fase, dan carrosserie en aandrijving als onafhankelijke feiten, en de uitvoering, pakketten en opties bij naam. Onze API's herkennen auto's langs hetzelfde pad, van merk en model naar generatie, motorisering en uitvoering, met stabiele ID's die u in AVS kunt opslaan onder het schema autouncle.
VALIDATORS
Valideer AVS
in zeven talen.
Elk pakket bundelt het schema en een validator die elke fout teruggeeft met een JSON Pointer ernaar. Ze worden gegenereerd uit het schema, nooit met de hand geschreven, en hun versie is altijd gelijk aan die van het schema.
| Taal | Pakket | Valideren |
|---|---|---|
| Ruby | autouncle-avs | AVS.validate(doc) |
| TypeScript / JavaScript | @autouncle/avs | validate(doc) |
| Python | autouncle-avs | avs.validate(doc) |
| Go | github.com/AutoUncle/avs/packages/go | avs.Validate(b) |
| Java / JVM | com.autouncle:avs | Avs.validate(json) |
| .NET | AutoUncle.Avs | AvsSchema.Validate(json) |
| PHP | autouncle/avs | Avs::validate($doc) |
DE API
Standaarden tot diep
in de API.
Problem details
Fouten zijn probleemdocumenten volgens RFC 9457, met een stabiele code, een verwijzing naar het veld en een voorgestelde oplossing.
ISO-codes
Landen volgens ISO 3166, valuta volgens ISO 4217 en VIN's volgens ISO 3779, in aanvragen en resultaten.
Idempotent van opzet
Elke taxatie accepteert een idempotentiesleutel, zodat een herhaalde aanvraag nooit twee keer wordt gefactureerd.
MCP voor agents
Dezelfde API als tools voor AI-agents, plus een integratieskill en llms.txt voor codeerassistenten.
BOUW EROP VERDER
Beschrijf auto's één keer.
Gebruik ze overal.
Lees het schema, genereer een client uit het OpenAPI-contract en taxeer uw eerste auto met een gratis testsleutel.